Асинхронная генерация видео Seedance 1.5 Pro

Документация API

Используйте эти конечные точки для отправки заданий Seedance 1.5 Pro и проверки их статуса. Каждый вызов расходует кредиты в зависимости от продолжительности и аудио (синхронизированные диалоги, звуковые эффекты, музыка).

Аутентификация

Все запросы должны включать ваш ключ API внутри Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Отсутствующие или недействительные ключи возвращают 401 Unauthorized.

POST

https://seedance1-5pro.com/api/generate

Создание задачи генерации

Отправляет новое задание Seedance 1.5 Pro. Вызов немедленно возвращает task_id, в то время как рендеринг завершается асинхронно.

Параметр	Тип	Обязательный	Описание
prompt	string (max 1000 chars)	Да	Описание основной сцены (текст или рабочий процесс с изображением).
aspect_ratio	string	Да	Поддерживается: 16:9, 9:16, 1:1. Игнорируется, если присутствует image_urls.
duration	string	Да	Длительность рендеринга в секундах ("5" или "10").
sound	boolean	Нет	Включить аудио в клип (синхронизированные диалоги, звуковые эффекты, музыка).
image_urls	string[]	Нет	Необязательные URL-адреса ссылочных изображений (обязательно для преобразования изображения в видео).

Потребление кредитов

Кредиты списываются при создании задачи. Сбойные задания автоматически возвращаются (происходит возврат средств).

Предустановка	Списано кредитов
5 с, без звука	65
10 с, без звука	130
5 с, со звуком	130
10 с, со звуком	260

Пример запроса

{
  "prompt": "Drone shot over neon night market",
  "aspect_ratio": "16:9",
  "duration": "5",
  "sound": false,
  "image_urls": [
    "https://cdn.example.com/reference/frame01.png"
  ]
}

Пример ответа

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8"
  }
}

GET / POST

https://seedance1-5pro.com/api/status

Проверка статуса задачи

Используйте эту конечную точку для опроса последней записи. Когда задача все еще находится в статусе IN_PROGRESS, мы запрашиваем провайдера еще раз перед ответом.

Параметр	Тип	Обязательный	Описание
task_id	string	Да	ID, возвращенный /generate. Отправляется через запрос (?task_id=) или тело JSON.

Поле	Описание
task_id	ID, возвращенный /generate.
status	SUCCESS (УСПЕХ)
request	Очищенная копия отправленной полезной нагрузки.
response	Массив URL-адресов медиафайлов, когда status - SUCCESS.
consumed_credits	Кредиты, списанные за задачу (0 при возврате средств).
error_message	Ошибка провайдера, когда status - FAILED.
created_at	Метка времени UTC, когда задание было сохранено.

Пример запроса

GET https://seedance1-5pro.com/api/status?task_id=sd15p_b6d54c8f4b4c4e8
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://seedance1-5pro.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "sd15p_b6d54c8f4b4c4e8"
}

Пример ответа

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8",
    "status": "SUCCESS",
    "request": {
      "prompt": "Drone shot over neon night market",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": false
    },
    "response": [
      "https://static.gogloai.com/seedance15pro/clip_001.mp4"
    ],
    "consumed_credits": 65,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Обработка ошибок

401 Unauthorized - Отсутствует или недействителен ключ API.
402 Payment Required - Кредитный баланс не смог покрыть списание.
429 Too Many Requests - Уменьшите частоту опроса или скорость запросов.
500 - Временная проблема; повторите попытку с экспоненциальной задержкой.