Saltar al contenido principal
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast",
    "prompt": "Dolphins leaping in the azure ocean",
    "duration": 8,
    "aspect_ratio": "16:9",
    "image_urls": ["https://cdn.apimart.ai/doc/9998238783208208-9972597b-255d-4e7e-9649-e6ee38a837aa-image_task_01K88B53MTK41PP5KGDTG2PA5P_0.png"]
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast",
    "prompt": "Dolphins leaping in the azure ocean",
    "duration": 8,
    "aspect_ratio": "16:9",
    "image_urls": ["https://cdn.apimart.ai/doc/9998238783208208-9972597b-255d-4e7e-9649-e6ee38a837aa-image_task_01K88B53MTK41PP5KGDTG2PA5P_0.png"]
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

​
Autorización

​
Authorization
string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala a la cabecera de la solicitud:
Authorization: Bearer YOUR_API_KEY

​
Parámetros de la solicitud

​
model
string
predeterminado:"veo3.1-fast"
requerido
Nombre del modelo de generación de videoModelos disponibles:
  • veo3.1-fast - Modelo de generación rápida, adecuado para previsualizaciones e iteraciones rápidas
  • veo3.1-quality - Modelo de generación de alta calidad, adecuado para la producción final
  • veo3.1-lite - Modelo de generación ligero, adecuado para generación por lotes de bajo coste
Ejemplo: "veo3.1-fast"
​
prompt
string
requerido
Descripción textual para la generación de video
​
duration
integer
Duración del video en segundosValor fijo: 8 (VEO3 solo admite duración de 8 segundos)
​
aspect_ratio
string
Proporción del videoFormatos admitidos:
  • 16:9 (Horizontal)
  • 9:16 (Vertical)
​
generation_type
string
Tipo de generación de videoTipos admitidos:
  • frame - Fotograma-a-video (modo FL)
  • reference - Imagen-de-referencia-a-video
Si no se especifica, se determina según el número de imágenes: 2 imágenes para fotograma-a-video, 3 imágenes para imagen-de-referencia-a-videoNota: El modelo veo3.1-quality no admite el modo reference
El modelo veo3.1-lite no admite este parámetro, no lo envíe
​
image_urls
array<url>
Array de URLs de imagen de referencia para generación imagen-a-videoAdmite URLs de imagen accesibles públicamente (http:// o https://)Ejemplo: ["https://example.com/image.jpg"]Limitaciones:
  • Máximo de 3 imágenes
  • Para el modo fotograma-a-video: la primera imagen es el fotograma inicial, la segunda imagen es el fotograma final
  • Tamaño máximo del archivo: 10MB
  • Formatos admitidos: .jpeg, .jpg, .png, .webp
El modelo veo3.1-lite no admite este parámetro, no lo envíe
​
resolution
string
Resolución del videoValores admitidos:
  • 720p (Predeterminado)
  • 1080p
  • 4k
​
enable_gif
boolean
Habilitar el formato de salida GIF. Predeterminado: falseNota: GIF y resolución 1080p/4k no se pueden usar simultáneamente
​
official_fallback
boolean
predeterminado:"false"
Si se usa el canal oficial como respaldo
  • false: No usar (predeterminado)
  • true: Usar canal oficial
El modelo veo3.1-lite no admite este parámetro, no lo envíe

​
Respuesta

​
code
integer
Código de estado de la respuesta
​
data
array
Array de datos de la respuesta