Seedance 2.5 · Token · API

Люди и референсы

API: загрузите файлы в публичное HTTPS-хранилище и передайте image_url, video_url или audio_url в content. Ссылки должны оставаться доступными во время задачи. NezhaGate импортирует материалы в библиотеку и ждёт статуса Active для всех, включая референсы реальных людей. Загрузка файла ещё не означает готовность. Отдельный вызов API библиотеки не нужен.

Загруженные файлы можно выбирать и удалять. Регистрация и проверка начнутся после Run, подтверждения и резервирования средств.

• До 30 изображений, 10 видео и 10 аудио, всего 50. Суммарно до 30с видео и до 30с аудио. Веб-загрузка: 16 МБ/изображение, 50 МБ/видео, 15 МБ/аудио. JSON API принимает HTTPS URL, не локальные пути и не байты файлов. Оригиналы менее 30 МБ; стороны 301–5999 пикселей, соотношение 0.4–2.5. Материалы с лицами требуют подготовки. MP4 для обычного использования; MOV может требовать скачивания и совместимого плеера.
• data[0].source_url — Исходная ссылка возвращается видеосервисом и может истечь. Сохраните видео заранее или скачайте размещённый у нас оригинал.

curl https://nezhagate.com/v1/videos/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "seedance-2.5-token",
  "content": [
    {
      "type": "text",
      "text": "The character from @Image1 walks by the sea."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference.jpg"
      }
    }
  ],
  "duration": 5,
  "resolution": "720p"
}'

Опрос статуса задачи

Опрашивайте GET /v1/videos/jobs/{id} каждые 3–5 секунд с тем же Bearer API-ключом. Доступ есть только у владельца. Логика status прежняя: queued / processing — продолжать; succeeded — читать data[0].url; failed — читать error. progress добавлен для Token. Обрабатывайте отсутствие полей и будущие неизвестные этапы.

curl https://nezhagate.com/v1/videos/jobs/img_example -H 'Authorization: Bearer YOUR_API_KEY'

• phase — этап, не процент и не оценка времени. ready / total — число уникальных готовых / необходимых референсов; для текста и улучшения допустим ноль. label и detail — английские подписи, не условия программы. terminal отражает конечный статус; failed_stage равен null до ошибки. При восстановлении этапы могут пропускаться или повторяться.
• submitted=true подтверждает ID генерации, false означает, что отправка не началась, null — отправка началась, исход неизвестен. Не повторяйте запрос автоматически при null или таймауте. reservation_released=true подтверждает освобождение резерва с нулевой стоимостью; false не доказывает списание. updated_at — время обновления записи задачи, не отдельного этапа; job_id — ID NezhaGate.
• Отказ по параметрам, балансу или первичной проверке промпта возвращает HTTP-ошибку до создания задачи, без ID для опроса. Первичная проверка не гарантирует окончательного одобрения. Ошибка импорта/проверки референсов останавливает генерацию и возвращает failed и error. При временных сетевых ошибках увеличьте интервал и опрашивайте тот же ID. Промежуточные webhook-события не добавлены.

{
  "id": "img_example",
  "object": "video.generation.job",
  "status": "processing",
  "created": 1792800000,
  "model": "seedance-2.5-token",
  "progress": {
    "phase": "reviewing",
    "label": "Reviewing references",
    "detail": "References ready: 3 / 5",
    "ready": 3,
    "total": 5,
    "terminal": false,
    "failed_stage": null,
    "submitted": false,
    "reservation_released": false,
    "updated_at": "2026-10-24T05:00:00+00:00",
    "job_id": "img_example"
  }
}

Коды ошибок

У всех ошибок одна структура: error.message / error.type / error.code / error.param; ориентируйтесь на code. Ниже — самые частые ошибки; полный список — в разделе Коды ошибок.

Полный список кодов ошибок →