Passer au contenu 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"
    }
  ]
}

Autorisation

Authorization
string
requis
Tous les points de terminaison de l’API nécessitent une authentification par Bearer TokenObtenez votre API Key :Rendez-vous sur la page de gestion des API Keys pour obtenir votre API KeyAjoutez-la dans l’en-tête de la requête :
Authorization: Bearer YOUR_API_KEY

Paramètres de la requête

model
string
défaut:"veo3.1-fast"
requis
Nom du modèle de génération vidéoModèles disponibles :
  • veo3.1-fast — modèle de génération rapide, adapté aux prévisualisations et itérations rapides
  • veo3.1-quality — modèle de génération haute qualité, adapté à la production finale
  • veo3.1-lite — modèle de génération léger, adapté à la génération par lots à faible coût
Exemple : "veo3.1-fast"
prompt
string
requis
Description textuelle pour la génération vidéo
duration
integer
Durée de la vidéo en secondesValeur fixe : 8 (VEO3 ne prend en charge qu’une durée de 8 secondes)
aspect_ratio
string
Rapport d’aspect de la vidéoFormats pris en charge :
  • 16:9 (paysage)
  • 9:16 (portrait)
generation_type
string
Type de génération vidéoTypes pris en charge :
  • frame — image-vers-vidéo (mode FL)
  • reference — vidéo à partir d’une image de référence
Si non spécifié, défini par défaut en fonction du nombre d’images : 2 images pour image-vers-vidéo, 3 images pour vidéo à partir d’une image de référenceRemarque : le modèle veo3.1-quality ne prend pas en charge le mode reference
Le modèle veo3.1-lite ne prend pas en charge ce paramètre, ne le transmettez pas
image_urls
array<url>
Tableau d’URL d’images de référence pour la génération image-vers-vidéoPrend en charge les URL d’images accessibles publiquement (http:// ou https://)Exemple : ["https://example.com/image.jpg"]Limitations :
  • Maximum 3 images
  • Pour le mode image-vers-vidéo : la première image est l’image de début, la seconde est l’image de fin
  • Taille maximale du fichier : 10 Mo
  • Formats pris en charge : .jpeg, .jpg, .png, .webp
Le modèle veo3.1-lite ne prend pas en charge ce paramètre, ne le transmettez pas
resolution
string
Résolution de la vidéoValeurs prises en charge :
  • 720p (par défaut)
  • 1080p
  • 4k
enable_gif
boolean
Activer le format de sortie GIF. Par défaut : falseRemarque : GIF et résolution 1080p/4k ne peuvent pas être utilisés simultanément
official_fallback
boolean
défaut:"false"
Utiliser ou non le canal officiel comme solution de repli
  • false : ne pas utiliser (par défaut)
  • true : utiliser le canal officiel
Le modèle veo3.1-lite ne prend pas en charge ce paramètre, ne le transmettez pas

Réponse

code
integer
Code d’état de la réponse
data
array
Tableau de données de la réponse