Hướng dẫn tạo video nháp Draft với Seedance 2.5

Tạo bản nháp Draft

Gửi lời nhắc hoặc tư liệu tham chiếu qua API tạo của nền tảng, đặt draft: true và resolution: "480p". Lưu task_id được trả về (cùng ý nghĩa với id) thành PLATFORM_DRAFT_TASK_ID để truy vấn bản nháp.

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "content": [
      {"type": "text", "text": "Một chú thỏ trắng nhỏ bay trên máy bay giấy xuyên qua những đám mây, máy quay tiến lên mượt mà"}
    ],
    "draft": true,
    "resolution": "480p",
    "duration": 5,
    "ratio": "16:9"
  }'

Truy vấn và kiểm tra bản nháp

Truy vấn bằng ID tác vụ nền tảng và dùng raw=true để đọc tác vụ gốc. Khi status là queued/running, đợi rồi truy vấn lại; khi thành công, mở content.video_url để xem trước và lưu id của phản hồi gốc thành DRAFT_TASK_ID.

curl 'https://api.agtcloud.cn/v1/video/generations/PLATFORM_DRAFT_TASK_ID?raw=true' \
  -H 'Authorization: Bearer your-api-key'

Giai đoạn thứ hai dùng ID bản nháp gốc DRAFT_TASK_ID; không nhầm ID dùng để truy vấn nền tảng với ID bản nháp gốc. Dừng thăm dò và đọc lỗi khi tác vụ thất bại, bị hủy hoặc hết hạn. Chỉ bản nháp có trạng thái succeeded mới được tiếp tục.

Tạo video hoàn chỉnh từ bản nháp

Sau khi xác nhận bản nháp đạt yêu cầu, dùng cùng MODEL_ID và tham chiếu ID bản nháp gốc qua content.draft_task.id. Độ phân giải phải là 1080p; không gửi lại lời nhắc, tư liệu, thời lượng hoặc các tham số được tự động kế thừa.

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "DRAFT_TASK_ID"}}
    ],
    "resolution": "1080p"
  }'

Lưu ID tác vụ nền tảng mới thành PLATFORM_FINAL_TASK_ID. ID này và ID bản nháp xác định hai tác vụ khác nhau.

Truy vấn và lưu video hoàn chỉnh

Truy vấn bằng ID tác vụ mới; khi thành công, tải video hoàn chỉnh từ content.video_url trong phản hồi gốc. draft là false, còn draft_task_id liên kết với bản nháp đã dùng.

curl 'https://api.agtcloud.cn/v1/video/generations/PLATFORM_FINAL_TASK_ID?raw=true' \
  -H 'Authorization: Bearer your-api-key'

Nếu dùng lớp bao phản hồi mặc định của nền tảng mà không truyền raw=true, đọc data.status và URL kết quả theo API truy vấn định dạng nền tảng; không dùng trực tiếp đường dẫn trường của phản hồi gốc.