UlazAI API Documentatie

API de génération vidéo Google Veo 3.1

Générez des vidéos cinématographiques d'IA avec le dernier modèle Veo 3.1 de Google - Avec contrôle d'image, filigranes et taux de conversion de 99 %.

✨ NOUVEAU: Veo 3.1 Rapide (100 crédits) et qualité (250 crédits) désormais disponible avec premier et dernier frame check !

✨ Fonctionnalités Veo 3.1

✅ Deux modes de qualité - Rapide (30-45s) et qualité (45-60s)

✅ Contrôle du cadre - Définir les premières et dernières images d'image

✅ Texte vers vidéo Dans image vers vidéo

✅ Vidéos de 8 secondes avec l'audio natif

✅ Prise en charge des filigranes - Ajouter le texte de la marque

✅ 99% de taux de réussite avec le mode de secours

✅ Traduction automatique en anglais

✅ Plusieurs formats d'image (16:9, 9:16, automatique)

💰 Tarifs

⚡ Veo 3.1 Rapide

100 crédits

~$0,92 par vidéo

30-45 deuxième génération

💎 Qualité Veo 3.1

250 crédits

~2,31$ par vidéo

45-60 deuxième génération

🛡️ Mode de repli

+200 crédits

Ajout facultatif

Garantie de réussite à 99 %

POSTE /veo31/api/générer/

Veo 3.1 Générer une vidéo

Créez une vidéo de 8 secondes avec Google Veo 3.1 à l'aide d'invites de texte et de cadres d'image facultatifs.

Corps de la demande

{
  "prompt": "Un golden retriever courant dans un champ de fleurs au coucher du soleil",
  "modèle": "veo3_fast", // Options : "veo3_fast", "veo3"
  "aspectRatio": "16:9", // Options : "16:9", "9:16", "Auto"
  "imageUrls": [], // Facultatif : Tableau de 1 à 2 URL d'image
  "seeds": 42069, // Facultatif : 10000-99999 pour des résultats reproductibles
  "watermark": "UlazAI", // Facultatif : Max 50 caractères
  "enableFallback": false, // Facultatif : +200 crédits pour 99 % de réussite
  "enableTranslation": true // Facultatif : traduction automatique en anglais
}

Paramètres

rapidement * (chaîne)

Description textuelle de la vidéo à générer. 5 000 caractères maximum. Soyez descriptif des actions, des mouvements de caméra et de l’atmosphère.

modèle * (chaîne)

Modèle à utiliser : veo3_snel (100 crédits, 30-45s) ou véo3 (250 crédits, 45-60s, meilleure qualité)

rapport d'aspect (chaîne)

Rapport hauteur/largeur de la vidéo : 16:9 (paysage), 9:16 (portrait), Auto (automatique). Standard: 16:9

URL d'image (matrice)

Séquence facultative de 1 à 2 URL d'image avant framecontrol :
• 1 image : la vidéo tourne autour de cette image
• 2 images : transitions vidéo de la première à la dernière image
Maximum 10 Mo par image, JPG/PNG uniquement

graines (entier)

Semence facultative pour des résultats reproductibles. Plage : 10 000 à 99 999

filigrane (chaîne)

Texte de filigrane facultatif pour la superposition sur la vidéo. 50 caractères maximum. Idéal pour le branding.

activer le repli (booléen)

Activer le mode de secours (+200 crédits). Utilise automatiquement un modèle de sauvegarde lorsque les politiques de contenu sont activées. Taux de réussite de 99%. Standard: FAUX

Activer la traduction (booléen)

Traduction automatique de l'invite en anglais pour de meilleurs résultats. Prend en charge toutes les langues. Standard: vrai

Réponse réussie (201)

{
  "succès": vrai,
  "données": {
    "task_id": "veo31_abc123def456",
    "statut": "traitement",
    "model": "veo3_fast",
    "crédits_charged": 100,
    "crédits_remaining": 900,
    "estimated_time": "30-45 secondes",
    "message": "La génération vidéo Veo 3.1 a démarré avec succès"
  }
}

Réponse d'erreur (400)

{
  "succès": faux,
  "error": "Crédits insuffisants. Requis : 100, Disponible : 50"
}

Exemple cURL : texte vers vidéo

curl -X POST https://ulazai.com/veo31/api/generate/ \
  -H "Autorisation : Jeton YOUR_API_KEY" \
  -H "Type de contenu : application/json" \
  -d '{
    "prompt": "Un golden retriever courant à travers un champ de fleurs au coucher du soleil, ralenti, éclairage cinématique",
    "model": "veo3_fast",
    "aspectRatio": "16:9",
    "watermark": "MaMarque",
    "enableTranslation": vrai
  }'

Exemple cURL - Image vers vidéo avec gestion des images

curl -X POST https://ulazai.com/veo31/api/generate/ \
  -H "Autorisation : Jeton YOUR_API_KEY" \
  -H "Type de contenu : application/json" \
  -d '{
    "prompt": "Le personnage tourne lentement la tête et sourit à la caméra",
    "modèle": "veo3",
    "aspectRatio": "16:9",
    "imageUrls": ["https://votre-domaine.com/start-frame.jpg"],
    "graines": 42069,
    "enableFallback": vrai
  }'

Exemple Python

demandes d'importation
heure d'importation

API_KEY = "votre_api_key_here"
BASE_URL = "https://ulazai.com"

# Générer une vidéo
réponse = requêtes.post(
    f"{BASE_URL}/veo31/api/generate/",
    en-têtes={
        "Autorisation": f"Jeton {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "Un lac de montagne serein au lever du soleil avec de la brume s'élevant de l'eau",
        "model": "veo3_fast",
        "aspectRatio": "16:9",
        "watermark": "MaMarque"
    }
)

