seedance-2.5 API

Sử dụng ID mẫu chính xác seedance-2.5. Trường mô hình phải khớp chính xác với trang này.

Đầu ra mẫuseedance-2.5POST /v1/videos5.1s

Thông số: duration=5resolution=1080pratio=16:9

Câu lệnh: A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.

Yêu cầu tạo ra mẫu này

{
  "model": "seedance-2.5",
  "prompt": "A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Xác thực và điểm cuối

Sử dụng khóa API Modelflare với https://modelflare.dev/v1. Điểm vào cổng là POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Tạo nhiệm vụ

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false
  }'

Thăm dò ý kiến và tải xuống

Lưu ID nhiệm vụ. Thăm dò GET /v1/videos/{task_id} và tải xuống với GET /v1/videos/{task_id}/content. URL kết quả có thể hết hạn, vì vậy hãy chuyển tệp ngay.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Ghi chú yêu cầu

Seedance sử dụng content[] cho văn bản, khung và phương tiện tham chiếu; hợp đồng quản lý tài sản Seedance riêng biệt được ghi lại một cách độc lập.

Ghi chú

Trước tiên, tải ảnh nhân vật ảo lên thư viện tài nguyên Seedance. Chờ trạng thái Active, rồi dùng asset://<ID> trong content[]. Modelflare không cung cấp xác thực người thật.

Tham số yêu cầu

Seedance sử dụng một đường bao đa phương thức không đồng bộ. Đặt văn bản và phương tiện vào content[]; vai trò truyền thông chọn quy trình công việc đầu tiên/cuối cùng hoặc tham chiếu.

Cánh đồng	Bắt buộc	Ghi chú
model	Có	seedance-2.5
content[]	Có	text, image_url, video_url và audio_url; sử dụng role để xác định mục đích truyền thông
resolution	Không	480p / 720p / 1080p
ratio	Không	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	Không	-1 để định giờ tự động hoặc 4–30 giây
generate_audio	Không	Tạo hội thoại, hiệu ứng và âm thanh nền được đồng bộ hóa
tools	Không	Chỉ sử dụng web_search khi trang mẫu chính thức hỗ trợ nó
watermark	Không	Có nên thêm hình mờ hay không
omni_reference_task_type	Không	auto / reference / edit / extend; chỉnh sửa và mở rộng áp đặt các quy tắc tỷ lệ/thời lượng chặt chẽ hơn
output_format	Không	mp4 / mov
return_last_frame	Không	Trả về khung hình cuối cùng dưới dạng hình ảnh

Giới hạn đầu vào và đầu ra

Model này hỗ trợ 480p, 720p và 1080p. Sử dụng -1 để định giờ tự động hoặc chọn 4–30 giây. Một yêu cầu có thể kết hợp tối đa 30 hình ảnh, 10 video và 10 clip âm thanh. Việc tạo tham chiếu thông thường chấp nhận tỷ lệ rõ ràng hoặc adaptive; quy trình chỉnh sửa, mở rộng và khung hình đầu tiên/cuối cùng yêu cầu ratio: "adaptive" và chỉnh sửa yêu cầu duration: -1. Ảnh nhân vật ảo phải được tải lên thư viện tài nguyên trước; Modelflare không cung cấp xác thực người thật.

Ví dụ về quy trình làm việc được ghi lại

Seedance 2.5 phân loại các quy trình công việc tham chiếu, chỉnh sửa, mở rộng và hướng dẫn khung từ các vai trò phương tiện và loại tác vụ. Các ví dụ giữ hợp đồng chính thức trong khi sử dụng ID mô hình và điểm cuối của Modelflare.

Tham chiếu đa phương thức

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "reference",
    "content": [
      {"type":"text","text":"@image1 performs the movement from @video1, paced to @audio1"},
      {"type":"image_url","image_url":{"url":"https://example.com/character.jpg"},"role":"reference_image"},
      {"type":"video_url","video_url":{"url":"https://example.com/motion.mp4"},"role":"reference_video"},
      {"type":"audio_url","audio_url":{"url":"https://example.com/music.mp3"},"role":"reference_audio"}
    ],
    "ratio": "16:9", "duration": 15, "output_format": "mp4"
  }'

Chỉnh sửa video

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"Remove the background pedestrians but preserve the main subject"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "ratio": "adaptive", "duration": -1, "output_format": "mov"
  }'

Tiện ích mở rộng video

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "extend",
    "content": [{"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}],
    "ratio": "adaptive", "duration": 11, "output_format": "mov"
  }'

Khung hình đầu tiên và cuối cùng

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "content": [
      {"type":"text","text":"The subject smiles while the camera makes a smooth orbit"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "ratio": "adaptive", "duration": -1, "return_last_frame": true
  }'

Lỗi và tác vụ không thành công

Tham số mô hình không hợp lệ trả về 4xx cùng với ID yêu cầu. Tác vụ không đồng bộ cũng có thể bị lỗi sau khi quá trình tạo thành công; sử dụng error_code và error_message từ phản hồi thăm dò làm lý do nhiệm vụ cuối cùng. Đừng thử lại cùng một yêu cầu với hình dạng JSON khác.

Phạm vi được hỗ trợ

Trang này bao gồm các cuộc gọi chỉnh sửa và tạo mô hình Modelflare. Tính năng làm giàu bản đồ hoặc tìm kiếm, quản lý giọng nói và quản lý thư viện thành phần là các API tài nguyên nằm ngoài bề mặt lệnh gọi mô hình công khai này và không phải là các trường yêu cầu bắt buộc.

Định giá và thanh toán

Mô hình này sử dụng thanh toán dựa trên mã thông báo. Xem trang định giá mẫu để biết giá khách hàng hiện tại, giá niêm yết tham khảo và thông số kỹ thuật đầy đủ.

Ghi chú

Trang này ghi lại giao diện công cộng của Modelflare; các trường và giới hạn hiển thị ở đây là hợp đồng hiện tại.

Các biến thể

ID mẫu	Sự khác biệt
seedance-2.5	Mô hình được ghi lại trên trang này.