Seedance API LogoSeedance API
Documentación de API

Referencia de la API Seedance

Documentación completa de la API para integrar Seedance Video AI en tus aplicaciones. Genera videos de alta calidad a partir de prompts de texto e imágenes.

API REST
Respuestas JSON
Generación de Video

Autenticación

La API de Seedance utiliza autenticación Bearer Token. Incluye tu token de API en el encabezado Authorization:

Authorization: Bearer your-api-token-here

Nota de Seguridad: Nunca expongas tu token de API en código del lado del cliente o repositorios públicos.

URL Base

Todas las solicitudes de API deben realizarse a:

https://seedanceapi.org/v1

Endpoints de la API

POST

Generar Video

/generate

Genera videos de alta calidad a partir de prompts de texto e imágenes utilizando modelos de IA.

Cuerpo de la Solicitud

Texto a Video (T2V)
{
  "prompt": "cardi b bends over to pick up coins",
  "mode": "text",
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 5,
  "framespersecond": 24,
  "seed": -1
}
Imagen a Video (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"
}

Parámetros

endpoints.generate.params.header.parameterendpoints.generate.params.header.typeendpoints.generate.params.header.description
promptendpoints.generate.params.types.stringDescripción textual del video a generar
modeendpoints.generate.params.types.stringModo de generación: "text" para T2V o "img2img" para I2V
image_urlendpoints.generate.params.types.string?URL de la imagen de entrada (requerido para el modo img2img)
resolutionendpoints.generate.params.types.stringResolución del video: "480p", "720p" o "1080p"
ratioendpoints.generate.params.types.stringRelación de aspecto del video (predeterminado: "adaptive")
durationendpoints.generate.params.types.integerDuración del video en segundos (predeterminado: 5)
framespersecondendpoints.generate.params.types.integerCuadros por segundo (predeterminado: 24)
seedendpoints.generate.params.types.integerSemilla aleatoria para resultados reproducibles (predeterminado: -1)

Respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_123456789"
  }
}
endpoints.generate.curl
Texto a Video (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
  }'
Imagen a Video (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

Obtener Estado de la Tarea

/status?task_id=xxxx

Verifica el estado de una tarea de generación de video en curso o completada.

Parámetros

endpoints.generate.params.header.parameterendpoints.generate.params.header.typeendpoints.generate.params.header.description
task_idendpoints.generate.params.types.stringID de tarea devuelto del endpoint de generación

Respuesta

{
  "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"

Manejo de Errores

La API de Seedance devuelve códigos de estado HTTP estándar y mensajes de error:

Códigos de Estado HTTP

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

Formato de Respuesta de Error

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

Mejor Práctica: Siempre maneja los errores de forma elegante y verifica los códigos de estado HTTP antes de procesar el cuerpo de la respuesta.

Límites de Tasa

100
solicitudes/minuto
Plan Gratuito
1000
solicitudes/minuto
Plan Pro
5000
solicitudes/minuto
Empresarial

Encabezados de Límite de Tasa: Cada respuesta incluye los encabezados X-RateLimit-Remaining y X-RateLimit-Reset para rastrear tu uso actual.

¿Listo para empezar a construir?

Obtén tu clave de API y comienza a crear videos increíbles con Seedance

ComenzarVolver al Inicio