Zum Inhalt springen
UlazAI

UlazAI Entwicklerdokumentation

Videostudio API

Preise Armaturenbrett Bildstudio
POST /api/v1/video-studio/generate/

Endpunkt für die kanonische Videogenerierung

Nutzen Sie Video Studio für alle aktuellen Videomodelle. Dieser Endpunkt unterstützt Text-zu-Video, Bild-zu-Video und modellspezifische Workflows wie z Video-Remix.

Für dynamische Integrationen rufen Sie Modellfunktionen ab /api/v1/models/video/ bevor Generierungsnutzlasten gesendet werden.

Zu den aktuellen Video Studio-Routen gehören: seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v, und happyhorse_videoedit.
Authentifizierung: Senden Authorization: Bearer YOUR_API_KEY auf jede Anfrage.

Umfrage mit /api/v1/video-studio/status/{job_id}/ und laden Sie aktuell Jobs von /api/v1/video-studio/history/.

Vertrag anfordern

Feld Typ Erforderlich Notizen
model_slug Zeichenfolge Ja Muss mit einem registrierten Video Studio-Modell-Slug übereinstimmen
prompt Zeichenfolge Normalerweise Für die meisten Modelle erforderlich. Der Storyboard-Modus kann nur mit Bildern beginnen.
aspect_ratio Zeichenfolge Nein Muss eines der Seitenverhältnisse des ausgewählten Modells sein
duration_seconds Ganzzahl Nein Muss einer zulässigen Dauer für das Modell entsprechen. Motion Control verwendet für die Preisgestaltung die Länge des Motion-Clips.
quality_mode Zeichenfolge Nein Erforderlich, wenn das Modell Qualitätsmodi definiert
input_image_urls Array[Zeichenfolge] Modellspezifisch Wird für Bild-zu-Video-Modelle verwendet. Einige Modelle erfordern mindestens eine URL.
input_video_urls Array[Zeichenfolge] Modellspezifisch Wird von Video-Remix- und Quell-Video-Routen verwendet, z wan_2_6_v2v, kling_3_0_motion_control, video_lip_sync, und happyhorse_videoedit.
seedance_mode Zeichenfolge Nur Seedance 2 Benutzen text_to_video, first_frame, first_last_frame, oder multimodal.
first_frame_url, last_frame_url Zeichenfolge Nur Seedance 2 Wird für die Seedance 2-Modi „Erstes Bild“ und „Erstes + letztes Bild“ verwendet. Öffentliche URLs und asset:// Ausweise werden akzeptiert.
reference_image_urls, reference_video_urls, reference_audio_urls Array[Zeichenfolge] Modellspezifisch Seedance 2 verwendet multimodale Referenzarrays. Audiogesteuerte Routen wie z video_lip_sync und omnihuman_1_5 verwenden reference_audio_urls für die Zielrede oder das Voiceover. Öffentliche URLs und asset:// IDs werden akzeptiert, sofern das ausgewählte Modell sie unterstützt.
character_orientation Zeichenfolge Modellspezifisch Nur Bewegungssteuerung. Benutzen video um der Ausrichtung des Bewegungsclips zu folgen oder image um den hochgeladenen Charakterrahmen beizubehalten, mit einer Dauer von 3 bis 15 Sekunden.
sound Boolescher Wert Nein Wird nur bei Modellen mit Audiounterstützung verwendet
return_last_frame, web_search Boolescher Wert Nur Seedance 2 Optionale Seedance 2-Flags zur Rückgabe des letzten Frames und zur Aktivierung der modellseitigen Websuche.
prompt_directory_optin Boolescher Wert Nein Der Verzeichnisrabatt gilt nur für ausgewählte Modellfamilien
Für Aufnahmen von echten Personen in Seedance 2 verwenden Sie die UlazAI Seedance 2 Asset-Leitfaden und übergeben Sie die Rückgabe asset:// Ausweis. Direkte Rohdateien können fehlschlagen.

Modellauswahl

Wählen Sie ein Modell aus, um Funktionen zu prüfen und Anforderungsausschnitte automatisch zu generieren.

Gemini Omni Flash 1.2 model_slug=gemini_omni_flash_1_2

Four modes, one per request: text or reference images (duration required, 3-15s, up to 6 images), first frame only (duration required, 3-15s), first and last frame (duration required, 3-10s), or video edit (one source video up to 15s via input_video_urls, no duration, optional reference images; billed on the measured source length). Aspect ratios 16:9, 9:16 or auto; 360p/720p/1080p/4K. Image quota: images plus 2 per video, max 7 total; each file max 20MB. Voice IDs and character IDs are not supported.

Motor: Gemini Omni

Seitenverhältnisse: 16:9, 9:16, auto

Dauer: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Sekunden

Qualitätsmodi: 360p, 720p, 1080p, 4k

Eingaben: Bild , Video

Credits: 360p 3: 15, 360p 4: 20, 360p 5: 24, 360p 6: 29, +48 more

Live-Anfrage-Snippets

Die folgenden Ausschnitte folgen der ausgewählten Modellvoreinstellung.

cURL (API-Schlüssel)

JavaScript (Abruf)

Python (Anfragen)

Snippets zur Statusabfrage

Umfragestatus von job_id bis completed oder failed.

cURL

JavaScript (Abruf)

Python (Anfragen)

Antwortbeispiele

Erfolg

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

Validierungsfehler

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

Unzureichende Credits

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

API-Key-Video-Endpunkt (Legacy)

Wenn Sie auf der API-Taste basierende Videoanrufe benötigen, verwenden Sie /api/v1/generate/video/. Dieser Pfad unterstützt a begrenzter Modellsatz und wird unter Legacy-Video-Mapping dokumentiert.

Öffnen Sie die Legacy-Videozuordnung Offene Status-Workflows Öffnen Sie die Videomodellmatrix