Generar video e imágenes desde tus propias herramientas

Inicio rápido

1. 1

   Crear una clave

   Genera una clave de API en tu panel de control. Solo se muestra una vez, así que guárdala en un lugar seguro.

   Gestionar claves
2. 2

   Llamar a la API

   Envía una solicitud POST con tu clave Bearer y un encabezado Idempotency-Key.

   cURLJavaScriptPython

   Copy

   curl -X POST https://www.seedance2ai.io/api/v1/video/seedance2 \
     -H "Authorization: Bearer $SEEDANCE_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: demo-video-001" \
     -d '{
       "mode": "text-to-video",
       "quality_tier": "standard",
       "prompt": "A cinematic shot of a glass train crossing a snowy mountain bridge",
       "aspect_ratio": "16:9",
       "duration": "5",
       "resolution": "720p"
     }'

3. 3

   Consultar el resultado

   Consulta el endpoint de estado de la tarea hasta que el estado sea completado o fallido, luego lee la salida.

   cURLJavaScriptPython

   Copy

   while true; do
     TASK=$(curl -s https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
       -H "Authorization: Bearer $SEEDANCE_API_KEY")
     STATUS=$(echo "$TASK" | jq -r '.status')
     if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
       echo "$TASK" | jq
       break
     fi
     sleep 10
   done

Autenticación

Cada solicitud se autentica con una clave API Bearer en el encabezado Authorization.

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
Idempotency-Key: a-unique-id-per-request

Tasks and balance

Read endpoints for building a task history, showing remaining credits, or discovering models at runtime. They share the read rate limit.

curl "https://www.seedance2ai.io/api/v1/tasks?limit=20" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "sd2_xxxxx",
      "type": "video",
      "status": "completed",
      "model": "seedance2",
      "credits_used": 30,
      "result_urls": ["https://..."]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

curl "https://www.seedance2ai.io/api/v1/balance" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "credits": 1200,
  "subscription_credits": 1000,
  "subscription_credits_expire_at": "2026-07-01T00:00:00.000Z"
}

curl "https://www.seedance2ai.io/api/v1/models" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "seedance2",
      "name": "Seedance 2.0",
      "type": "video",
      "method": "POST",
      "endpoint": "/api/v1/video/seedance2",
      "modes": ["text-to-video", "image-to-video", "media-to-video"],
      "task_id_prefix": "sd2_"
    }
  ]
}

Códigos de error

Every error has the same shape. Branch on code, and show message to a person. A task that was accepted can still fail later, so also check status when you poll.

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request body: prompt: String must contain at least 3 character(s)"
  }
}

Rate limits

A request over the limit returns HTTP 429 with a Retry-After header in seconds, plus X-RateLimit-Limit and X-RateLimit-Reset. Wait that long, then retry with the same Idempotency-Key.

Submit a job

30 per 60 seconds

Every POST endpoint, counted per account across all of its keys.

Read

120 per 60 seconds

Task status, task list, balance and models. Counted separately, so polling never uses up the submit budget.

Reference media validation

3 per 60 seconds

Seedance requests that include reference media, per account and source IP.

Usar con Claude Code

Usa Copy for AI para exportar la API completa como Markdown limpio, pégalo en Claude Code o Codex y deja que el agente configure la integración. O apunta el agente directamente al endpoint de texto sin procesar.

Skill

Instala la habilidad Seedance en Claude Code, Codex o cualquier agente — escribe prompts cinematográficos y los renderiza a través de la API por ti.

# Download the one-file skill from Seedance 2.0 AI
mkdir -p ~/.claude/skills/seedance
curl --fail --location -H "Authorization: Bearer $SEEDANCE_API_KEY" https://www.seedance2ai.io/downloads/seedance-skill.md -o ~/.claude/skills/seedance/SKILL.md.tmp &&
mv ~/.claude/skills/seedance/SKILL.md.tmp ~/.claude/skills/seedance/SKILL.md

Preguntas frecuentes

¿Quién puede usar la API?

Cualquiera con créditos. No hay restricción por plan — cualquier cuenta con créditos puede crear una clave y llamar a la API.

¿Cómo consigo créditos?

Recarga o suscríbete en la página de precios. Los créditos se añaden a tu saldo al instante.

¿Los créditos se comparten entre el sitio web y la API?

Sí — tu saldo de crédito personal se utiliza tanto para la generación web como para las llamadas API. En un equipo, las llamadas API usan el saldo personal de cada miembro, no el fondo compartido del equipo.

¿Cómo empiezo?

Crea una clave de API en tu panel de control, luego llama a los endpoints con un token Bearer (consulta la guía de inicio rápido arriba).

¿Qué pasa si una llamada devuelve insufficient_credits?

Tu saldo está vacío — recarga en la página de precios e inténtalo de nuevo.