Tạo video（Seedance）

Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết Định dạng tương thích với Sora tạo video).

Được dùng để tạo tác vụ tạo video và truy vấn trạng thái cũng như kết quả thông qua ID tác vụ.

Các trường cốt lõi để tạo tác vụ:

• model: Bắt buộc, tên mô hình.
• prompt: Bắt buộc, mô tả chính để tạo video.
• content: tùy chọn, mảng content của Volcano Ark, trộn văn bản, hình ảnh, video và âm thanh.
• function_mode: Tùy chọn, thường dùng cho các chế độ nâng cao như tham chiếu toàn năng.

Các tham số đầu vào tương thích:

Các trường sau chủ yếu dùng để tương thích với client cũ và giao thức cũ. Với tích hợp mới, vui lòng ưu tiên dùng định dạng chuẩn trong “Ví dụ yêu cầu” trên trang này: văn bản và tài liệu tham chiếu sử dụng mảng content, còn cấu hình sinh sử dụng các trường cấp cao nhất duration, ratio, resolution, fps, v.v.

• mode：t2v / i2v / i2v_first_last / reference_images / reference_material
• image_url / image_urls / input_reference
• end_image_url / last_image_url
• video_urls / audio_urls
• seconds / duration
• aspect_ratio / ratio / size
• quality / resolution
• fps
• generate_audio / watermark

Chi tiết gọi API:

• Khi là mode=reference_material hoặc function_mode=omni_reference, nên truyền văn bản và tài liệu tham chiếu thông qua content.
• content mục văn bản được viết theo dạng { "type": "text", "text": "测试文字" }.
• content các mục tài nguyên hình ảnh, video, âm thanh lần lượt dùng cú pháp đối tượng image_url, video_url, audio_url, ví dụ { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }.
• role có thể dùng để xác định mục đích của tài nguyên, name có thể được tham chiếu theo tên trong prompt.
• ratio, duration, resolution, fps sẽ ảnh hưởng đến cấu hình tạo cuối cùng.

Gọi Gemini Omni:

• gemini-omni cũng có thể được gọi thông qua giao diện tác vụ Seedance này.
• mode=t2v dùng cho tạo video từ văn bản, mode=r2v dùng cho tạo bằng ảnh tham chiếu/tài nguyên tham chiếu, mode=edit dùng cho chỉnh sửa video.
• Văn bản có thể đặt trong mục text của prompt hoặc content; hình ảnh có thể đặt trong image_url / image_urls / reference_images / input_reference / content; video có thể đặt trong video_urls / content.
• Trường thời lượng có thể dùng duration hoặc seconds, hệ thống sẽ tự động khớp với các mức 4 / 6 / 8 / 10 giây.

MiniMax / Hailuo gọi:

• minimax-h3 có thể được gọi thông qua API tác vụ này, hỗ trợ tạo video từ văn bản, tham chiếu ảnh và tham chiếu âm thanh; văn bản có thể đặt trong mục văn bản prompt hoặc content, dữ liệu có thể đặt trong các trường như content, image_urls, audio_urls.
• hailuo-2.3 có thể được gọi thông qua API tác vụ này, cần ảnh khung hình đầu tiên; khuyến nghị truyền mục image_url của role=first_frame trong content.
• minimax-h3 thường dùng duration=5~15, resolution=1440p; hailuo-2.3 thường dùng duration=6 hoặc 10, resolution=768p.

Các trường cần lưu ý trong kết quả truy vấn:

• items[].status
• items[].content.video_url hoặc items[].video_url
• items[].error
• items[].progress

Error fields: error.code, error.message.

{
  "error": {
    "code": "invalid_request_error",
    "message": "requires at least one image in `images`"
  }
}