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, Anfangs- und Endbildvorgaben und Erzählungen 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 Erzeugung einer Videoszene aus Text oder einem bereitgestellten Bild. Es nutzt den nativen Ton, Motivreferenzen und das Erzählen in mehreren Einstellungen der Ausgabe VIDEO 3.0 bei flexiblen Cliplängen von drei bis fünfzehn Sekunden. Dieses Profil eignet sich zur Entwicklung einer Bildrichtung, zur Vorschau einer kurzen Erzählung oder für eine kompakte Szene mit festgelegter 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 Anfangsbild vor, das Aussehen und Komposition der gewünschten Animation klar zeigt. Ein eigenes Briefing könnte eine Figur neben einem Werkstatttisch zeigen und beschreiben, wie sie einen kleinen Gegenstand aufnimmt, während die Kamera näher an die Handlung fährt. Trennen Sie in der Formulierung die Bewegung des Motivs von der Kamerabewegung.
Die Generierung mehrerer Einstellungen kann die Kamerabdeckung automatisch anhand der Szenenbeschreibung planen. Eine eigene Mehrfach-Einstellungsfolge weist hingegen einzelnen Einstellungen Inhalt und Dauer zu. Das benutzerdefinierte Einstellungsprofil des Herstellers akzeptiert eine bis sechs Einstellungen mit höchstens 512 Zeichen und mindestens einer Sekunde je Einstellung. Ihre Dauern müssen zusammen der gesamten Cliplänge entsprechen. 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 Umgebungsansicht beginnen, zur Handlung wechseln und mit einem 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 Abdeckung an die Szene anpassen; eine eigene Folge gibt ausdrückliche Anweisungen für die einzelnen Teile. Ein normaler Einzelprompt akzeptiert laut Herstellerreferenz bis zu 2.500 Zeichen.
Motivreferenzsteuerungen helfen, Figuren, Gegenstände und eine Umgebung zu verankern. Verwenden Sie klares Referenzmaterial und beschreiben Sie jedes Motiv konsistent. Das dokumentierte bildgestützte Profil erlaubt bis zu drei vorbereitete Elemente. In einer illustrierten Produktszene kann eine Referenz den Gegenstand festlegen, während die Anfangskomposition seinen Ort bestimmt; die Bewegungsbeschreibung erklärt dann das Geschehen darum herum. Prüfen Sie das Aussehen im gesamten fertigen Clip, statt anzunehmen, die Referenz verhindere jede Änderung.
Anfangs- und Endbilder können einen bildgesteuerten Übergang zur gewünschten Schlusskomposition führen. Verwenden Sie Bilder mit einer plausiblen 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 Anfangsbildes muss zwischen 1:2,5 und 2,5:1 liegen. Bereiten Sie die Bilder für diese Aufgabe vor, statt eine Storyboardbeschreibung als austauschbares Eingabepaket zu behandeln.
Das Standardprofil kann nativen Ton generieren, wenn dieser Modus aktiviert ist; in der Herstellerreferenz ist Ton standardmäßig ausgeschaltet. 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 Sprache, einschließlich Sprachwechsel sowie unterstützter Akzente oder Dialekte. Laut Herstellerleitfaden wird Dialog in einer anderen Sprache ins Englische übersetzt. Machen Sie bei mehreren Figuren klar, wer spricht, und halten Sie die Sätze kurz genug für die vorgesehene Darstellung.
Ein eigenes Dialogbriefing kann Sprecher A einen Satz, Sprecher B eine sichtbare Reaktion und einen dem Austausch folgenden Perspektivwechsel zuweisen. Beschreiben Sie Umgebungsgeräusche getrennt vom Dialog, damit ein Hintergrundeffekt nicht zu einer mehrdeutigen Sprachanweisung wird. Referenzen legen das Aussehen der Motive fest; der Text bestimmt ihre Handlungen und Worte.
Sichtbare Beschriftung ist ein weiterer Teil des 3.0-Ablaufs. Ein Ausgangsbild kann ein Schild, eine Bildunterschrift oder ein Produktetikett enthalten, dessen Aussehen während der Animation wichtig ist. Benennen Sie diesen Text und seine Rolle und prüfen Sie danach Schreibweise, Lesbarkeit und Stabilität. Halten Sie bei einem kurzen Kampagnenmotiv die wichtige Botschaft in der Komposition deutlich sichtbar, statt sich auf eine sehr kleine Hintergrundbeschriftung zu verlassen.
Die Standardausgabe ist 720p. Pro ist das separat gewählte 1080p-Profil; natives 4K ist ein weiterer Herstellermodus und keine automatische Standardeinstellung. Textgestützte Seitenverhältnisse umfassen 16:9, 9:16 und 1:1. Wählen Sie Format und Bildausschnitt für den vorgesehenen Einsatz und behalten Sie diese Bildrichtung beim Vergleich von Änderungen an Handlung, Licht oder Einstellungsreihenfolge bei.
Eine abgeschlossene Generierung liefert ein Video mit seiner tatsächlichen Dauer. Laut Ergebnisdokumentation des Herstellers werden generierte Videos nach 30 Tagen gelöscht; sichern Sie den fertigen Clip daher umgehend. Bewahren Sie Szenenbriefing, Referenzbilder und gewähltes Profil mit dem Clip auf, damit spätere Überarbeitungen einen einheitlichen Ausgangspunkt haben. Prüfen Sie Bildhandlung, Motivkontinuität, Kamerabdeckung, Dialog und Beschriftung im vorgesehenen Verwendungskontext. Eine gezielte Korrektur des fehlerhaften Details hilft mehr, als das gesamte Szenenbriefing durch unzusammenhängende Anweisungen zu ersetzen.
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, Anfangs- und Endbildvorgaben und Erzählungen 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 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 kommt höchstens einmal vor. Exakte Schlüssel: type, image_url, frame_type Bedingungen: Diese Schlüssel beschreiben jedes Frame-Objekt; image_url enthält nur 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-std
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 des ersten Frames. · 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 mit optionalem last_frame. Jede Frame-Rolle kommt höchstens einmal vor. 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-std
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 Tokens | 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 · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationVideoausgabe · Referenztarif | 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.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 (Frame-Bilder) · 1080p · Referenztarif | 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.168 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.168 pro Videosekunde |
| KonfigurationText zu Video · 1080p · Referenztarif | 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.168 pro Ausgabesekunde |
| KonfigurationText zu Video · 480p · Referenztarif | 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.168 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.168 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.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 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.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 | AbrechnungsbedingungenGenerierungsmodus: 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 | AbrechnungsbedingungenGenerierungsmodus: 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 | AbrechnungsbedingungenGenerierungsmodus: 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 | AbrechnungsbedingungenGenerierungsmodus: 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 | AbrechnungsbedingungenGenerierungsmodus: 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 deren zurückgegebene gemessene 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 | BedeutungNullbasierte 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 erfasst. |
Feldhas_audio | Typboolean | null | BedeutungOb das Video eine Audiospur enthält; null, falls nicht gemessen. |
Feldaudio_codec | Typstring | null | BedeutungAudiocodec-Kennung; null, wenn keine Kennung erfasst 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 vorhandenen 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 Ihren API-Schlüssel und Ihren Kontozugriff vor der Übermittlung. |
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 | BedingungDie ausgewählte Videokonfiguration kann nicht bepreist werden. | Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und vervollständigen Sie deren Pflichtoptionen, bevor Sie eine korrigierte Anfrage übermitteln. |
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 Ihre fertiggestellte ursprüngliche öffentliche Video-ID mit demselben API-Schlüssel. |
Antwort402 · billing_error | BedingungDas verfügbare Guthaben oder die Limits erlauben keine Reservierung. | Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden. |
Antwort503 · server_error | BedingungVideoprüfung, Speicher oder Dienstzugriff ist vorübergehend nicht verfügbar. | Nächster SchrittWarten Sie auf die Verfügbarkeit des Dienstes. Falls Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung anzulegen. |
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 Ersatzanfrage zur Generierung. |
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 deren 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 ursprünglichen Aufgabenstatus. Laden Sie die Ausgabe nach der Meldung completed herunter; folgen Sie bei failed dem Hinweis zur Abrechnungsprüfung. |
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