Saltar al contenido principal

​
Endpoints

MétodoEndpointDescripción
POST/api/v1/generateTask/sora-2-proCrear tarea de generación
GET/api/v1/statusTask/sora-2-proConsultar estado de la tarea

​
Autenticación

Authorization: Bearer YOUR_API_KEY

​
Parámetros

​
request_type
string
predeterminado:"async"
async (polling) o callback (webhook)
​
callback_url
string
URL de callback, requerida cuando request_type=callback (condicional)
​
provider
string
predeterminado:"official"
Solo official soportado; establece provider=official explícitamente.
​
input
object
requerido
Opciones de modo:
  • text-to-video — Generar vídeo desde prompt de texto
  • image-to-video — Generar vídeo desde imagen de referencia

​
Ejemplo

Text-to-Video 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/sora-2-pro" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "provider": "official",
    "input": {
      "mode": "text-to-video",
      "prompt": "a cinematic tracking shot of a futuristic city with flying cars",
      "duration": 8,
      "size": "1280*720"
    }
  }'
Image-to-Video 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/sora-2-pro" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "callback",
    "callback_url": "https://your-server.com/callback",
    "provider": "official",
    "input": {
      "mode": "image-to-video",
      "prompt": "make this image come alive with subtle motion",
      "duration": 12,
      "resolution": "1080p",
      "image_urls": ["https://example.com/reference_image.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 error de solicitud
401Clave de API inválida o ausente
429Límite de tasa superado
Código de falloDescripción
CONTENT_VIOLATIONEl contenido viola directrices de seguridad
INVALID_IMAGE_URLNo se puede acceder a la URL de imagen proporcionada

​
Límites de tasa

LímiteValor
Solicitudes60 / minuto
Tareas simultáneas10

​
Consejos

  • Tiempo: Media ~3 min por vídeo. Espera 120s y consulta cada 5s.
  • Enrutamiento: Incluye siempre provider=official explícitamente.
  • Modo callback: Recomendado por tiempos largos.
  • Size vs Resolution: size en text-to-video (720*1280, 1280*720, etc.); resolution en image-to-video (720p, 1080p).
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