Passer au contenu
UlazAI

Documentation du développeur UlazAI

Studio vidéo API

Tarifs Tableau de bord Studio d'images
POSTER /api/v1/video-studio/generate/

Point de terminaison de génération vidéo canonique

Utilisez Video Studio pour tous les modèles vidéo actuels. Ce point de terminaison prend en charge flux de travail texte-vidéo, image-vidéo et spécifiques au modèle, tels que remix vidéo.

Pour les intégrations dynamiques, récupérez les capacités du modèle à partir de /api/v1/models/video/ avant d'envoyer des charges utiles de génération.

Les itinéraires récents de Video Studio incluent seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v, et happyhorse_videoedit.
Authentification : envoyer Authorization: Bearer YOUR_API_KEY à chaque demande.

Sondage avec /api/v1/video-studio/status/{job_id}/ et charger récent emplois de /api/v1/video-studio/history/.

Demander un contrat

Champ Tapez Obligatoire Remarques
model_slug chaîne Oui Doit correspondre à un slug de modèle Video Studio enregistré
prompt chaîne Habituellement Requis pour la plupart des modèles. Le mode Storyboard peut démarrer uniquement avec des images.
aspect_ratio chaîne Non Doit correspondre à l'un des formats d'image du modèle sélectionné
duration_seconds entier Non Doit correspondre à une durée autorisée pour le modèle. Motion Control utilise la longueur du clip de mouvement pour la tarification.
quality_mode chaîne Non Obligatoire lorsque le modèle définit des modes de qualité
input_image_urls tableau[chaîne] Spécifique au modèle Utilisé pour les modèles image-vidéo. Certains modèles nécessitent au moins une URL.
input_video_urls tableau[chaîne] Spécifique au modèle Utilisé par les remix vidéo et les itinéraires source-vidéo tels que wan_2_6_v2v, kling_3_0_motion_control, video_lip_sync, et happyhorse_videoedit.
seedance_mode chaîne Semence 2 uniquement Utiliser text_to_video, first_frame, first_last_frame, ou multimodal.
first_frame_url, last_frame_url chaîne Semence 2 uniquement À utiliser pour les modes Seedance 2 première image et première + dernière image. URL publiques et asset:// Les pièces d'identité sont acceptées.
reference_image_urls, reference_video_urls, reference_audio_urls tableau[chaîne] Spécifique au modèle Seedance 2 utilise des tableaux de référence multimodaux. Des itinéraires audio tels que video_lip_sync et omnihuman_1_5 utiliser reference_audio_urls pour le discours ou la voix off cible. URL publiques et asset:// Les identifiants sont acceptés là où le modèle sélectionné les prend en charge.
character_orientation chaîne Spécifique au modèle Contrôle de mouvement uniquement. Utiliser video pour suivre l'orientation du clip animé ou image pour conserver le cadrage des personnages téléchargés, avec des durées de 3 à 15 secondes.
sound booléen Non Utilisé uniquement sur les modèles avec support audio
return_last_frame, web_search booléen Semence 2 uniquement Indicateurs Seedance 2 facultatifs pour renvoyer la dernière image et activer la recherche Web côté modèle.
prompt_directory_optin booléen Non La remise sur l'annuaire s'applique uniquement aux familles de modèles sélectionnées
Pour des séquences de personnes réelles dans Seedance 2, utilisez le Guide des actifs UlazAI Seedance 2 et passer le retour asset:// Pièce d'identité. Les fichiers bruts directs peuvent échouer.

Sélecteur de modèle

Choisissez un modèle pour inspecter les fonctionnalités et générer automatiquement des extraits de requête.

Seedance 2.5 model_slug=seedance_2_5

4-30 second generation in 480p/720p with text, first-frame, first+last-frame, or multimodal mode. Supports up to 30 image, 10 video, and 10 audio references plus MP4/MOV output.

Moteur : Seedance 2.5

Rapports d'aspect : 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive

Durées : 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 secondes

Modes qualité : 480p, 720p, 1080p

Entrées : texte , photo , vidéo

Crédits : 480p 4 no video input: 112, 480p 5 no video input: 140, 480p 6 no video input: 168, 480p 7 no video input: 196, +77 more

Extraits de requêtes en direct

Les extraits ci-dessous suivent le modèle prédéfini sélectionné.

cURL (clé API)

JavaScript (récupérer)

Python (requêtes)

Extraits d'interrogation d'état

Statut du sondage par job_id jusqu'à ce que completed ou failed.

boucle

JavaScript (récupérer)

Python (requêtes)

Exemples de réponses

Succès

{
  "success": true,
  "job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
  "credits_remaining_total": 438
}

Erreur de validation

{
  "success": false,
  "error": "Invalid duration for this model"
}

Crédits insuffisants

{
  "success": false,
  "error": "Insufficient credits",
  "credits_required": 220,
  "credits_available": 94
}

Point de terminaison vidéo à clé API (ancien)

Si vous avez besoin d'appels vidéo basés sur la clé API, utilisez /api/v1/generate/video/. Ce chemin prend en charge un ensemble de modèles limité et est documenté sous le mappage vidéo existant.

Ouvrir le mapping vidéo existant Workflows de statut ouvert Matrice de modèle vidéo ouverte