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 Modell VIDEO 3.0. Sein dokumentierter Pro-Modus erzeugt 1080p-Video aus einem Textbriefing oder einer bildgestützten Szene mit Clips von drei bis fünfzehn Sekunden. Die Edition 3.0 verbindet nativen Ton, Steuerungen für Motivkonsistenz und Regie über mehrere Einstellungen und bietet einer kurzen Produktion klare Vorgaben zu Erscheinung, Handlung, szenischer Auflösung und Ton.
Beginnen Sie mit der Haupthandlung der Szene. Beschreiben Sie bei einer textgestützten Einstellung Motiv, Umgebung, Licht und den Blickwinkel, der die Handlung verständlich macht. Lassen Sie bei einer bildgestützten Einstellung das Eröffnungsbild Erscheinung und Komposition festlegen und verwenden Sie den Text für die zeitliche Veränderung. 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 über mehrere Einstellungen bietet automatische Auflösung oder eine individuelle Abfolge. Die automatische Generierung mehrerer Einstellungen plant aus dem Briefing Wechsel von Bildausschnitt und Kamerawinkel; eine Szene, die in eine durchgehende Ansicht passt, kann dennoch eine einzelne Einstellung bleiben. Mit einem individuellen Storyboard bestimmen Sie Inhalt und Dauer jeder Einstellung. Das Herstellerprofil für individuelle Einstellungen erlaubt eine bis sechs Einstellungen mit höchstens 512 Zeichen pro Einstellung 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ührung in die Umgebung, die Haupthandlung und ein abschliessendes Detail als separate Einstellungen. Nennen Sie jeweils Kameragestaltung und das, worauf das Publikum achten soll. Halten Sie die Erscheinung eines wiederkehrenden Motivs im Briefing konsistent und ändern Sie Handlung und Auflösung bewusst. Das Feld für einen einzelnen Prompt in der Herstellerreferenz akzeptiert bis zu 2’500 Zeichen; eine individuelle Abfolge verwendet ihre separaten Einstellungsbeschreibungen.
Motivreferenzen können eine bildgestützte Szene unterstützen, wenn Figur, Produkt oder Umgebung erkennbar bleiben sollen. Wählen Sie klare Ansichten der beizubehaltenden Merkmale und benennen Sie jedes referenzierte Motiv konsistent. Das dokumentierte bildgestützte Profil erlaubt bis zu drei vorbereitete Elemente. Halten Sie Referenzrollen fokussiert, statt mehrere Materialien mit widersprüchlichen Erscheinungsvorgaben zu kombinieren.
Start- und Endbilder bilden visuelle Grenzen für einen bildbedingten Übergang. Bereiten Sie Bilder vor, die bei Motiv und vorgesehener Szene übereinstimmen, und beschreiben Sie die verbindende Bewegung. Die unterstützte Einzelbildeingabe des Herstellers verwendet JPG-, JPEG- oder PNG-Bilder bis 10 MB mit Abmessungen von mindestens 300 Pixeln und einem Startbild-Seitenverhältnis zwischen 1:2.5 und 2.5:1. Eine einzelbildgesteuerte Aufgabe und ein individuelles Storyboard haben ihre eigene Eingabebehandlung; ordnen Sie daher das Material für den gewählten Ablauf, bevor Sie das vollständige Briefing schreiben.
Nativer Ton kann gesprochene Sätze, Atmosphäre und sichtbare Darbietung verbinden. Ton ist in der Herstellerreferenz standardmässig ausgeschaltet und wird für eine audiovisuelle Szene aktiviert. Das Sprachprofil von 3.0 umfasst Chinesisch, Englisch, Japanisch, Koreanisch und Spanisch sowie Sprachwechsel und unterstützte Dialekte oder Akzente. Laut Herstellerleitfaden wird Dialog in einer anderen Sprache ins Englische übersetzt. Weisen Sie jeden Satz dem vorgesehenen Motiv zu und trennen Sie Dialog und Hintergrundton, damit das Audiobriefing erklärt, wer spricht und was die Handlung umgibt.
Ein eigenes Briefing mit zwei Figuren kann Sprecher A und Sprecher B benennen, jedem einen kurzen Satz geben und die sichtbare Reaktion dazwischen beschreiben. Passen Sie den Dialog an die Cliplänge an und identifizieren Sie den Sprecher beim Ansichtswechsel. Stimmregie und Figurenreferenz erfüllen verschiedene Aufgaben; das Briefing sollte die gewünschte Darbietung nennen, statt anzunehmen, ein Referenzbild enthalte die zu sprechenden Wörter.
VIDEO 3.0 verbessert ausserdem den Umgang mit sichtbarer Schrift in bildgestützten Szenen. Wenn ein Schild, ein Etikett oder ein Untertitel wichtig ist, benennen Sie das Textelement im Briefing und bewahren Sie sein Aussehen aus der Referenz. Prüfen Sie im fertigen Clip Schreibweise, Lesbarkeit und Bewegung der Schrift, besonders wenn sie eine Produkt- oder Kampagnenbotschaft trägt. Die Schriftfunktion eines Modells leitet die Generierung an und ersetzt keine abschliessende Sichtprüfung.
Das Pro-Profil liefert 1080p; das Standardprofil 720p. Der separat gewählte 4K-Modus des Herstellers ist ein weiteres Ausgabeprofil; Pro ist daher kein Synonym für jede höher aufgelöste Einstellung. Für textgestützte Generierung umfassen die dokumentierten Bildformate 16:9, 9:16 und 1:1. Wählen Sie den Bildrahmen passend zur vorgesehenen Platzierung und halten Sie die Komposition darin verständlich.
Die Generierung läuft als Auftrag, dessen erfolgreiches Ergebnis die fertige Videodatei und tatsächliche Dauer bereitstellt. Laut Ergebnisdokumentation des Herstellers werden generierte Videos nach 30 Tagen gelöscht; speichern Sie den fertigen Clip daher zeitnah. Bewahren Sie Video, Briefing und Referenzmaterial auf und prüfen Sie Motivkontinuität, gewünschte Einstellungsreihenfolge, Kamerabewegung, Dialog und Schrift. Nutzen Sie den gewählten Clip als filmisches Konzept, Produktszene oder kurze Erzählung und überarbeiten Sie gezielt den Teil, der das beabsichtigte Ergebnis verfehlt hat.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-v3.0-pro
kwaivgi/kling-v3.0-proEinstieg
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
- Eingabe
text,image- Ausgabe
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 zu wä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 Bildobjekten. 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 Bildrolle darf höchstens einmal vorkommen. Exakte Schlüssel: type, image_url, frame_type Bedingungen: Diese Schlüssel beschreiben jedes Bildobjekt; image_url enthält ausschliesslich 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 · Eine schriftliche Beschreibung. · 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össe.
model: Typ: string · kwaivgi/kling-v3.0-pro
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10'000 · Mindestens ein Zeichen ausser Leerraum erforderlich: Ja
Bild zu Video · Eine schriftliche Beschreibung und ein Bild für das erste Einzelbild. · Erforderlich: model, prompt, duration, frame_images
frame_images ist ein Array. Jedes Bildobjekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame mit einem optionalen last_frame. Jede Bildrolle darf höchstens einmal vorkommen. Geben Sie für jedes Bild 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össe.
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 ausser 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 |
|---|---|---|---|---|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebührenkomponente— | Referenzauflösung— | Referenzmodus— | Referenzaudio— | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationVideoausgabe · Referenzpreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponentereference_output_rate | Referenzauflösung— | Referenzmodus— | Referenzaudio— | Abrechnungseinheitpro Ausgabesekunde | Abrechnungsbedingungen— | Gebühr Ausgabe · Referenztarif pro Ausgabevideo-Sekunde · 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 (Einzelbilder) · 1080p · Referenzpreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponentereference_output_rate | Referenzauflösung1080p | ReferenzmodusBild zu Video (Einzelbilder) | ReferenzaudioOhne Audio | Abrechnungseinheitpro Ausgabesekunde | Abrechnungsbedingungen— | Gebühr Ausgabe · Referenztarif pro Ausgabevideo-Sekunde · Schätzung nur zum Vergleich $0.224 pro Ausgabesekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponente— | Referenzauflösung— | Referenzmodus— | Referenzaudio— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenErzeugungsmodus: 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 · Referenztarif pro Ausgabevideo-Sekunde · 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 · Referenztarif pro Ausgabevideo-Sekunde · Schätzung nur zum Vergleich $0.224 pro Ausgabesekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponente— | Referenzauflösung— | Referenzmodus— | Referenzaudio— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenErzeugungsmodus: text_to_video; Auflösung: 720p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.224 pro Videosekunde |
| KonfigurationGeschätzte Erzeugungskosten | 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 abschliessenden 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 | AbrechnungsbedingungenErzeugungsmodus: 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 | AbrechnungsbedingungenErzeugungsmodus: 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 | AbrechnungsbedingungenErzeugungsmodus: 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 | AbrechnungsbedingungenErzeugungsmodus: 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 | AbrechnungsbedingungenErzeugungsmodus: 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 Ausgaben
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ächliche, Ihnen zugeordnete Ausgabe und die 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-URL zum Herunterladen dieses fertiggestellten Videos. |
Feldsha256 | Typstring | null | BedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar. |
Feldsize_bytes | Typinteger | null | BedeutungGrösse 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 | BedeutungKennung des Videocodecs; 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 | BedeutungKennung des Audiocodecs; 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 bei einem bestehenden Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel. |
Antwort401 · authentication_error | BedingungDer API-Schlüssel stimmt nicht mit dem authentifizierten Konto überein. | Nächster SchrittPrüfen Sie vor dem Einreichen 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 Anfragetext. 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 ermitteln. | Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage einreichen. |
Antwort422 · invalid_request_error | BedingungEine Videoeingabe oder eine ursprüngliche Fortsetzungsaufgabe ist ungültig. | Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die ursprüngliche öffentliche Video-ID Ihres fertiggestellten Videos mit demselben API-Schlüssel. |
Antwort402 · billing_error | BedingungDas verfügbare Guthaben oder die geltenden Limiten erlauben keine Reservierung. | Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limiten, bevor Sie eine neue Anfrage senden. |
Antwort503 · server_error | BedingungVideoprüfung, Speicher oder Dienstzugriff ist vorübergehend nicht verfügbar. | Nächster SchrittWarten Sie, bis der Dienst verfügbar ist. Falls Sie bereits eine Video-ID besitzen, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Erzeugung zu erstellen. |
Antwort503 · result_pending_check | BedingungDas ursprüngliche Videoergebnis und die Abbuchung 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 Erzeugungsanfrage. |
Antwort503 · owned_result_unavailable | BedingungDer Download des bestehenden Videos ist vorübergehend nicht verfügbar. | Nächster SchrittPrüfen Sie später dieselbe Videoaufgabe und laden Sie deren bestehende Ausgabe herunter. Eine neue Erzeugung erstellt einen separaten Vorgang. |
Antwort409 · video_not_ready | BedingungDer Videoinhalt wurde nicht veröffentlicht. | Nächster SchrittPrüfen Sie den ursprünglichen Aufgabenstatus. Laden Sie die Ausgabe herunter, nachdem completed gemeldet wird; bei failed befolgen Sie den Hinweis zur Prüfung der Abbuchung. |
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