Visao geral da API

A Seedance 2.0 Open API permite enviar tarefas de geracao de video assincronas a partir do seu proprio produto e recuperar o resultado quando o processamento terminar.

Base URL

https://www.seedance2.ink

Authentication

Todas as requisicoes da Open API usam um token Bearer criado no dashboard do Seedance.

Authorization: Bearer sd2_live_your_api_key

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

Fluxo de integracao

1. Crie uma API Key no dashboard do Seedance.
2. Envie uma tarefa com POST /api/open/v1/video/generations.
3. Guarde o requestId retornado.
4. Consulte GET /api/open/v1/video/generations/{requestId} ate o estado final.
5. Use webhook se quiser receber notificacoes de conclusao.

Endpoints principais

Available Models

Supported aspect ratios:

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

Status

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
      }
    }
  ]
}

Webhooks

Voce pode definir webhookUrl por requisicao ou configurar uma URL de callback padrao na API Key.

• Se ambos existirem, a webhookUrl da requisicao tem prioridade.
• Se um Webhook Secret estiver configurado, o header x-seedance-signature sera enviado.
• Webhooks sao enviados apenas quando a tarefa chega a um estado final.

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
}

Codigos de erro

Proximos passos

• Ler Texto para video
• Ler Imagem para video