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.

🔐 Authentification

UlazAI prend en charge deux méthodes d'authentification : Authentification par jeton dans Authentification par clé API.

POSTE /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
  }
}
POSTE /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
  }
}
POSTE /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

POSTE /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

OBTENIR /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

POSTE /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 →

POSTE /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 →

POSTE /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 →

POSTE /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 →

POSTE /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 →

POSTE /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 →

POSTE /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

OBTENIR /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

OBTENIR /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"
}
DÉPOSER /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

OBTENIR /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
}
OBTENIR /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"
  }
}
400 Mauvaise demande Paramètres de requête invalides

La demande est mal formatée ou il manque des champs obligatoires

401 Non autorisé Authentification manquante ou invalide

Aucun jeton d'authentification ou clé API valide fourni

402 Paiement requis Crédits insuffisants

Crédits insuffisants pour réaliser l'opération demandée

403 Interdit Accès refusé

Vous n'avez pas accès à cette ressource

404 Non trouvé Source introuvable

La ressource demandée n'existe pas

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

Trop de demandes en peu de temps. Ralentissez, s'il vous plaît

500 Erreur de serveur interne Serveurfout

Quelque chose s'est mal passé de notre côté. Veuillez réessayer

🚦 Limites de tarifs

Utilisateurs authentifiés 100 requêtes/minute
Utilisateurs de démonstration 10 requêtes/heure
Générations simultanées 5 par utilisateur

📝 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