Saltar al contenido principal

​
Endpoints

MétodoEndpointDescripción
POST/api/v1/generateTask/veo-3-1Crear tarea de generación
GET/api/v1/statusTask/veo-3-1Consultar 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 (condicional)
​
provider
string
predeterminado:"auto"
auto, value u official
​
input
object
requerido
Tipos de generación:
  • TEXT_2_VIDEO — Texto a vídeo puro
  • FIRST_AND_LAST_FRAMES_2_VIDEO — Fotogramas inicial y final a vídeo, requiere image_urls (máx. 2)
  • REFERENCE_2_VIDEO — Imagen de referencia a vídeo, requiere modo fast, image_urls (máx. 3), aspect_ratio debe ser 16:9

​
Ejemplo

Text-to-Video 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/veo-3-1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "quality",
      "prompt": "a cinematic flyover of a futuristic city at sunrise",
      "generationType": "TEXT_2_VIDEO",
      "aspect_ratio": "16:9"
    }
  }'
First/Last Frame to Video 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/veo-3-1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "callback",
    "callback_url": "https://your-server.com/callback",
    "input": {
      "mode": "quality",
      "prompt": "a calm ocean turning into a storm",
      "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
      "image_urls": [
        "https://example.com/frame_start.jpg",
        "https://example.com/frame_end.jpg"
      ],
      "aspect_ratio": "9:16"
    }
  }'

​
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

​
Consejos

  • Tiempo: Media ~2 min. Espera 90s y consulta cada 5s.
  • Modo callback: Recomendado.
  • Restricción REFERENCE_2_VIDEO: Solo soporta modo fast y aspect_ratio debe ser 16:9.
La generación de vídeo tarda más — usa modo callback. URLs caducan tras 15 días.

​
Relacionado