Руководство по черновикам Draft Seedance 2.5

Создайте черновик Draft

Передайте промпт или референсные материалы в API создания платформы с draft: true и resolution: "480p". Сохраните возвращённый task_id (эквивалент id) как PLATFORM_DRAFT_TASK_ID для проверки черновика.

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": "Маленький белый кролик летит на бумажном самолётике сквозь облака, камера плавно движется вперёд"}
    ],
    "draft": true,
    "resolution": "480p",
    "duration": 5,
    "ratio": "16:9"
  }'

Получите и проверьте черновик

Запросите задачу по ID платформы с raw=true, чтобы прочитать нативные данные. Если status равен queued/running, подождите и повторите запрос; после успеха откройте content.video_url для просмотра и сохраните id нативного ответа как DRAFT_TASK_ID.

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

Второй этап использует нативный ID черновика DRAFT_TASK_ID; не подменяйте его ID для запросов платформы. При ошибке, отмене или истечении срока остановите опрос и прочитайте ошибку. Продолжать можно только для черновика со статусом succeeded.

Создайте итоговое видео из черновика

Убедившись, что черновик подходит, используйте тот же MODEL_ID и укажите нативный ID через content.draft_task.id. Разрешение должно быть 1080p; не передавайте повторно промпт, материалы, длительность и другие автоматически наследуемые параметры.

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

Сохраните новый ID задачи платформы как PLATFORM_FINAL_TASK_ID. Он и ID черновика относятся к двум разным задачам.

Получите и сохраните итоговое видео

Запросите новую задачу; после успеха скачайте итоговое видео из content.video_url нативного ответа. draft равен false, а draft_task_id ссылается на использованный черновик.

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

Если используется стандартная оболочка платформы без raw=true, читайте data.status и URL результата по справочнику запросов в формате платформы; не применяйте напрямую пути полей нативного ответа.