Generación de vídeo y consulta de tareas

Crea y consulta tareas asíncronas de vídeo como Seedance.

POST/v1/videos/generations
https://api.hanrouter.ai/v1Gestionar claves API

URL 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.

Ejemplo de solicitud
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.

Ejemplo de solicitud
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.

Ejemplo de solicitud
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í.

Ejemplo de solicitud
# 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
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

JSON · estructura de ejemplo
{
  "id": "task-id-from-response",
  "status": "submitted"
}