Generación de vídeo y consulta de tareas
Crea y consulta tareas asíncronas de vídeo como Seedance.
/v1/videos/generationshttps://api.hanrouter.ai/v1Gestionar claves APIURL y autenticación
Usa https://api.hanrouter.ai/v1 como URL base compatible con OpenAI y Authorization: Bearer $HANROUTER_API_KEY. No dupliques /v1. Todos los fabricantes usan tu clave HanRouter, no una clave del proveedor.
Para Anthropic SDK y Claude Code usa https://api.hanrouter.ai sin /v1; el cliente añade /v1/messages. Usa la interfaz compatible con OpenAI para Google.
Flujo de tareas de vídeo
El vídeo suele ser asíncrono: envía una vez, guarda el ID, consulta con la misma clave, espera éxito/error y descarga. HTTP 200 significa aceptado, no completado. Elige un modelo de vídeo de GET /v1/models y revisa permisos.
Enviar tarea de texto a vídeo
El estudio usa POST /v1/videos/generations con model, prompt, duration y resolution. Sustituye el ID por un modelo disponible compatible. Cinco segundos y 720p son ejemplos, no capacidades universales; respeta límites y precios del canal.
curl --max-time 300 "https://api.hanrouter.ai/v1/videos/generations" \
-H "Authorization: Bearer $HANROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_VIDEO_MODEL_ID",
"prompt": "A golden bull runs forward, slow cinematic camera movement",
"duration": 5,
"resolution": "720p"
}'Imagen a vídeo: primer fotograma
Los canales compatibles aceptan image: {"url":"https://..."}, como el primer fotograma del estudio. Usa una imagen accesible al proveedor. Algunos aceptan data URL y otros requieren HTTPS pública. Formato, proporción y tamaño dependen del modelo.
curl --max-time 300 "https://api.hanrouter.ai/v1/videos/generations" \
-H "Authorization: Bearer $HANROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_VIDEO_MODEL_ID",
"prompt": "A golden bull runs forward, slow cinematic camera movement",
"duration": 5,
"resolution": "720p",
"image": {
"url": "https://example.com/first-frame.png"
}
}'Protocolo content nativo de Seedance
Usa content en lugar del adaptador prompt solo si el canal Seedance admite explícitamente el protocolo nativo BytePlus/ModelArk. Bloque de texto: {type:"text",text:"..."}; primer fotograma habitual: {type:"image_url",image_url:{url:"https://..."},role:"first_frame"}. La ubicación de role varía según el gateway; no mezcles formatos de otro sitio.
ratio, generate_audio, seed, último fotograma, referencias de vídeo/audio, Draft y wait dependen del modelo y canal. No todas las versiones admiten 4–15 segundos, espera síncrona, audio o continuación; omite campos sin soporte confirmado.
curl --max-time 300 "https://api.hanrouter.ai/v1/videos/generations" \
-H "Authorization: Bearer $HANROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_SEEDANCE_MODEL_ID",
"content": [
{
"type": "text",
"text": "A cat runs along the beach at sunset"
}
],
"ratio": "16:9",
"duration": 5
}'Guardar ID y URL de consulta
El envío puede devolver id, task_id o request_id y estado submitted, queued o processing. Guarda respuesta e ID reales. El estudio consulta GET /v1/videos/{id}. Un canal nativo que use /v1/videos/generations/{id} requiere soporte explícito; la ruta de otro sitio no es automáticamente válida aquí.
# Illustrative submission response (not a real task)
{"id":"task-id-from-response","status":"processing"}
# Replace TASK_ID with the ID actually returned
curl "https://api.hanrouter.ai/v1/videos/$TASK_ID" \
-H "Authorization: Bearer $HANROUTER_API_KEY"Estados, resultados y reintentos seguros
Consulta cada cinco segundos y respeta Retry-After. Éxito puede ser succeeded/completed; fallo failed/error/expired/canceled. Sigue la respuesta real. El resultado puede estar en url, video_url, content.video_url, content[].video_url o result; no supongas una estructura universal. Conserva respuestas de éxito sin URL para soporte.
Ante 404 revisa ID, clave original, ruta y retención antes de reenviar. Un timeout no demuestra que no se creó la tarea. Para 400 revisa parámetros y acceso a referencias; 401/403 clave/permisos; 402 saldo; 429 concurrencia; 5xx conserva X-Request-Id y error censurado. No se garantizan reembolsos; cargos, devoluciones y unidades dependen de la consola. Descarga antes de que caduque la URL.
Parámetros
model- String obligatorio: ID exacto disponible para tu clave.
prompt- String: descripción para imágenes o adaptador de vídeo prompt; content nativo depende del canal.
content- Array Seedance: texto, imágenes o referencias admitidas.
duration- Entero opcional: segundos dentro de los límites.
resolution- String opcional: resolución admitida.
ratio- String opcional: proporción admitida, como 16:9; solo canales compatibles.
generate_audio- Boolean opcional: audio solo en modelos/canales compatibles.
seed- Entero opcional: semilla; rango según modelo/canal.
Ejemplo de solicitud
Los ejemplos usan IDs configurados. Los permisos del grupo de la clave determinan el acceso; consulta GET /v1/models.
curl -X POST "https://api.hanrouter.ai/v1/videos/generations" \
-H "Authorization: Bearer $HANROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "your-model-id",
"prompt": "A red bicycle beside a tree, slow camera movement",
"duration": 5,
"resolution": "720p"
}'Ejemplo de respuesta
{
"id": "task-id-from-response",
"status": "submitted"
}