Migrar Seedance desde Volcengine

Usa esta guía si tu aplicación ya envía solicitudes Seedance con formato Volcengine. Puedes conservar los nombres de Action, Version=2024-01-01, content[], los cuerpos PascalCase de materiales y el sobre de respuesta de Volcengine. Solo deben cambiar el endpoint y la autenticación.

Qué cambia

Elemento	Cliente Volcengine existente	TokenLab
URL base	`Volcengine API`	`https://api.tokenlab.sh/`
Autenticación	`AK/SK`	`Authorization: Bearer <TOKENLAB_API_KEY>`
Solicitud Action	`Action`, `Version`	`Action`, `Version`
Cuerpo de tarea	`content[]`	`content[]`
Cuerpo de material	`PascalCase`	`PascalCase`
Resultado asíncrono	`ID de tarea`	`cgt-...` + Sondeo

Las solicitudes que solo contienen firma AK/SK devuelven 401 InvalidCredential. Los clientes Action pueden usar POST /?Action=...&Version=2024-01-01; POST /api/v3?Action=...&Version=2024-01-01 sigue disponible. Los clientes REST usan /api/v3/contents/generations/tasks.

Formato de solicitud y ciclo de vida de tareas

Si tu integración ya envía solicitudes Seedance estilo Volc, puedes usar el endpoint compatible en vez de transformar el body para /v1/videos/generations. Envía tu API key de TokenLab como Authorization: Bearer ..., usa POST /api/v3/contents/generations/tasks para creación REST o /api/v3?Action=CreateContentsGenerationsTasks&Version=2024-01-01 para solicitudes Action. La creación devuelve un ID cgt-...; los estados usan queued, running, succeeded, failed, cancelled o expired. Este endpoint compatible acepta elementos content[] como text, image_url, video_url, audio_url y draft_task. Se conservan roles de imagen como first_frame, last_frame y reference_image. callback_url todavía no está soportado; consulta el endpoint de tarea.

Páginas de referencia

Actions de tareas

Action	Elemento	JSON
`CreateContentsGenerationsTasks`	Crear una tarea de video	`model`, `content[]`
`GetContentsGenerationsTask`	Obtener una tarea	`TaskId`
`ListContentsGenerationsTasks`	Listar tareas	Filtros, paginación
`DeleteContentsGenerationsTasks`	Cancelar o eliminar una tarea	`TaskId`

Ejemplo Action mínimo

curl 'https://api.tokenlab.sh/?Action=CreateContentsGenerationsTasks&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"seedance-2.0",
    "content":[
      {"type":"text","text":"A cinematic product reveal"},
      {"type":"image_url","role":"reference_image","image_url":{"url":"https://example.com/reference.png"}}
    ],
    "ratio":"16:9",
    "duration":5,
    "resolution":"720p"
  }'

Materiales y verificación de personas

El mismo endpoint Action admite diez operaciones de materiales y grupos. Consulta Actions de materiales compatibles con Volcengine para los cuerpos PascalCase, filtros, paginación, sobre de respuesta y URL de 12 horas. Para personas reales, antes de cargar llama también a Crear sesión de verificación visual y Obtener resultado de verificación visual.

Lista de comprobación de migración

Cambia el host de la API a https://api.tokenlab.sh.
Sustituye la firma AK/SK por una clave API Bearer de TokenLab.
Conserva Action, versión y mayúsculas del cuerpo existentes.
Usa el mismo ProjectName en solicitudes relacionadas de materiales y verificación.
Guarda los ID de tarea, grupo y material devueltos por TokenLab.
Verifica creación, polling, listado y errores antes de mover tráfico de producción.

Primeros pasos

Guías principales

Guías de medios

Migrar Seedance desde Volcengine

Qué cambia

Formato de solicitud y ciclo de vida de tareas

Páginas de referencia

Actions de tareas

Ejemplo Action mínimo

Materiales y verificación de personas

Lista de comprobación de migración

​Qué cambia

​Formato de solicitud y ciclo de vida de tareas

​Páginas de referencia

​Actions de tareas

​Ejemplo Action mínimo

​Materiales y verificación de personas

​Lista de comprobación de migración

Qué cambia

Formato de solicitud y ciclo de vida de tareas

Páginas de referencia

Actions de tareas

Ejemplo Action mínimo

Materiales y verificación de personas

Lista de comprobación de migración