Truy vấn tác vụ（Seedance）

curl --request GET \
  --url https://api.aiid.edu.kg/api/v3/contents/generations/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "<string>",
  "model": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "created_at": 123,
  "updated_at": 123,
  "content": {
    "video_url": "<string>",
    "last_frame_url": "<string>"
  },
  "usage": {
    "completion_tokens": 123,
    "total_tokens": 123
  },
  "items": "<string>"
}

Tạo video Seedance

Truy vấn tác vụ（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:

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.

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`"
}
}

GET

api

contents

generations

tasks

{task_id}

Truy vấn tác vụ（Seedance）

curl --request GET \
  --url https://api.aiid.edu.kg/api/v3/contents/generations/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "<string>",
  "model": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "created_at": 123,
  "updated_at": 123,
  "content": {
    "video_url": "<string>",
    "last_frame_url": "<string>"
  },
  "usage": {
    "completion_tokens": 123,
    "total_tokens": 123
  },
  "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

Tham số đường dẫn

task_id

string

bắt buộc

?? ID

Phản hồi

200 - application/json

Truy vấn thành công

string

ID của tác vụ.

model

string

status

enum<string>

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

Tùy chọn có sẵn:

queued,

running,

succeeded,

failed

error

object

Hide child attributes

error.code

string

error.message

string

created_at

integer

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

updated_at

integer

content

object

Hide child attributes

content.video_url

string

content.last_frame_url

string

usage

object

Hide child attributes

usage.completion_tokens

integer

usage.total_tokens

integer

items

string

Tạo video（Seedance）Tạo video từ hình ảnh (Vidu)