Référence API

Documentation API complète pour la génération vidéo Veo 3.1 AI

Aperçu

L'API Veo 3.1 vous permet de générer programmatiquement des vidéos AI à partir de descriptions textuelles ou d'images. Notre API RESTful est conçue pour être simple, puissante et facile à intégrer dans vos applications.

URL de base

https://veo3o1.com/api

Authentification

Toutes les requêtes API nécessitent une authentification à l'aide d'une clé API. Incluez votre clé API dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Vous pouvez générer des clés API depuis votre tableau de bord.


Générer une vidéo

Créez une nouvelle vidéo AI à partir de texte ou d'image.

Point de terminaison

POST /generate-video

Corps de la requête

{
  "generationType": "text_to_video" | "image_to_video",
  "prompt": "Your video description",
  "aspectRatio": "auto" | "16:9" | "9:16",
  "imageUrl": "https://...", // Required if generationType is "image_to_video"
  "imageKey": "r2-key" // Optional, for uploaded images
}

Paramètres

ParamètreTypeRequisDescription
generationTypestringOuiType de génération : text_to_video ou image_to_video
promptstringOuiDescription de la vidéo que vous souhaitez générer
aspectRatiostringNonRatio d'aspect de la vidéo. Par défaut : auto
imageUrlstringConditionnelRequis si generationType est image_to_video
imageKeystringNonClé de stockage pour les images téléchargées

Réponse

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "pending",
    "generationType": "text_to_video",
    "prompt": "Your video description",
    "aspectRatio": "16:9",
    "createdAt": "2025-10-16T10:00:00Z"
  }
}

Exemple

curl -X POST https://veo3o1.com/api/generate-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "generationType": "text_to_video",
    "prompt": "A beautiful sunset over the ocean with waves gently lapping the shore",
    "aspectRatio": "16:9"
  }'

Obtenir le statut de la vidéo

Vérifiez le statut d'une demande de génération vidéo.

Point de terminaison

GET /video-status/{uuid}

Paramètres

ParamètreTypeRequisDescription
uuidstringOuiUUID de la vidéo de la demande de génération

Réponse

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "completed" | "pending" | "processing" | "failed",
    "videoUrl": "https://...", // Available when status is "completed"
    "progress": 85, // Processing progress (0-100)
    "estimatedTime": 120 // Estimated seconds remaining
  }
}

Valeurs de statut

  • pending : La vidéo est en file d'attente pour traitement
  • processing : La vidéo est en cours de génération
  • completed : La vidéo est prête et disponible au téléchargement
  • failed : La génération a échoué (vérifiez le message d'erreur)

Télécharger une image

Téléchargez une image pour la génération image-vers-vidéo.

Point de terminaison

POST /upload-video-image

Requête

Utilisez multipart/form-data pour télécharger le fichier image.

curl -X POST https://veo3o1.com/api/upload-video-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

Réponse

{
  "code": 0,
  "msg": "Upload successful",
  "data": {
    "imageUrl": "https://...",
    "imageKey": "r2-key-123"
  }
}

Formats supportés

  • JPEG/JPG
  • PNG
  • WebP
  • Taille maximale du fichier : 50MB

Codes d'erreur

CodeDescription
0Succès
1000Paramètres invalides
1001Crédits insuffisants
1002Échec de l'authentification
1003Limite de débit dépassée
5000Erreur serveur

Exemple de réponse d'erreur

{
  "code": 1001,
  "msg": "Insufficient credits",
  "data": {
    "required": 2,
    "current": 0
  }
}

Bonnes pratiques

  1. Polling responsable : Vérifiez le statut de la vidéo toutes les 5-10 secondes, pas en continu
  2. Gestion des erreurs : Implémentez une logique de réessai avec backoff exponentiel
  3. Mise en cache des résultats : Stockez les vidéos générées pour éviter la régénération
  4. Utiliser les webhooks : Plus efficace que le polling pour les notifications de complétion
  5. Valider les entrées : Vérifiez la longueur du prompt et les formats d'image avant les appels API

Support

Besoin d'aide avec l'API ?