Seedance 2.0
Seedance 2.0
DocumentacionPrimeros pasos
Resumen de APITexto a videoImagen a video
Referencia API

Resumen de API

Entiende la autenticacion, el envio de tareas, la consulta de estado y los webhooks de la Seedance 2.0 Open API.

La Seedance 2.0 Open API te permite enviar trabajos de generacion de video asincronos desde tu propio producto y recuperar el resultado cuando termina el procesamiento.

Base URL

https://www.seedance2.ink

Authentication

Todas las solicitudes de Open API usan un token Bearer creado en el panel de Seedance.

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

Flujo de integracion

  1. Crea una API Key en el panel de Seedance.
  2. Envia una tarea con POST /api/open/v1/video/generations.
  3. Guarda el requestId devuelto.
  4. Consulta GET /api/open/v1/video/generations/{requestId} hasta el estado final.
  5. Usa un webhook si quieres recibir la notificacion de finalizacion.

Endpoints principales

MethodEndpointDescription
GET/api/open/v1/modelsLista modelos disponibles, duraciones, proporciones, resoluciones y datos de precio.
POST/api/open/v1/video/generationsCrea una nueva tarea de generacion de video.
GET/api/open/v1/video/generations/{requestId}Consulta el estado y devuelve la URL final cuando esta lista.
POST/api/open/v1/video/generations/{requestId}/cancelCancela una tarea en cola o en proceso.

Available Models

ModelBest forSupported durationsResolutions
seedance-2.0Highest quality, multimodal generation4-15 seconds480p, 720p, 1080p
seedance-2.0-fastFaster turnaround4-15 seconds480p, 720p, 1080p
seedance-1.5-proLower-cost fallback workloads5 or 10 seconds480p, 720p, 1080p

Supported aspect ratios:

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

Estados

StatusDescription
queuedLa solicitud fue aceptada y espera en la cola.
processingLa generacion esta en curso.
succeededLa tarea finalizo correctamente y output.url esta disponible.
failedLa tarea fallo. Revisa error.
cancelledLa tarea fue cancelada antes de completarse.

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

Puedes enviar webhookUrl por solicitud o configurar una URL de callback por defecto en la API Key.

  • Si existen ambas, la webhookUrl de la solicitud tiene prioridad.
  • Si configuras un Webhook Secret, la cabecera x-seedance-signature se incluye en la llamada.
  • Los webhooks solo se envian cuando la tarea llega a un 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 error

HTTP statusError codeDescription
400invalid_requestEl cuerpo de la solicitud no coincide con el esquema esperado.
401unauthorizedLa API Key falta o es invalida.
402insufficient_creditsNo hay creditos suficientes para crear la tarea.
404not_foundLa tarea no existe para la API Key actual.
429rate_limitedSe supero el limite por minuto o la cuota mensual.
500internal_errorSe produjo un error interno inesperado.

Siguientes pasos

  • Leer Texto a video
  • Leer Imagen a video

Primeros pasos

La forma mas rapida de empezar a trabajar con Seedance 2.0.

Texto a video

Genera videos a partir de prompts de texto con la Seedance 2.0 Open API.

Tabla de contenidos

Base URLAuthenticationFlujo de integracionEndpoints principalesAvailable ModelsEstadosModels Endpoint ExampleWebhooksCodigos de errorSiguientes pasos