Kling: Video O1
Kling VIDEO O1 er Kuaishous referansestyrte videomodell for å generere og redigere scener med tekst, bilder, motivelementer og et kildeklipp. Bruk genereringsprofilen på tre til ti sekunder til visuell kontinuitet, styrte bildeoverganger og målrettede endringer i eksisterende opptak.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Kling VIDEO O1 er Kuaishous samlede referansestyrte videomodell. Den kombinerer en tekstbeskrivelse med bilder, forberedte motivelementer eller en kildevideo for å veilede nye scener og målrettede endringer i eksisterende opptak. Hovedgrensesnittet er en visuell oppdragsbeskrivelse: identifiser referansematerialet, beskriv rollen og angi utseendet, handlingen eller omformingen du ønsker i den resulterende videoen.
En ny innstilling kan starte fra tekst, et åpningsbilde eller et sett visuelle referanser. Bruk et bilde til å etablere en karakter eller gjenstand og beskriv omgivelser, handling og synsvinkel med ord. Når flere referanser bidrar med ulike trekk, tildeler du rollene eksplisitt. En opprinnelig produktbeskrivelse kan hente gjenstanden fra ett bilde og miljøet fra et annet og deretter beskrive gjenstandens bevegelse i dette miljøet.
O1s prompt kan navngi bilder, elementer og videoer med bestemte referansemarkører, som <<<image_1>>> eller <<<video_1>>>. Hold markørene knyttet til den faktiske oppgitte ressursen og forklar hva som skal hentes fra den. Produsentens promptgrense er 2 500 tegn. En kort instruksjon som identifiserer motiv og endring er mer nyttig enn en samling urelaterte stiluttrykk.
Til bildebaserte referanser uten videoinndata er dokumentert samlet budsjett opptil sju referansebilder og flerbildeelementer. Med en referansevideo er bilde-/elementbudsjettet fire. Grensene gjelder bildebaserte elementer; andre elementtyper har separate kompatibilitetsregler. Velg materialet som gir nødvendig informasjon om utseende eller scene, i stedet for å fylle budsjettet med overflødige visninger.
Bildeinndata bruker JPG, JPEG eller PNG, levert som en tilgjengelig URL eller bildedata, med filer på opptil 10 MB, dimensjoner på minst 300 piksler og sideforhold mellom 1:2,5 og 2,5:1. Forbered tydelige motiver og behold viktige detaljer i beskjæringen. Hvis en karakter eller et produkt må forbli gjenkjennelig, angir du hvilke trekk som skal beholdes og undersøker dem gjennom hele det fullførte klippet.
Start- og sluttbilder betinger en overgang mellom visuelle grenser. Den dokumenterte O1-arbeidsflyten for grensebilder krever et startbilde når et sluttbilde oppgis og støtter ikke start-/sluttbildekontroll med mer enn to bilder i arrayet. Når begge grensebildene brukes, inngår ikke ekstra motivelementer i denne O1-konfigurasjonen. Hold en bildestyrt oppgave adskilt fra redigering av en oppgitt basisvideo.
En kildevideo kan ha to forskjellige roller. Som basisklipp er den opptaket som redigeres: styr en bestemt tilføyelse, fjerning, stilbehandling eller komposisjonsendring og angi det som skal beholdes. Redigeringen følger inndataklippets varighet og kombinerer ikke basisvideooppgaven med grensebildekontroll eller generering med flere innstillinger. Som egenskapsreferanse gir videoen innhold, stil eller kamerainformasjon til en ny innstilling.
Prompting med referansevideo kan også be om en foregående eller etterfølgende innstilling. Identifiser kildeklippet og beskriv den nye synlige hendelsen, som en videreføring av motivets handling eller en avdekking av omgivelsene. Dette bruker referansen til å formidle visuell informasjon; gjennomgå skjøt og motivkontinuitet før det nye segmentet settes sammen med originalopptaket.
Produsentens videoinndataprofil godtar én MP4- eller MOV-kilde på opptil 200 MB, med minste varighet på tre sekunder. Den detaljerte inndataprofilen spesifiserer dimensjoner fra 720 til 2160 piksler og bildefrekvenser fra 24 til 60 fps, med inndatasideforhold mellom 1:2,5 og 2,5:1. Den dokumenterte kildevideoarbeidsflyten returnerer video ved 24 fps. Eksakt tillatt klippvarighet avhenger også av valgt modellprofil. O1s område for nygenerering er tre til ti sekunder, adskilt fra det senere varighetsområdet til 3.0 Omni.
Produsentens O1-moduser gir 720p Standard- eller 1080p Pro-utdata. Utsnitt til nye innstillinger støtter dokumenterte liggende, stående og kvadratiske valg der valgt arbeidsflyt bruker kontrollen; redigering av basisvideo følger kildeutsnittet. Kildelyd kan beholdes eller fjernes. O1s referanse- og redigeringsarbeidsflyt bør holdes adskilt fra den senere 3.0 Omni-profilen med innebygd lyd og tilpasset storyboard.
Generering gir en oppgave der fullført resultat inneholder videoen og faktisk varighet. Produsentens resultatdokumentasjon sier at genererte videoer slettes etter 30 dager, så lagre sluttklippet raskt. Bevar kilderessurser og beskrivelse sammen med resultatet, og gjennomgå deretter ønsket endring, referansebruk og kontinuitet. Til en redigering sammenligner du det berørte området og delene som skal beholdes. Til en referansestyrt ny innstilling kontrollerer du at hver ressurs ga ønsket visuell informasjon. Hold det fullførte klippet tilgjengelig til påfølgende redigering eller produksjonssekvens.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-video-o1
kwaivgi/kling-video-o1Start
Kling VIDEO O1 er Kuaishous referansestyrte videomodell for å generere og redigere scener med tekst, bilder, motivelementer og et kildeklipp. Bruk genereringsprofilen på tre til ti sekunder til visuell kontinuitet, styrte bildeoverganger og målrettede endringer i eksisterende opptak.
- Godkjente inndata
- Tekst · Bilder
- Resultater
- Video
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Video POST /v1/videos
- Inndatatyper
text,image- Utdatatyper
video- Utdataformat
- opprinnelige MP4-bytes; ingen normalisering/transkoding
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser kwaivgi/kling-video-o1 | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser | Standard— |
Feltduration | Typeinteger | KravPåkrevd | Verdier & grenser 5, 10 Minimum: 1 Maksimum: 600 | Standard— |
Feltresolution | Typestring | KravValgfritt | Verdier & grenser 720p | Standard— |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 16:9, 9:16, 1:1 | Standard— |
Feltgenerate_audio | Typeboolean | KravValgfritt | Verdier & grenser false, true | Standard— |
Feltframe_images | Typearray | KravValgfritt | Verdier & grenser Minste antall elementer: 1 Maksimalt antall elementer: 2 Inngående innhold: Matrise med bildeobjekter. Hvert objekt har type=image_url, image_url som inneholder url, og frame_type. Bruk en HTTPS-basert URL til bildet, og sett frame_type til first_frame eller last_frame. Hver bilderolle forekommer høyst én gang. Nøyaktige nøkler: type, image_url, frame_type Vilkår: Disse nøklene beskriver hvert bildeobjekt; image_url inneholder bare url. Utelat frame_images ved en forespørsel som bare inneholder tekst. | Standard— |
Feltinput_references | Typearray | KravValgfritt | Verdier & grenser | Standard— |
Feltsize | Typestring | KravValgfritt | Verdier & grenser 1280x720, 720x1280, 720x720 Mønster: ^[1-9][0-9]*x[1-9][0-9]*$ | Standard— |
Feltcallback_url | Typestring | KravValgfritt | Verdier & grenser Mønster: ^https:// | Standard— |
Feltsession_id | Typestring | KravValgfritt | Verdier & grenser | Standard— |
Felttrace | Typeobject | KravValgfritt | Verdier & grenser | Standard— |
Feltuser | Typestring | KravValgfritt | Verdier & grenser | Standard— |
Kombinasjoner av inngående materialer
Tekst til video · En skriftlig ledetekst. · Påkrevd: model, prompt, duration
Oppgi prompt som tekst og duration som hele sekunder. Velg en støttet oppløsning; legg til et sideforhold eller bruk en oppført størrelse.
model: Type: string · kwaivgi/kling-video-o1
prompt: Type: string · Maksimalt antall UTF-8-byte: 10 000 · Minst ett tegn som ikke er mellomrom, kreves: Ja
Bilde til video · En skriftlig ledetekst og et bilde for første enkeltbilde. · Påkrevd: model, prompt, duration, frame_images
frame_images er en matrise. Hvert bildeobjekt har type, image_url og frame_type; image_url inneholder url. Sett type til image_url. Bruk first_frame med en valgfri last_frame. Hver bilderolle forekommer høyst én gang. Oppgi en offentlig tilgjengelig HTTPS-basert URL til bildet for hvert enkeltbilde. Velg en støttet oppløsning; legg til et sideforhold eller bruk en oppført størrelse.
Nøyaktige nøkler: type, image_url, frame_type
model: Type: string · kwaivgi/kling-video-o1
prompt: Type: string · Maksimalt antall UTF-8-byte: 10 000 · Minst ett tegn som ikke er mellomrom, kreves: Ja
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt, duration |
Parametermaterial_types | Avtaletext, image |
Parameteradditional_properties | Avtalefalse |
Parameteroptional_controls | Avtaleresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
Livssyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsenhet | Faktureringsvilkår | Kostnad |
|---|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Faktureringsenhetper videosekund | FaktureringsvilkårIngen ytterligere betingelse er angitt i denne prisnøkkelen. | Kostnad Utdata · Videopris · Estimat kun for sammenligning $0.224 per videosekund |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $1.12 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Detaljer om referansetariffen
Referanseprisplaner på modellnivå endrer ikke metodevalg, prisoverslag eller kostnader. Aktive kostnader bruker satsene til den valgte Ailoot-metoden.
Prisreferanser for videokonfigurasjoner
Priser etter konfigurasjon
| Konfigurasjon | Faktureringsvilkår | Kostnad |
|---|---|---|
| KonfigurasjonVideopris | FaktureringsvilkårIngen ytterligere betingelse er angitt i denne prisnøkkelen. | Kostnad Utdata · Videopris $0.224 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
Eksempelforespørsler
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":5,"model":"kwaivgi/kling-video-o1","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
Motta og lagre resultater
Ailoot Ultra · Video
Signerte innholdsadresser for ressurser du eier
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Kontroller jobbstatus
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
Andre innholdslesinger
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
Behold alle ferdige resultater
Lagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Behold alle faktiske utdata du eier, og de returnerte målte metadataene.
Hvis det opprinnelige svaret må kontrolleres
503 result_pending_check + opprinnelig id + X-Should-Retry:false; gjenta aldri den opprinnelige sendingen
Svarfelter
| Felt | Type | Betydning |
|---|---|---|
Feltindex | Typeinteger | BetydningNullbasert posisjon for denne videoen i utdatalisten. |
Feltcontent_url | Typestring | BetydningSignert HTTPS-basert URL for nedlasting av denne ferdigstilte videoen. |
Feltsha256 | Typestring | null | BetydningSHA-256-kontrollsum for den opprinnelige videoens byte; null hvis utilgjengelig. |
Feltsize_bytes | Typeinteger | null | BetydningStørrelsen på den opprinnelige videofilen i byte; null hvis utilgjengelig. |
Feltduration_ms | Typeinteger | null | BetydningMålt videovarighet i millisekunder; null hvis utilgjengelig. |
Feltwidth | Typeinteger | null | BetydningVideobredde i piksler; null hvis utilgjengelig. |
Feltheight | Typeinteger | null | BetydningVideohøyde i piksler; null hvis utilgjengelig. |
Feltvideo_codec | Typestring | null | BetydningIdentifikator for videokodeken; null hvis ikke registrert. |
Felthas_audio | Typeboolean | null | BetydningOm videoen inneholder et lydspor; null hvis ikke målt. |
Feltaudio_codec | Typestring | null | BetydningIdentifikator for lydkodeken; null når ingen identifikator er registrert. |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar404 · not_found_error | VilkårVideotilgang er utilgjengelig, eller denne video-ID-en ble ikke funnet. | Neste trinnKontroller videotilgangen. For en eksisterende video bruker du den opprinnelige offentlige ID-en og samme API-nøkkel. |
Svar401 · authentication_error | VilkårAPI-nøkkelen samsvarer ikke med den autentiserte kontoen. | Neste trinnKontroller API-nøkkelen din og kontotilgangen før innsending. |
Svar400 · invalid_request_error | VilkårForespørselen kunne ikke leses, eller nedlastingsindeksen er ugyldig. | Neste trinnKorriger forespørselskroppen. Ved nedlasting velger du en utdataindeks som ble returnert av den opprinnelige oppgaven. |
Svar422 · price_unavailable | VilkårDen valgte videokonfigurasjonen kan ikke prises. | Neste trinnVelg en støttet videokonfigurasjon og fyll ut de påkrevde alternativene før du sender en korrigert forespørsel. |
Svar422 · invalid_request_error | VilkårVideoinndata eller den opprinnelige fortsettelsesoppgaven er ugyldig. | Neste trinnBruk gyldige HTTPS-inndata. Ved fortsettelse bruker du den ferdigstilte originalens offentlige video-ID med samme API-nøkkel. |
Svar402 · billing_error | VilkårDen tilgjengelige saldoen eller grensene tillater ikke en reservasjon. | Neste trinnKontroller tilgjengelig saldo og grenser før du sender en ny forespørsel. |
Svar503 · server_error | VilkårVideokontroll, lagring eller tjenestetilgang er midlertidig utilgjengelig. | Neste trinnVent til tjenesten er tilgjengelig. Hvis du allerede har en video-ID, kontroller den opprinnelige oppgaven fremfor å opprette en ny generering. |
Svar503 · result_pending_check | VilkårDet opprinnelige videoresultatet og belastningen må kontrolleres. | Neste trinnBehold den returnerte video-ID-en og kontroller den oppgaven. Ikke send en erstatningsforespørsel om generering mens den kontrolleres. |
Svar503 · owned_result_unavailable | VilkårNedlasting av den eksisterende videoen er midlertidig utilgjengelig. | Neste trinnKontroller den samme videooppgaven senere og last ned de eksisterende utdataene. En ny generering oppretter en separat operasjon. |
Svar409 · video_not_ready | VilkårVideoinnholdet er ikke publisert. | Neste trinnKontroller den opprinnelige oppgavestatusen. Last ned etter at den rapporterer completed; hvis den rapporterer failed, følg varselet om kontroll av belastningen. |
Aliaser
Modellaliaser
Ailoot Ultra kwaivgi/kling-video-o1
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · Kling: Video O1
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos·kwaivgi/kling-video-o1:text,image→video- Hvilke felt bruker forespørselen?
POST /v1/videos·kwaivgi/kling-video-o1:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- Hvilke grenser gjelder?
POST /v1/videos·kwaivgi/kling-video-o1:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1