UlazAI API Documentatie
Référence complète de l'API
Documentation complète de tous les points de terminaison de l'API UlazAI, des méthodes d'authentification et de gestion des erreurs.
📋 Table des matières
🔐 Authentification
UlazAI prend en charge deux méthodes d'authentification : Authentification par jeton dans Authentification par clé API.
/api/s'inscrire/
Créer un nouveau compte utilisateur
Corps de la demande
{
"nom d'utilisateur": "johndoe",
"email": "[email protected]",
"mot de passe": "secure_password123"
}
Commentaire (201 créés)
{
"token": "votre-jeton-d'authentification-ici",
"utilisateur": {
"identifiant": 1,
"nom d'utilisateur": "johndoe",
"email": "[email protected]",
"crédits_balance": 0
}
}
/api/connexion/
Connectez-vous avec votre nom d'utilisateur et votre mot de passe pour obtenir un jeton d'authentification
Corps de la demande
{
"nom d'utilisateur": "johndoe",
"mot de passe": "secure_password123"
}
Réponse (200 OK)
{
"token": "votre-jeton-d'authentification-ici",
"utilisateur": {
"identifiant": 1,
"nom d'utilisateur": "johndoe",
"email": "[email protected]",
"crédits_balance": 100
}
}
/api/api-clés/
Vérification requise
Créer une nouvelle clé API pour l'authentification
En-têtes de requête
Autorisation : Jeton
Corps de la demande
{
"name": "Clé API de production"
}
Commentaire (201 créés)
{
"id": "uuid-ici",
"name": "Clé API de production",
"key": "ulazai_live_abc123...", // Affiché une seule fois !
"key_preview": "ulazai_li...",
"created_at": "2025-01-15T10:00:00Z"
}
⚠️ Important: La clé API complète n'est affichée qu'une seule fois lors de la création. Gardez-le en sécurité !
Utiliser l'authentification
Authentification par jeton
Autorisation : Jeton
Authentification par clé API
Autorisation : Porteur ulazai_live_abc123...
🎨 Générer une image
/api/v1/générer/
Vérification requise
Générer une nouvelle image à partir d'une invite de texte
Corps de la demande
{
"prompt": "Un magnifique coucher de soleil sur les montagnes avec un lac au premier plan",
"taille": "3:2" // Options : "1:1", "3:2", "2:3"
}
Commentaire (201 créés)
{
"succès": vrai,
"données": {
"generation_id": "uuid-ici",
"statut": "traitement",
"credits_used": 8,
"crédits_remaining": 92,
"message": "La génération d'images a démarré avec succès"
}
}
Coûts du crédit
Toutes les tailles d'image coûtent 8 crédits par génération
/api/v1/générer/historique/
Vérification requise
Obtenez votre histoire générationnelle
Paramètres de requête
?limit=20&offset=0&type=image
🎬 Génération vidéo
/api/v1/générer/vidéo/
Vérification requise
Générer une nouvelle vidéo à partir de texte ou d'image
Corps de la demande
{
"prompt": "Un chat qui joue dans un jardin",
"video_model": "veo3_fast", // Options : "veo3_fast", "veo3"
"aspect_ratio": "16:9", // Options : "16:9", "9:16"
"watermark_text": "MyBrand", // Facultatif, max 50 caractères
"source_image_urls": [], // Facultatif, pour l'image vers la vidéo
"prompt_directory_optin": true // 💰 Bénéficiez de 10 crédits de réduction ! (par défaut : vrai)
}
💰 Économisez 10 crédits : Ensemble prompt_directory_optin : vrai pour partager votre vidéo dans notre répertoire public d'invites et obtenez 10 crédits de réduction sur chaque génération !
Coûts du crédit
• veo3_fast (16:9) : 130 crédits
• veo3_fast (9:16) : 150 crédits
• veo3 (tous les rapports) : 300 crédits
🎬 API Google Je vois 3.1 NOUVEAU
✨ NOUVEAU: Google Veo 3.1 avec gestion des frames, filigranes et taux de conversion de 99%. Afficher la documentation complète →
/veo31/api/générer/
Vérification requise
Générez des vidéos de 8 secondes avec Google Veo 3.1 - Comprend le contrôle de la première et de la dernière image
Corps de la demande
{
"prompt": "Un golden retriever courant parmi les fleurs au coucher du soleil",
"model": "veo3_fast", // "veo3_fast" ou "veo3"
"aspectRatio": "16:9", // "16:9", "9:16", "Auto"
"imageUrls": [], // Facultatif : images à 1 ou 2 images
"watermark": "MyBrand", // Facultatif : max 50 caractères
"enableFallback": false, // +200 crédits pour 99% de réussite
"enableTranslation": true // Traduction automatique en anglais
}
Coûts du crédit
• Veo 3.1 Rapide : 100 crédits (génération 30-45 ans)
• Qualité Veo 3.1 : 250 crédits (45-60s, meilleure qualité)
• Mode de repli : +200 crédits (facultatif, 99% de réussite)
Commentaire (201 créés)
{
"succès": vrai,
"données": {
"task_id": "veo31_abc123",
"statut": "traitement",
"model": "veo3_fast",
"crédits_charged": 100,
"estimated_time": "30-45 secondes"
}
}
Vérifier l'état
OBTENIR /veo31/api/status/{task_id}/
Réaction :
{
"succès": vrai,
"données": {
"statut": "terminé",
"video_url": "https://cdn.ulazai.com/videos/veo31_abc123.mp4",
"résolution": "1080p",
"durée": 8
}
}
📖 Documentation complète : Voir Je vois la documentation de l'API 3.1 pour des aperçus détaillés, la vérification des images et plus de fonctionnalités.
🎬API Kling 3.0 NOUVEAU
🆕 Kling 3.0 : Tarification à la seconde, audio natif, invites multi-prises et contrôle de début/fin d'image. Afficher la documentation complète →
/kling30/api/générer/
Vérification requise
Générez des clips de 3 à 15 secondes avec les modes texte-vidéo ou image-vidéo.
Corps de la demande
{
"prompt": "Un héros dramatique en contre-plongée révélé avec des reflets de pluie et de néon",
"générationMode": "text_to_video",
"duréeSecondes": 8,
"qualityMode": "pro",
"son": vrai,
"multiShots": vrai,
"aspectRatio": "16:9",
"prompt_directory_optin" : vrai
}
Coûts du crédit
• Standard sans audio : 20 credits/seconde
• Standard avec son : 30 credits/seconde
• Pro non-audio : 27 crédits/seconde
• Pro avec audio : 40 credits / seconde
📖 Documentation complète : Voir Documentation sur l'API Kling 3.0 pour les champs de demande, le format de statut et des exemples.
🎬API Kling 2.6 MEILLEURE VALEUR
💰 Option la moins chère : À partir de seulement 55 crédits pour des vidéos de 5 secondes avec prise en charge audio native. Afficher la documentation complète →
/kling26/api/générer/
Vérification requise
Générez des vidéos de 5 à 10 secondes avec un son natif en option
Corps de la demande
{
"prompt": "Un chien qui court dans un champ au coucher du soleil",
"GenerationMode": "text_to_video", // ou "image_to_video"
"duration": "5", // "5" ou "10" secondes
"aspectRatio": "16:9", // "16:9", "9:16", "1:1"
"sound": false, // Audio natif (double le coût)
"imageUrls": [], // Obligatoire pour image_to_video
"prompt_directory_optin": true // 💰 Bénéficiez de 10 crédits de réduction !
}
💰 Économisez 10 crédits : Ensemble prompt_directory_optin : vrai pour partager votre vidéo dans notre répertoire public d'invites et bénéficier d'une réduction de 10 crédits !
Coûts du crédit
• 5s sans audio : 55 crédits
• 10s sans audio : 110 crédits
• 5s avec audio : 110 crédits
• 10 s avec audio : 220 crédits
📖 Documentation complète : Voir Documentation sur l'API Kling 2.6 pour des exemples et des paramètres détaillés.
🎬 API Sœur 2 OUVERTURE
🚀 OpenAI Sora 2 : Vidéos premium de 10 secondes en 1080p avec une qualité incroyable. Afficher la documentation complète →
/api/v1/sora/generate/text-to-video/
Vérification requise
Générez des vidéos 1080p de 10 secondes avec OpenAI Sora 2
Corps de la demande
{
"prompt": "Un paysage de montagne serein au lever du soleil avec des oiseaux qui volent",
"aspect_ratio": "paysage", // "paysage", "portrait", "carré"
"qualité": "standard", // "standard" ou "élevé"
"prompt_directory_optin": true // 💰 Bénéficiez de 10 crédits de réduction !
}
💰 Économisez 10 crédits : Ensemble prompt_directory_optin : vrai pour partager votre vidéo dans notre répertoire public d'invites et bénéficier d'une réduction de 10 crédits !
Coûts du crédit
• Texte vers vidéo : 80 crédits par vidéo
• Image vers vidéo : 80 crédits par vidéo
📖 Documentation complète : Voir Documentation sur l'API Sora 2 pour des exemples détaillés, des conversions d'image en vidéo et bien plus encore.
🎬 API Seedance 1.5 Pro AUDIO-VIDÉO
🎬 Semence 1.5 Pro : Génération audio-vidéo cinématographique avec des clips de 4 à 12 secondes, une résolution de 480p/720p et un son natif en option. Afficher la documentation complète →
/semer/générer/
Vérification requise
Générez des vidéos Seedance 1.5 Pro avec des images et de l'audio d'entrée en option.
Corps de la demande
{
"prompt": "Un gros plan cinématographique d'un chef retournant des nouilles au ralenti",
"input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
"aspect_ratio": "16:9",
"résolution": "720p",
"durée": "8",
"generate_audio" : vrai,
"prompt_directory_optin" : vrai
}
💰 Remise sur la brochure : 10 crédits de réduction pour les options de haut niveau (28+ crédits) lorsque prompt_directory_optin : vrai.
Coûts du crédit
• 480p : 8/14 (4s), 14/28 (8s), 19/38 (12s) crédits
• 720p : 14/28 (4s), 28/56 (8s), 42/84 (12s) crédits
• Le coût audio est affiché comme la valeur la plus élevée dans chaque paire.
📖 Documentation complète : Voir Documents de l'API Seedance 1.5 Pro pour des paramètres complets et des exemples.
🎬 API Wan 2.6 T2V/I2V/V2V
🎬 Wan 2.6 : Le modèle vidéo cinématographique multi-plans d'Alibaba avec les modes T2V, I2V et V2V, audio natif et vidéos jusqu'à 15 secondes. Essayez le terrain de jeu Wan 2.6 →
/wan26/générer/
Vérification requise
Générez des vidéos avec Wan 2.6 - prend en charge les modes texte-vidéo, image-vidéo et vidéo-vidéo
Corps de la demande
{
"prompt": "Un plan cinématographique d'une femme marchant la nuit dans Tokyo",
"mode": "texte vers vidéo", // ou "image vers vidéo", "vidéo vers vidéo"
"duration": "5", // "5", "10" ou "15" secondes
"résolution": "1080p", // "720p" ou "1080p"
"image_url": "...", // Requis pour la conversion d'image en vidéo
"video_url": "..." // Requis pour la vidéo vers vidéo
}
Coûts du crédit
• 720p : 70 (5s) / 140 (10s) / 210 (15s) crédits
• 1080p : 105 (5s) / 210 (10s) / 315 (15s) crédits
📖 Essayez-le maintenant : Visitez le Wan 2.6 Aire de jeux pour des exemples détaillés, les modes I2V, V2V et plus encore.
📊 Contrôle de statut
/api/v1/generate/{génération_id}/
Vérification requise
Vérifiez le statut de chaque génération (image ou vidéo)
Réponse (200 OK)
{
"id": "uuid-ici",
"generation_type": "vidéo",
"statut": "terminé",
"prompt": "Un chat qui joue dans un jardin",
"video_url": "https://cdn.ulazai.com/videos/...",
"video_model": "veo3_fast",
"credits_used": 130,
"created_at": "2025-01-15T10:00:00Z",
"completed_at": "2025-01-15T10:01:30Z"
}
👤 Gestion des utilisateurs
/api/profil/
Vérification requise
Recevoir les informations actuelles du profil utilisateur
Réponse (200 OK)
{
"identifiant": 1,
"nom d'utilisateur": "johndoe",
"email": "[email protected]",
"credits_balance": 92,
"total_images_generated": 12,
"enable_watermark": vrai,
"watermark_text": "MaMarque",
"created_at": "2025-01-10T08:00:00Z"
}
/api/profil/
Vérification requise
Mettre à jour les paramètres du profil utilisateur
Corps de la demande
{
"enable_watermark": vrai,
"watermark_text": "MaMarque.com"
}
💳 Paiements et crédits
/paiements/api/crédits/
Vérification requise
Recevez un crédit actuel
Réponse (200 OK)
{
"credits_balance": 92,
"total_spent": "25,00",
"total_credits_purchased": 2400
}
/paiements/api/transactions/
Vérification requise
Obtenir l'historique des transactions
❌ Gestion des erreurs
Format de réponse d'erreur standard
{
"succès": faux,
"error": "Message d'erreur ici",
"détails": {
"field_name": "Erreur de champ spécifique"
}
}
Paramètres de requête invalides
La demande est mal formatée ou il manque des champs obligatoires
Authentification manquante ou invalide
Aucun jeton d'authentification ou clé API valide fourni
Crédits insuffisants
Crédits insuffisants pour réaliser l'opération demandée
Accès refusé
Vous n'avez pas accès à cette ressource
Source introuvable
La ressource demandée n'existe pas
Limite de débit dépassée
Trop de demandes en peu de temps. Ralentissez, s'il vous plaît
Serveurfout
Quelque chose s'est mal passé de notre côté. Veuillez réessayer
🚦 Limites de tarifs
📝 Exemple complet
Exemple Python
demandes d'importation
heure d'importation
# Configuration
API_KEY = "ulazai_live_uw_api_key_hier"
BASE_URL = "https://ulazai.com"
en-têtes = {
"Autorisation": f"Porteur {API_KEY}",
"Content-Type": "application/json"
}
# Générer une vidéo
données_vidéo = {
"prompt": "Un magnifique timelapse de coucher de soleil sur l'océan",
"video_model": "veo3_fast",
"aspect_ratio": "16:9",
"watermark_text": "Ma marque"
}
réponse = requêtes.post(f"{BASE_URL}/api/v1/generate/video/",
json=video_data, en-têtes=en-têtes)
si réponse.status_code == 201 :
résultat = réponse.json()
génération_id = résultat["données"]["génération_id"]
print(f"Démarrage de la génération vidéo : {génération_id}")
# Sondage sur le statut
tandis que Vrai :
status_response = requêtes.get(
f"{BASE_URL}/api/v1/genereren/{Generation_id}/",
en-têtes=en-têtes
)
status_data = status_response.json()
if status_data["status"] == "terminé":
print(f"Claque vidéo : {status_data['video_url']}")
pause
elif status_data["status"] == "échec":
print(f"Génération erronée : {status_data.get('error_message')}")
pause
print(f"Statut : {status_data['status']}...")
time.sleep(10) # Attendez 10 secondes pour le prochain contrôle
sinon :
print(f"Fout : {response.json()}")
🤝 Besoin d'aide ?
•WhatsApp : Demandez-nous n'importe quoi
•Documents : docs.ulazai.com