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/apiAuthentification
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_KEYVous 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-videoCorps 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ètre | Type | Requis | Description |
|---|---|---|---|
generationType | string | Oui | Type de génération : text_to_video ou image_to_video |
prompt | string | Oui | Description de la vidéo que vous souhaitez générer |
aspectRatio | string | Non | Ratio d'aspect de la vidéo. Par défaut : auto |
imageUrl | string | Conditionnel | Requis si generationType est image_to_video |
imageKey | string | Non | Clé 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ètre | Type | Requis | Description |
|---|---|---|---|
uuid | string | Oui | UUID 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 traitementprocessing: La vidéo est en cours de générationcompleted: La vidéo est prête et disponible au téléchargementfailed: 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-imageRequê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
| Code | Description |
|---|---|
| 0 | Succès |
| 1000 | Paramètres invalides |
| 1001 | Crédits insuffisants |
| 1002 | Échec de l'authentification |
| 1003 | Limite de débit dépassée |
| 5000 | Erreur serveur |
Exemple de réponse d'erreur
{
"code": 1001,
"msg": "Insufficient credits",
"data": {
"required": 2,
"current": 0
}
}Bonnes pratiques
- Polling responsable : Vérifiez le statut de la vidéo toutes les 5-10 secondes, pas en continu
- Gestion des erreurs : Implémentez une logique de réessai avec backoff exponentiel
- Mise en cache des résultats : Stockez les vidéos générées pour éviter la régénération
- Utiliser les webhooks : Plus efficace que le polling pour les notifications de complétion
- 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 ?
- 📧 Email : aiprocessingrobot@gmail.com
- 💬 Contacter le support