Обзор API

Seedance 2.0 Open API позволяет отправлять асинхронные задачи генерации видео из вашего продукта и получать результат после завершения обработки.

Base URL

https://www.seedance2.ink

Authentication

Все запросы Open API используют Bearer-токен, созданный в панели Seedance.

Authorization: Bearer sd2_live_your_api_key

{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

Поток интеграции

1. Создайте API Key в панели Seedance.
2. Отправьте задачу через POST /api/open/v1/video/generations.
3. Сохраните возвращенный requestId.
4. Опрашивайте GET /api/open/v1/video/generations/{requestId} до финального статуса.
5. При необходимости используйте Webhook для получения уведомления о завершении.

Основные эндпоинты

Available Models

Supported aspect ratios:

• 16:9
• 9:16
• 1:1

Статусы

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models

{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhook

Вы можете передать webhookUrl в конкретном запросе или настроить URL по умолчанию на уровне API Key.

• Если заданы оба варианта, приоритет у webhookUrl из запроса.
• Если настроен Webhook Secret, в запрос добавляется x-seedance-signature.
• Webhook отправляется только после перехода задачи в финальный статус.

x-seedance-signature: <hex_sha256_hmac>

{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

Коды ошибок

Следующие шаги

• Открыть Текст в видео
• Открыть Изображение в видео