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

Справочник Seedance API

Полная документация API для интеграции Seedance Video AI в ваши приложения. Генерируйте высококачественные видео из текстовых промптов и изображений.

REST API
JSON-ответы
Генерация видео

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

Seedance API использует аутентификацию Bearer Token. Включите ваш API-токен в заголовок Authorization:

Authorization: Bearer your-api-token-here

Примечание о безопасности: Никогда не раскрывайте ваш API-токен в клиентском коде или публичных репозиториях.

Базовый URL

Все API-запросы должны отправляться на:

https://seedanceapi.org/v1

Эндпоинты API

POST

Генерация видео

/generate

Генерируйте высококачественные видео из текстовых промптов и изображений с помощью AI-моделей.

Тело запроса

Текст в видео (T2V)
{
  "prompt": "cardi b bends over to pick up coins",
  "mode": "text",
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 5,
  "framespersecond": 24,
  "seed": -1
}
Изображение в видео (I2V)
{
  "prompt": "kissing",
  "mode": "img2img",
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 5,
  "framespersecond": 24,
  "seed": -1,
  "image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
}

Параметры

ПараметрТипОписание
promptстрокаТекстовое описание генерируемого видео
modeстрокаРежим генерации: "text" для T2V или "img2img" для I2V
image_urlстрока?URL входного изображения (обязательно для режима img2img)
resolutionстрокаРазрешение видео: "480p", "720p" или "1080p"
ratioстрокаСоотношение сторон видео (по умолчанию: "adaptive")
durationцелое числоДлительность видео в секундах (по умолчанию: 5)
framespersecondцелое числоКадров в секунду (по умолчанию: 24)
seedцелое числоСлучайное зерно для воспроизводимых результатов (по умолчанию: -1)

Ответ

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_123456789"
  }
}
endpoints.generate.curl
Текст в видео (T2V):
curl -X POST https://seedanceapi.org/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "cardi b bends over to pick up coins",
    "mode": "text",
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 5,
    "framespersecond": 24,
    "seed": -1
  }'
Изображение в видео (I2V):
curl -X POST https://seedanceapi.org/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "kissing",
    "mode": "img2img",
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 5,
    "framespersecond": 24,
    "seed": -1,
    "image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
  }'
GET

Получить статус задачи

/status?task_id=xxxx

Проверьте статус текущей или завершённой задачи генерации видео.

Параметры

ПараметрТипОписание
task_idстрокаID задачи, возвращённый из эндпоинта генерации

Ответ

{
  "code": 200,
  "message": "success",
  "data": {
    "consumed_credits": 10,
    "created_at": "2024-01-01T00:00:00Z",
    "status": "completed",
    "task_id": "task_123456789",
    "user_request": {
      "prompt": "A beautiful landscape with flowing water",
      "model": "seedance-video-v1",
      "duration": 5
    },
    "user_response": {
      "video_url": "https://cdn.seedance.com/generated/video.mp4",
      "last_frame_url": "https://cdn.seedance.com/generated/last_frame.jpg"
    },
    "provider_status": "success",
    "model": "seedance-video-v1"
  }
}
endpoints.generate.curl
curl -X GET "https://seedanceapi.org/v1/status?task_id=task_123456789" \
  -H "Authorization: Bearer your-api-token"

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

Seedance API возвращает стандартные HTTP-коды статуса и сообщения об ошибках:

HTTP-коды статуса

200OK
400Bad Request
401Unauthorized
429Rate Limited
500Server Error

Формат ответа об ошибке

{
  "code": 400,
  "message": "Invalid request: The prompt parameter is required",
  "error": "INVALID_REQUEST"
}

Лучшая практика: Всегда обрабатывайте ошибки корректно и проверяйте HTTP-коды статуса перед обработкой тела ответа.

Лимиты запросов

100
запросов/минуту
Бесплатный план
1000
запросов/минуту
Pro план
5000
запросов/минуту
Корпоративный

Заголовки лимитов: Каждый ответ включает заголовки X-RateLimit-Remaining и X-RateLimit-Reset для отслеживания вашего текущего использования.

Готовы начать разработку?

Получите ваш API-ключ и начните создавать потрясающие видео с Seedance

НачатьНа главную