Saltar al contenido principal

​
Endpoints

MétodoEndpointDescripción
POST/api/v1/generateTask/vidu-q3Crear tarea de generación
GET/api/v1/statusTask/vidu-q3Consultar estado de la tarea

​
Autenticación

Authorization: Bearer YOUR_API_KEY

​
Parámetros

​
request_type
string
predeterminado:"async"
Modo de ejecución: async (polling) o callback
​
callback_url
string
URL de callback. Requerida cuando request_type=callback. (condicional)
​
provider
string
predeterminado:"auto"
Estrategia: auto, value, official o canal de proveedor específico
​
input
object
requerido
Referencia de modos:
  • text-to-video - Generar vídeo solo desde texto
  • image-to-video - Generar vídeo desde 1 o 2 imágenes
  • turbo-text-to-video - Modo Turbo texto a vídeo
  • turbo-image-to-video - Modo Turbo imagen a vídeo con 1 o 2 imágenes

​
Ejemplos

Text-to-video 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/vidu-q3" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "text-to-video",
      "prompt": "a cinematic flyover of a futuristic city at sunrise",
      "resolution": "720p",
      "duration": 8,
      "style": "general",
      "aspect_ratio": "16:9",
      "movement": "auto",
      "sound": true,
      "bgm": true
    }
  }'
Animación de imagen única (image-to-video, 1 imagen) 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/vidu-q3" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "callback",
    "callback_url": "https://your-server.com/callback",
    "input": {
      "mode": "image-to-video",
      "prompt": "make this image come alive with subtle motion",
      "resolution": "1080p",
      "duration": 4,
      "image_urls": ["https://example.com/start.jpg"]
    }
  }'
Generación first-and-last-frame (image-to-video, 2 imágenes) 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/vidu-q3" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "image-to-video",
      "prompt": "transition from start to end smoothly",
      "resolution": "720p",
      "duration": 8,
      "image_urls": [
        "https://example.com/start.jpg",
        "https://example.com/end.jpg"
      ]
    }
  }'

​
Respuesta

Devuelve taskId en éxito. Consulta estado vía GET con taskId.

​
Códigos de error

CódigoDescripción
400Parámetros inválidos o solicitud mal formada
401Clave de API ausente o inválida
402Saldo insuficiente
429Límite de tasa superado
Código de falloDescripción
CONTENT_VIOLATIONLa solicitud viola directrices de seguridad
INVALID_IMAGE_URLNo se pudo recuperar la URL de imagen proporcionada

​
Límites de tasa

LímiteValor
Tasa de solicitudes60 solicitudes por minuto
Tareas simultáneas10

​
Consejos

  • Imágenes por modo: En image-to-video y turbo-image-to-video, 1 imagen = animación única; 2 imágenes = transición first-and-last-frame.
  • Facturación: Por segundo; segundos facturados = duration. Ver Precios.
  • Polling: Espera ~60-90s tras enviar y consulta cada 5s. Para alta concurrencia, prefiere callback.
  • Caducidad: Las URLs de salida pueden expirar. Descarga y almacena con prontitud.
La generación de vídeo tarda más que las imágenes — usa modo callback para producción. URLs caducan tras 15 días.

​
Relacionado