Kling: Video v3.0 Pro
Kling VIDEO 3.0 Pro ist Kuaishous professionelles Videoprofil in 1080p für text- und bildgeleitete Szenen. Es verbindet Clips von drei bis fünfzehn Sekunden, natives Audio, gesteuerte Anfangs- und Endbilder sowie Regie für eine oder mehrere Einstellungen für filmische Konzepte und Kurzproduktionen.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Kling VIDEO 3.0 Pro ist das professionelle Profil von Kuaishous VIDEO-3.0-Modell. Sein dokumentierter Pro-Modus erzeugt 1080p-Video aus einem Textbriefing oder einer bildgestützten Szene mit Clips von drei bis fünfzehn Sekunden. Die 3.0-Version verbindet natives Audio, Steuerung zur Motivkonsistenz und Regie für mehrere Einstellungen und gibt einer Kurzproduktion damit einen klaren Weg zur Festlegung von Aussehen, Handlung, Kameraansichten und Ton.
Beginnen Sie mit der Haupthandlung der Szene. Beschreiben Sie in einer textgestützten Einstellung Motiv, Umgebung, Licht und den Blickwinkel, der die Handlung verständlich macht. Lassen Sie in einer bildgestützten Einstellung das Anfangsbild Aussehen und Komposition festlegen und verwenden Sie anschließend Text für die zeitlichen Veränderungen. Für ein eigenes Produktkonzept kann ein vorbereitetes Bild das Objekt auf einer Studiofläche zeigen, während der Prompt eine langsame Enthüllung von Material und Form beschreibt.
Regie für mehrere Einstellungen bietet automatische Kameraansichten oder eine benutzerdefinierte Folge. Automatische Generierung mehrerer Einstellungen plant Bildausschnitts- und Kamerawinkelwechsel aus dem Briefing; eine Szene, die in eine durchgehende Ansicht passt, kann dennoch eine einzelne Einstellung bleiben. Ein benutzerdefiniertes Storyboard legt Inhalt und Dauer jeder Einstellung fest. Das benutzerdefinierte Einstellungsprofil des Herstellers erlaubt ein bis sechs Einstellungen mit höchstens 512 Zeichen und mindestens einer Sekunde je Einstellung; ihre Dauern müssen zusammen die gesamte Cliplänge ergeben.
Beschreiben Sie für eine kurze Erzählung eine einführende Ansicht, die Haupthandlung und ein abschließendes Detail als separate Einstellungen. Benennen Sie die Kameragestaltung und was das Publikum jeweils bemerken soll. Halten Sie das Aussehen eines wiederkehrenden Motivs im Briefing konsistent und ändern Sie Handlung und Kameraansichten bewusst. Das Einzelprompt-Feld der Herstellerreferenz akzeptiert bis zu 2.500 Zeichen; eine benutzerdefinierte Folge verwendet ihre separaten Beschreibungen je Einstellung.
Motivreferenzen können eine bildgestützte Szene unterstützen, wenn Figur, Produkt oder Umgebung erkennbar bleiben sollen. Wählen Sie klare Ansichten, die die zu bewahrenden Merkmale vermitteln, und benennen Sie jedes referenzierte Motiv konsistent. Das dokumentierte bildgestützte Profil erlaubt bis zu drei vorbereitete Elemente. Halten Sie Referenzrollen gezielt, statt mehrere Dateien mit widersprüchlichen Vorgaben zum Motivaussehen zu verbinden.
Anfangs- und Endbilder bilden visuelle Grenzen eines bildgesteuerten Übergangs. Bereiten Sie Bilder vor, die bei Motiv und vorgesehener Szene übereinstimmen, und beschreiben Sie anschließend ihre Verbindung durch Bewegung. Die unterstützte Bildeingabe des Herstellers verwendet JPG, JPEG oder PNG mit Dateien von höchstens 10 MB, Abmessungen von mindestens 300 Pixeln und einem Anfangsbild-Seitenverhältnis zwischen 1:2.5 und 2.5:1. Eine bildgesteuerte Aufgabe und ein benutzerdefiniertes Storyboard haben eigene Eingabeverarbeitung; ordnen Sie das Material deshalb für den gewählten Workflow, bevor Sie das vollständige Briefing schreiben.
Natives Audio kann gesprochene Zeilen, Atmosphäre und visuelle Darbietung verbinden. Audio ist in der Herstellerreferenz standardmäßig ausgeschaltet und wird für eine audiovisuelle Szene aktiviert. Das 3.0-Sprachprofil umfasst Chinesisch, Englisch, Japanisch, Koreanisch und Spanisch mit Code-Switching und unterstützten Dialekt- oder Akzentgestaltungen. Laut Herstellerleitfaden wird in einer anderen Sprache eingegebener Dialog ins Englische übersetzt. Weisen Sie jede Zeile dem vorgesehenen Motiv zu und unterscheiden Sie Dialog von Hintergrundton, damit das Audiobriefing erklärt, wer spricht und was die Handlung umgibt.
Ein eigenes Briefing mit zwei Figuren kann Speaker A und Speaker B benennen, jedem eine kurze Zeile geben und die sichtbare Reaktion dazwischen beschreiben. Halten Sie den Dialog proportional zur Cliplänge und identifizieren Sie den Sprecher beim Ansichtswechsel. Stimmregie und Figurenreferenz erfüllen unterschiedliche Zwecke; das Briefing sollte die vorgesehene Darbietung benennen, statt anzunehmen, dass ein Referenzbild die zu sprechenden Wörter enthält.
VIDEO 3.0 verbessert außerdem den Umgang mit sichtbarer Beschriftung in einer bildgestützten Szene. Benennen Sie ein wichtiges Schild, Etikett oder eine Bildunterschrift im Briefing und bewahren Sie deren Referenzaussehen. Prüfen Sie im fertigen Clip Rechtschreibung, Lesbarkeit und Bewegung dieser Beschriftung, insbesondere wenn sie eine Produkt- oder Kampagnenaussage trägt. Die Beschriftungsfunktion eines Modells steuert Generierung, ersetzt aber keine abschließende visuelle Prüfung.
Das Pro-Profil ist 1080p, das Standardprofil 720p. Der separat gewählte 4K-Modus des Herstellers ist ein anderes Ausgabeprofil; Pro sollte deshalb nicht als Synonym für jede höhere Auflösung behandelt werden. Für textgestützte Generierung umfassen die dokumentierten Bildformate 16:9, 9:16 und 1:1. Wählen Sie das Bildformat für die vorgesehene Platzierung und halten Sie die Komposition darin lesbar.
Die Generierung läuft als Aufgabe, deren erfolgreiches Ergebnis das fertige Video und die tatsächliche Dauer bereitstellt. Laut Ergebnisdokumentation des Herstellers werden generierte Videos nach 30 Tagen gelöscht; speichern Sie den fertigen Clip deshalb zeitnah. Bewahren Sie Video, Briefing und Referenzmaterial zusammen auf und prüfen Sie anschließend Motivkontinuität, gewünschte Einstellungsreihenfolge, Kamerabewegung, Dialog und Beschriftung. Verwenden Sie den gewählten Clip als filmisches Konzept, Produktszene oder kurze Erzählung und überarbeiten Sie gezielt den Teil, der das vorgesehene Ergebnis verfehlt hat.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-v3.0-pro
kwaivgi/kling-v3.0-proStart
Kling VIDEO 3.0 Pro ist Kuaishous professionelles Videoprofil in 1080p für text- und bildgeleitete Szenen. Es verbindet Clips von drei bis fünfzehn Sekunden, natives Audio, gesteuerte Anfangs- und Endbilder sowie Regie für eine oder mehrere Einstellungen für filmische Konzepte und Kurzproduktionen.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Video POST /v1/videos
- Eingabetypen
text,image- Ausgabetypen
video- Ausgabeformat
- Originale MP4-Bytes; keine Normalisierung/Transkodierung
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits kwaivgi/kling-v3.0-pro | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldduration | Typinteger | AnforderungErforderlich | Werte und Limits 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 720p | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 16:9, 9:16, 1:1 | Standard— |
Feldgenerate_audio | Typboolean | AnforderungOptional | Werte und Limits false, true Bedingungen: Das Weglassen dieser Option wählt den Preis mit Audio. Setzen Sie sie auf false, um den Preis ohne Audio auszuwählen. Prüfen Sie has_audio im Ergebnis, um festzustellen, ob eine Audiospur zurückgegeben wurde. | Standard— |
Feldframe_images | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 2 Eingabeinhalt: Array von Frame-Objekten. Jedes Objekt enthält type=image_url, image_url mit url und frame_type. Verwenden Sie eine HTTPS-Bild-URL und setzen Sie frame_type auf first_frame oder last_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Exakte Schlüssel: type, image_url, frame_type Bedingungen: Diese Schlüssel beschreiben jedes Frame-Objekt; image_url enthält ausschließlich url. Lassen Sie frame_images bei einer reinen Textanfrage weg. | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits | Standard— |
Feldsize | Typstring | AnforderungOptional | Werte und Limits 1280x720, 720x1280, 720x720 Muster: ^[1-9][0-9]*x[1-9][0-9]*$ | Standard— |
Feldcallback_url | Typstring | AnforderungOptional | Werte und Limits Muster: ^https:// | Standard— |
Feldsession_id | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldtrace | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Felduser | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Kombinationen von Eingabematerialien
Text zu Video · Ein schriftlicher Prompt. · Erforderlich: model, prompt, duration
Geben Sie prompt als Text und duration in ganzen Sekunden an. Wählen Sie eine unterstützte Auflösung; ergänzen Sie ein Seitenverhältnis oder verwenden Sie eine aufgeführte Größe.
model: Typ: string · kwaivgi/kling-v3.0-pro
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja
Bild zu Video · Ein schriftlicher Prompt und ein Bild für den ersten Frame. · Erforderlich: model, prompt, duration, frame_images
frame_images ist ein Array. Jedes Frame-Objekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame und optional last_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Geben Sie für jeden Frame eine öffentliche HTTPS-Bild-URL an. Wählen Sie eine unterstützte Auflösung; ergänzen Sie ein Seitenverhältnis oder verwenden Sie eine aufgeführte Größe.
Exakte Schlüssel: type, image_url, frame_type
model: Typ: string · kwaivgi/kling-v3.0-pro
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt, duration |
Parametermaterial_types | Vertragtext, image |
Parameteradditional_properties | Vertragfalse |
Parameteroptional_controls | Vertragresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
Lebenszyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebührenkomponente | Referenzauflösung | Referenzmodus | Referenzaudio | Abrechnungseinheit | Abrechnungsbedingungen | Gebühr |
|---|---|---|---|---|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebührenkomponente— | Referenzauflösung— | Referenzmodus— | Referenzaudio— | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationVideoausgabe · Referenzpreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponentereference_output_rate | Referenzauflösung— | Referenzmodus— | Referenzaudio— | Abrechnungseinheitpro Ausgabesekunde | Abrechnungsbedingungen— | Gebühr Ausgabe · Referenzpreis pro Sekunde des Ausgabevideos · Schätzung nur zum Vergleich $0.224 pro Ausgabesekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponente— | Referenzauflösung— | Referenzmodus— | Referenzaudio— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenAudio: with_audio | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.336 pro Videosekunde |
| KonfigurationBild zu Video (Frame-Bilder) · 1080p · Referenzpreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponentereference_output_rate | Referenzauflösung1080p | ReferenzmodusBild zu Video (Einzelbilder) | ReferenzaudioOhne Audio | Abrechnungseinheitpro Ausgabesekunde | Abrechnungsbedingungen— | Gebühr Ausgabe · Referenzpreis pro Sekunde des Ausgabevideos · Schätzung nur zum Vergleich $0.224 pro Ausgabesekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponente— | Referenzauflösung— | Referenzmodus— | Referenzaudio— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenGenerierungsmodus: image_to_video; Auflösung: 720p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.224 pro Videosekunde |
| KonfigurationText zu Video · 1080p · Referenzpreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponentereference_output_rate | Referenzauflösung1080p | ReferenzmodusText zu Video | ReferenzaudioOhne Audio | Abrechnungseinheitpro Ausgabesekunde | Abrechnungsbedingungen— | Gebühr Ausgabe · Referenzpreis pro Sekunde des Ausgabevideos · Schätzung nur zum Vergleich $0.224 pro Ausgabesekunde |
| KonfigurationText zu Video · 480p · Referenzpreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponentereference_output_rate | Referenzauflösung480p | ReferenzmodusText zu Video | ReferenzaudioOhne Audio | Abrechnungseinheitpro Ausgabesekunde | Abrechnungsbedingungen— | Gebühr Ausgabe · Referenzpreis pro Sekunde des Ausgabevideos · Schätzung nur zum Vergleich $0.224 pro Ausgabesekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponente— | Referenzauflösung— | Referenzmodus— | Referenzaudio— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenGenerierungsmodus: text_to_video; Auflösung: 720p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.224 pro Videosekunde |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebührenkomponente— | Referenzauflösung— | Referenzmodus— | Referenzaudio— | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.672 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Details zum Referenztarif
Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.
Preisreferenzen für Videokonfigurationen
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationVideopreis | AbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben. | Gebühr Ausgabe · Videopreis $0.224 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenAudio: with_audio | Gebühr Ausgabe · Videopreis $0.336 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenGenerierungsmodus: text_to_video; Auflösung: 480p | Gebühr Ausgabe · Videopreis $0.224 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenGenerierungsmodus: text_to_video; Auflösung: 720p | Gebühr Ausgabe · Videopreis $0.224 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenGenerierungsmodus: image_to_video; Auflösung: 720p | Gebühr Ausgabe · Videopreis $0.224 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenGenerierungsmodus: text_to_video; Auflösung: 1080p | Gebühr Ausgabe · Videopreis $0.224 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenGenerierungsmodus: image_to_video; Auflösung: 1080p | Gebühr Ausgabe · Videopreis $0.224 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
Beispielanfragen
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"kwaivgi/kling-v3.0-pro","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Video
Signierte Inhalts-URLs der Ihnen zugeordneten Assets
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Auftragsstatus prüfen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.
Wenn die ursprüngliche Antwort geprüft werden muss
503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen
Antwortfelder
| Feld | Typ | Bedeutung |
|---|---|---|
Feldindex | Typinteger | BedeutungBei null beginnende Position dieses Videos in der Ausgabeliste. |
Feldcontent_url | Typstring | BedeutungSignierte HTTPS-Download-URL für dieses fertiggestellte Video. |
Feldsha256 | Typstring | null | BedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar. |
Feldsize_bytes | Typinteger | null | BedeutungGröße der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar. |
Feldduration_ms | Typinteger | null | BedeutungGemessene Videodauer in Millisekunden; null, falls nicht verfügbar. |
Feldwidth | Typinteger | null | BedeutungVideobreite in Pixeln; null, falls nicht verfügbar. |
Feldheight | Typinteger | null | BedeutungVideohöhe in Pixeln; null, falls nicht verfügbar. |
Feldvideo_codec | Typstring | null | BedeutungVideocodec-Kennung; null, falls nicht aufgezeichnet. |
Feldhas_audio | Typboolean | null | BedeutungGibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen. |
Feldaudio_codec | Typstring | null | BedeutungAudiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde. |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort404 · not_found_error | BedingungDer Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden. | Nächster SchrittPrüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel. |
Antwort401 · authentication_error | BedingungDer API-Schlüssel passt nicht zum authentifizierten Konto. | Nächster SchrittPrüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff. |
Antwort400 · invalid_request_error | BedingungDie Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig. | Nächster SchrittKorrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat. |
Antwort422 · price_unavailable | BedingungFür die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen. | Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden. |
Antwort422 · invalid_request_error | BedingungEine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig. | Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel. |
Antwort402 · billing_error | BedingungDas verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu. | Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden. |
Antwort503 · server_error | BedingungVideoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar. | Nächster SchrittWarten Sie, bis der Dienst verfügbar ist. Wenn Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung zu erstellen. |
Antwort503 · result_pending_check | BedingungDas ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden. | Nächster SchrittBewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage. |
Antwort503 · owned_result_unavailable | BedingungDer Download des vorhandenen Videos ist vorübergehend nicht verfügbar. | Nächster SchrittPrüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang. |
Antwort409 · video_not_ready | BedingungDer Videoinhalt wurde nicht veröffentlicht. | Nächster SchrittPrüfen Sie den Status der ursprünglichen Aufgabe. Laden Sie das Ergebnis herunter, sobald completed gemeldet wird; bei failed folgen Sie dem Hinweis zur Abrechnungsprüfung. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra kwaivgi/kling-v3.0-pro
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Kling: Video v3.0 Pro
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·kwaivgi/kling-v3.0-pro:text,image→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·kwaivgi/kling-v3.0-pro:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- Welche Grenzen gelten?
POST /v1/videos·kwaivgi/kling-v3.0-pro:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1