Kling: Video v3.0 Standard
Kling VIDEO 3.0 Standard ist Kuaishous 720p-Videoprofil für Text- und Bildbriefings. Erstellen Sie Szenen von drei bis fünfzehn Sekunden mit nativem Ton, Motivreferenzen, Start-/Endbildvorgaben und Erzählung in einer oder mehreren Einstellungen.
Ü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 Standard ist Kuaishous 720p-Profil zur Generierung einer Videoszene aus Text oder einem bereitgestellten Bild. Es nutzt nativen Ton, Motivreferenzen und Erzählen in mehreren Einstellungen der Edition VIDEO 3.0 bei flexibler Cliplänge von drei bis fünfzehn Sekunden. Das Profil eignet sich zum Entwickeln einer visuellen Richtung, zur Vorschau einer kurzen Erzählung oder für eine kompakte Szene mit definierter Handlung und Ton.
Legen Sie bei einer textgestützten Szene Motiv, Umgebung, Handlung, Licht und Kameraverhalten fest. Bereiten Sie bei einer bildgestützten Szene ein Eröffnungsbild vor, das Erscheinung und Komposition der geplanten Animation klar zeigt. Ein eigenes Briefing könnte eine Figur neben einem Werkstatttisch zeigen und dann beschreiben, wie sie ein kleines Objekt aufnimmt, während die Kamera näher an die Handlung fährt. Trennen Sie sprachlich die Bewegung des Motivs von der Kamerabewegung.
Die Generierung mehrerer Einstellungen kann die Auflösung der Szene automatisch aus der Beschreibung planen. Individuelle Vorgaben für mehrere Einstellungen weisen stattdessen jeder Einstellung Inhalt und Dauer zu. Das Herstellerprofil für individuelle Einstellungen akzeptiert eine bis sechs Einstellungen mit höchstens 512 Zeichen pro Einstellung und mindestens einer Sekunde je Einstellung. Die Einstellungsdauern müssen zusammen die gesamte Cliplänge ergeben. Vermittelt eine durchgehende Ansicht die Szene klar, vermeidet ein Briefing für eine einzelne Einstellung einen unnötigen Übergang.
Ein kurzes Storyboard kann mit einer Ansicht der Umgebung beginnen, zur Handlung wechseln und mit dem Detail enden, das das Ergebnis erklärt. Geben Sie an, welches Motiv in jeder Einstellung bleibt und wie sich der Bildausschnitt ändert. Der automatische Modus kann die Auflösung an die Szene anpassen; eine individuelle Abfolge liefert ausdrückliche Vorgaben für die einzelnen Teile. Ein gewöhnlicher einzelner Prompt akzeptiert laut Herstellerreferenz bis zu 2’500 Zeichen.
Motivreferenzsteuerungen helfen, Figuren, Objekte und eine Umgebung zu verankern. Verwenden Sie klares Referenzmaterial und eine stabile Beschreibung für jedes Motiv. Das dokumentierte bildgestützte Profil erlaubt bis zu drei vorbereitete Elemente. Bei einer illustrierten Produktszene kann eine Referenz das Objekt festlegen, während die Eröffnungskomposition seine Platzierung bestimmt; das Bewegungsbriefing beschreibt anschliessend das Ereignis darum herum. Prüfen Sie das fertige Erscheinungsbild über die ganze Einstellung, statt anzunehmen, die Referenz verhindere jede Änderung.
Start- und Endbilder können einen bildbedingten Übergang zu einer gewünschten Schlusskomposition führen. Verwenden Sie Bilder mit plausibler Verbindung und beschreiben Sie die Handlung dazwischen. Das Bildprofil des Herstellers akzeptiert JPG, JPEG und PNG bis 10 MB mit Abmessungen von mindestens 300 Pixeln; das Seitenverhältnis des Startbildes muss zwischen 1:2.5 und 2.5:1 liegen. Bereiten Sie das Einzelbildmaterial für diese Aufgabe vor, statt eine Storyboardbeschreibung als austauschbares Eingabepaket zu behandeln.
Das Standardprofil kann nativen Ton erzeugen, wenn dieser Modus eingeschaltet ist; die Herstellerreferenz setzt Ton standardmässig auf aus. Beschreiben Sie gesprochene Sätze, Atmosphäre und relevante Geräusche als Teil der Szene. VIDEO 3.0 unterstützt chinesische, englische, japanische, koreanische und spanische Sprachausgestaltung, einschliesslich Sprachwechseln sowie unterstützten Akzenten oder Dialekten. Laut Herstellerleitfaden wird Dialog in einer anderen Sprache ins Englische übersetzt. Machen Sie bei mehreren Figuren die sprechende Figur eindeutig und halten Sie den Text kurz genug für die vorgesehene Darbietung.
Ein eigenes Dialogbriefing kann Sprecher A einen Satz, Sprecher B eine sichtbare Reaktion und dem Austausch einen Blickwinkelwechsel zuweisen. Beschreiben Sie den Umgebungston getrennt vom Dialog, damit ein Hintergrundeffekt nicht zu einer mehrdeutigen Sprachanweisung wird. Nutzen Sie Referenzmaterial für die Erscheinung der Motive und Text dafür, was sie tun und sagen.
Sichtbare Schrift ist ein weiterer Bestandteil des 3.0-Ablaufs. Ein Quellbild kann ein Schild, einen Untertitel oder ein Produktetikett enthalten, dessen Aussehen während der Animation wichtig ist. Benennen Sie diese Schrift und ihre Rolle in der Szene und prüfen Sie das Ergebnis auf Schreibweise, Lesbarkeit und Stabilität. Halten Sie bei einem kurzen Kampagnenvisual die wichtige Botschaft in der Komposition deutlich sichtbar, statt sich auf ein winziges Hintergrundetikett zu verlassen.
Standard liefert 720p. Pro ist das separat gewählte 1080p-Profil; natives 4K ist ein weiterer Herstellermodus und keine automatische Standardeinstellung. Die Seitenverhältnisse für textgestützte Generierung umfassen 16:9, 9:16 und 1:1. Wählen Sie Format und Bildausschnitt für die gewünschte Platzierung und behalten Sie diese visuelle Richtung beim Vergleichen von Handlungs-, Licht- oder Einstellungsänderungen bei.
Eine abgeschlossene Generierung liefert eine Videodatei mit ihrer tatsächlichen Dauer. Laut Ergebnisdokumentation des Herstellers werden generierte Videos nach 30 Tagen gelöscht; speichern Sie den fertigen Clip daher zeitnah. Bewahren Sie Szenenbriefing, Referenzbilder und gewähltes Profil zusammen mit dem Clip auf, damit spätere Überarbeitungen einen konsistenten Ausgangspunkt haben. Prüfen Sie sichtbare Handlung, Motivkontinuität, szenische Auflösung, Dialog und Schrift im vorgesehenen Einsatzkontext. Eine gezielte Korrektur des fehlgeschlagenen Details ist nützlicher als der Austausch des gesamten Szenenbriefings gegen unzusammenhängende Anweisungen.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-v3.0-std
kwaivgi/kling-v3.0-stdEinstieg
Kling VIDEO 3.0 Standard ist Kuaishous 720p-Videoprofil für Text- und Bildbriefings. Erstellen Sie Szenen von drei bis fünfzehn Sekunden mit nativem Ton, Motivreferenzen, Start-/Endbildvorgaben und Erzählung in einer oder mehreren Einstellungen.
- 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-std | 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-std
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-std
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.168 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.252 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.168 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.168 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.168 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.168 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.168 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.504 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.168 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.252 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.168 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.168 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.168 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.168 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.168 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-std","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-std
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Kling: Video v3.0 Standard
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·kwaivgi/kling-v3.0-std:text,image→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·kwaivgi/kling-v3.0-std: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-std:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1