données = réponse.json()
si données["succès"] :
    task_id = data["data"]["task_id"]
    print(f"Tâche créée : {task_id}")
    
    # Sondage pour finalisation
    tandis que Vrai :
        status_response = requêtes.get(
            f"{BASE_URL}/veo31/api/status/{task_id}/",
            headers={"Autorisation": f"Jeton {API_KEY}"}
        )
        
        status_data = status_response.json()
        if status_data["data"]["status"] == "completed":
            video_url = status_data["data"]["video_url"]
            print(f"Vidéo prête : {video_url}")
            pause
        elif status_data["data"]["status"] == "échec":
            print(f"Échec de la génération : {status_data['data']['error_message']}")
            pause
        
        time.sleep(5) # Sondage toutes les 5 secondes
sinon :
    print(f"Erreur : {données['erreur']}")
OBTENIR /veo31/api/status//

Vérifier l'état de la génération

Vérifiez l'état d'une tâche de génération vidéo Veo 3.1.

Réponse - Traitement

{
  "succès": vrai,
  "données": {
    "task_id": "veo31_abc123def456",
    "statut": "traitement",
    "model": "veo3_fast",
    "prompt": "Un golden retriever courant à travers les fleurs",
    "crédits_charged": 100
  }
}

Réponse - Terminé

{
  "succès": vrai,
  "données": {
    "task_id": "veo31_abc123def456",
    "statut": "terminé",
    "video_url": "https://cdn.ulazai.com/videos/veo31_abc123.mp4",
    "thumbnail_url": "https://cdn.ulazai.com/videos/veo31_abc123_thumb.jpg",
    "résolution": "1080p",
    "durée": 8,
    "aspect_ratio": "16:9",
    "fallback_used": faux,
    "crédits_charged": 100
  }
}

Réponse - Échec

{
  "succès": vrai,
  "données": {
    "task_id": "veo31_abc123def456",
    "status": "échec",
    "error_message": "Violation de la politique de contenu. Activez le mode de secours pour réessayer.",
    "crédits_refunded": 100
  }
}

exemple de boucle

curl -X GET https://ulazai.com/veo31/api/status/veo31_abc123def456/ \
  -H "Autorisation : jeton YOUR_API_KEY"
POSTE /veo31/api/upload-frame/

Télécharger l'image du cadre

Téléchargez une image pour la vérification des images (première ou dernière image). Renvoie une URL à utiliser dans le point de terminaison généré.

Requête (multipart/form-data)

Type de contenu : multipart/form-data

image : (données du fichier binaire)

Paramètres

image * (existait)

Fichier image à télécharger. Maximum 10 Mo. Formats pris en charge : JPG, PNG. Résolution recommandée : 1 920 x 1 080 ou supérieure.

Réponse réussie (200)

{
  "succès": vrai,
  "url": "https://cdn.ulazai.com/uploads/frame_abc123.jpg",
  "message": "Image téléchargée avec succès"
}

exemple de boucle

curl -X POST https://ulazai.com/veo31/api/upload-frame/ \
  -H "Autorisation : Jeton YOUR_API_KEY" \
  -F "afbeelding=@/pad/naar/uw/afbeelding.jpg"

Codes d'état

200 OK - Demande réussie

201 Créé - La tâche de génération a été créée avec succès

400 Mauvaise demande - Paramètres invalides ou crédits insuffisants

401 Non autorisé - Clé API déverrouillée ou invalide

404 Non trouvé - ID de travail introuvable

413 Charge trop importante - L'image dépasse la limite de 10 Mo

429 Trop de demandes - Limite de débit dépassée

500 Erreur de serveur interne - Erreur de serveur, contactez le support

Valeurs d'état du travail

en attente - Tâche créée, en attente de démarrage

traitement - La vidéo est générée

complété - Génération vidéo réussie, video_url disponible

échoué - La génération échoue, les crédits sont automatiquement remboursés

💡 Bonnes pratiques

Utiliser des indices descriptifs

Ajoutez des détails sur les actions, les mouvements de caméra, l'éclairage et l'atmosphère. Exemple : "gros plan au ralenti de gouttelettes d'eau qui tombent, éclairées par un coucher de soleil doré, faible profondeur de champ"

Activer la solution de secours pour le contenu important

Si la vidéo est critique et que vous ne pouvez vous permettre aucune erreur, activez le mode de repli (+200 crédits) pour un taux de réussite de 99 %.

Utilisez des graines pour plus de cohérence

Si vous souhaitez régénérer des vidéos similaires, utilisez la même valeur de départ (10 000-99999) pour des résultats plus cohérents.

Contrôle du cadre pour le branding

Téléchargez 1 image pour centrer votre vidéo autour d'elle, ou 2 images pour créer une transition fluide. Parfait pour des vidéos cohérentes de personnages ou de produits.

Sondage efficace du statut

Sondez toutes les 5 secondes pour le mode rapide, 10 secondes pour le mode qualité. Ne sondez pas plus souvent pour éviter les plafonds de taux.

📝 Exemples d'invites

✅ Bonne invite

"Un aigle majestueux survole les montagnes enneigées au lever du soleil, une lumière dorée illumine ses ailes, un suivi de caméra au ralenti depuis le bas, une composition cinématographique"

✅ Bonne invite

"Gros plan d'un barista versant du latte art, vapeur s'élevant de la tasse, éclairage chaleureux du café, faible profondeur de champ, perspective d'objectif macro"

❌ Mauvaise invite

"aigle vole"

Trop vague : il manque des détails sur le réglage, le mouvement et l'angle de la caméra.

Besoin d'aide ?

Vous rencontrez des problèmes avec l'API Veo 3.1 ? Nous sommes là pour vous aider !

Contacter l'assistance Afficher tous les documents