Chuyển đến nội dung chính
POST
/
api
/
v3
/
contents
/
generations
/
tasks
curl --request POST \
  --url https://api.aiid.edu.kg/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-0-lite-i2v-250428",
  "mode": "reference_material",
  "prompt": "测试文字",
  "content": [
    {
      "type": "text",
      "text": "测试文字"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/9979f1a754b3571d5e8bdcc397eedf53.png"
      },
      "role": "reference_image",
      "name": "1"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/1979f1a754b3571d5e8bdcc397eedf53.mp4"
      },
      "role": "reference_video",
      "name": "2"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/3979f1a754b3571d5e8bdcc397eedf53.mp3"
      },
      "role": "reference_audio",
      "name": "3"
    }
  ],
  "duration": 5,
  "size": "1280x720"
}
'
{
  "id": "task_xxx",
  "created_at": "<string>",
  "items": "<string>"
}

Ủy quyền

Authorization
string
header
bắt buộc

Sử dụng xác thực Bearer Token. Định dạng: Authorization: Bearer sk-xxxxxx

Nội dung

application/json
model
enum<string>
bắt buộc

Bắt buộc. Tên mô hình. Có thể truyền mô hình bên ngoài Seedance, cũng có thể truyền gemini-omni.

Tùy chọn có sẵn:
doubao-seedance-1-0-lite-i2v-250428,
doubao-seedance-1-0-lite-t2v-250428,
doubao-seedance-1-0-pro-250528,
doubao-seedance-1-0-pro-fast-251015,
doubao-seedance-1-5-pro-251215,
doubao-seedance-2-0-260128,
doubao-seedance-2-0-fast-260128,
gemini-omni
Ví dụ:

"doubao-seedance-2-0-260128"

prompt
string
bắt buộc

Bắt buộc. Mô tả chính để tạo video, không được để trống.

Ví dụ:

"参考素材生成一段剧情短视频"

content
object[]

Tùy chọn. Mảng content của Volcano Ark, sắp xếp xen kẽ theo thứ tự giữa văn bản và các mục nội dung. Mục văn bản dùng { "type": "text", "text": "..." }; các mục hình ảnh, video, âm thanh lần lượt dùng các đối tượng image_url, video_url, audio_url và đặt url bên trong, có thể kết hợp với role (như reference_image, reference_video, reference_audio) và name để văn bản tham chiếu.

function_mode
string

Tùy chọn. Chế độ tính năng nâng cao, chẳng hạn như omni_reference dùng để tham khảo toàn diện.

mode
string

Tùy chọn. Các trường ở chế độ tương thích, như t2v, i2v, i2v_first_last, reference_images, reference_material; gemini-omni hỗ trợ t2v, r2v, edit.

image_url
string

Tùy chọn. URL của một ảnh tham chiếu duy nhất.

image_urls
string[]

Tùy chọn. Danh sách URL của nhiều ảnh tham chiếu.

input_reference
string

Tùy chọn. Tương thích với các trường nhập liệu tham chiếu.

end_image_url
string

Tùy chọn. URL hình ảnh tham chiếu cho khung hình cuối.

last_image_url
string

Tùy chọn. Alias URL của hình ảnh tham chiếu khung hình cuối.

video_urls
string[]

Tùy chọn. Danh sách URL video tham chiếu.

audio_urls
string[]

Tùy chọn. Danh sách URL âm thanh tham chiếu.

seconds

Tùy chọn. Thời lượng video, tính bằng giây; tương thích với duration.

duration

Tùy chọn. Thời lượng video, tính bằng giây; tương thích với seconds.

aspect_ratio
string

Tùy chọn. Tỷ lệ khung hình, ví dụ: 16:9.

ratio
string

Tùy chọn. Biệt danh của tỷ lệ khung hình, ví dụ: 16:9.

size
string

Tùy chọn. Trường tương thích với độ phân giải hoặc kích thước.

quality
string

Tùy chọn. Cấu hình chất lượng tạo.

resolution
string

Tùy chọn. Độ phân giải đầu ra.

fps
number

Tùy chọn. Tốc độ khung hình.

generate_audio
boolean

Tùy chọn. Có tạo âm thanh hay không.

watermark
boolean

Tùy chọn. Có thêm hình mờ (watermark) hay không.

Phản hồi

200 - application/json

Tạo nhiệm vụ thành công

id
string
bắt buộc

ID của tác vụ.

Ví dụ:

"task_xxx"

status
enum<string>

Trạng thái nhiệm vụ.

Tùy chọn có sẵn:
queued,
running,
succeeded,
failed
created_at
string

Thời gian tạo (giây Unix).

items
string