Kling: Video v3.0 Standard
Kling VIDEO 3.0 Standard ist Kuaishous 720p-Videoprofil für Text- und Bildbriefings. Erzeugen Sie Szenen von drei bis fünfzehn Sekunden mit nativem Audio, Motivreferenzen, Anfangs-/Endbildsteuerung 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 Erzeugung einer Videoszene aus Text oder einem bereitgestellten Bild. Es nutzt natives Audio, Motivreferenzen und Erzählung mit mehreren Einstellungen der VIDEO-3.0-Version bei flexibler Cliplänge von drei bis fünfzehn Sekunden. Dieses Profil ist für die Entwicklung einer visuellen Richtung, die Vorschau einer kurzen Erzählung oder eine kompakte Szene mit definierter Handlung und Ton nützlich.
Legen Sie für eine textgestützte Szene Motiv, Umgebung, Handlung, Beleuchtung und Kameraverhalten fest. Bereiten Sie für eine bildgestützte Szene ein Anfangsbild vor, das gewünschtes Aussehen und zu animierende Komposition klar zeigt. Ein eigenes Briefing könnte eine Figur neben einem Werkstatttisch zeigen und dann beschreiben, wie sie einen kleinen Gegenstand aufnimmt, während die Kamera näher an die Handlung fährt. Trennen Sie im Wortlaut Motivbewegung und Kamerabewegung.
Generierung mehrerer Einstellungen kann deren Kameraansichten automatisch aus der Szenenbeschreibung planen. Benutzerdefinierte Regie mehrerer Einstellungen weist dagegen Inhalt und Dauer einzelnen Einstellungen zu. Das benutzerdefinierte Einstellungsprofil des Herstellers akzeptiert ein 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. Wenn eine durchgehende Ansicht die Szene klar vermittelt, vermeidet ein Briefing für eine Einstellung einen unnötigen Übergang.
Ein kurzes Storyboard kann mit einer Umgebungsansicht beginnen, zur Handlung übergehen und auf dem Detail enden, das das Ergebnis erklärt. Geben Sie an, welches Motiv in jeder Einstellung bleibt und wie der Bildausschnitt wechselt. Der automatische Modus kann die Kameraansichten an die Szene anpassen; eine benutzerdefinierte Folge gibt dagegen ausdrückliche Anweisungen für ihre einzelnen Teile. Ein gewöhnlicher einzelner Prompt akzeptiert laut Herstellerreferenz bis zu 2.500 Zeichen.
Motivreferenz-Steuerung hilft, Figuren, Gegenstände und eine Umgebung zu verankern. Verwenden Sie klares Referenzmaterial und geben Sie jedem Motiv eine stabile Beschreibung. Das dokumentierte bildgestützte Profil erlaubt bis zu drei vorbereitete Elemente. Für eine illustrierte Produktszene kann eine Referenz das Objekt festlegen, während die Eröffnungskomposition seinen Ort bestimmt; das Bewegungsbriefing beschreibt anschließend das Ereignis darum herum. Prüfen Sie das fertige Aussehen über die Einstellung hinweg, statt anzunehmen, dass die Referenz jede Änderung verhindert.
Anfangs- und Endbilder können einen bildgesteuerten Übergang zu einer gewünschten Abschlusskomposition führen. Verwenden Sie Bilder, die eine plausible Verbindung vermitteln, und beschreiben Sie die Handlung dazwischen. Das Bildprofil des Herstellers akzeptiert JPG, JPEG und PNG mit höchstens 10 MB und Abmessungen von mindestens 300 Pixeln; das Seitenverhältnis des Anfangsbildes muss zwischen 1:2.5 und 2.5:1 liegen. Bereiten Sie das Bildmaterial für diese Aufgabe vor, statt eine Storyboardbeschreibung als austauschbares Eingabepaket zu behandeln.
Das Standardprofil kann natives Audio erzeugen, wenn dieser Modus aktiviert ist; in der Herstellerreferenz ist Audio standardmäßig ausgeschaltet. Beschreiben Sie gesprochene Zeilen, Atmosphäre und zugehörige Klänge als Teil der Szene. VIDEO 3.0 unterstützt Sprachausgabe auf Chinesisch, Englisch, Japanisch, Koreanisch und Spanisch, einschließlich Code-Switching und unterstützter Akzente oder Dialekte. Laut Herstellerleitfaden wird in einer anderen Sprache eingegebener Dialog ins Englische übersetzt. Machen Sie in einer Szene mit mehreren Figuren den sprechenden Akteur klar und halten Sie den Wortlaut kurz genug für die gewünschte Darbietung.
Ein eigenes Dialogbriefing kann Speaker A eine Zeile, Speaker B eine sichtbare Reaktion und dem Austausch einen Blickwinkelwechsel zuweisen. Beschreiben Sie den Umgebungston separat vom Dialog, damit ein Hintergrundeffekt nicht zur mehrdeutigen Sprechregie wird. Verwenden Sie Referenzmaterial für das Aussehen der Motive und Text dafür, was sie tun und sagen.
Sichtbare Beschriftung ist ein weiterer Teil des 3.0-Workflows. Ein Quellbild kann ein Schild, eine Bildunterschrift oder ein Produktetikett enthalten, dessen Erscheinung bei der Animation wichtig ist. Benennen Sie diesen Text und seine Rolle in der Szene und prüfen Sie anschließend Rechtschreibung, Lesbarkeit und Stabilität im Ergebnis. Halten Sie bei einer kurzen Kampagnendarstellung die wichtige Aussage prominent in der Komposition, statt sich auf ein sehr kleines Hintergrundetikett zu verlassen.
Standardausgabe ist 720p. Pro ist das separat gewählte 1080p-Profil; natives 4K ist ein weiterer Herstellermodus und keine automatische Standardeinstellung. Textgestützte Seitenverhältnisoptionen umfassen 16:9, 9:16 und 1:1. Wählen Sie Format und Bildausschnitt für die vorgesehene Platzierung und bewahren Sie diese visuelle Richtung beim Vergleich von Änderungen an Handlung, Licht oder Einstellungsreihenfolge.
Eine fertige Generierung liefert ein Video mit seiner tatsächlichen Dauer. Laut Ergebnisdokumentation des Herstellers werden generierte Videos nach 30 Tagen gelöscht; speichern Sie den fertigen Clip deshalb zeitnah. Bewahren Sie Szenenbriefing, Referenzbilder und gewähltes Profil beim Clip auf, damit spätere Überarbeitungen einen konsistenten Ausgangspunkt haben. Prüfen Sie visuelle Handlung, Motivkontinuität, Kameraansichten, Dialog und Beschriftung im vorgesehenen Verwendungskontext. Eine gezielte Korrektur des fehlerhaften Details ist nützlicher als der Austausch des gesamten Szenenbriefings durch unzusammenhängende Anweisungen.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-v3.0-std
kwaivgi/kling-v3.0-stdStart
Kling VIDEO 3.0 Standard ist Kuaishous 720p-Videoprofil für Text- und Bildbriefings. Erzeugen Sie Szenen von drei bis fünfzehn Sekunden mit nativem Audio, Motivreferenzen, Anfangs-/Endbildsteuerung 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
- 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-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 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-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 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-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 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.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 · 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.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 · 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.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 · 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 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-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