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.

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.

Motor: Seedance 2.5

Seitenverhältnisse: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive

Dauer: 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 Sekunden

Qualitätsmodi: 480p, 720p, 1080p

Eingaben: Text , Bild , Video

Credits: 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

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