grok-imagine-video
Grok Imagine Video lager korte klipp fra tekstbeskrivelser, med valg av varighet og bildeformat. Selve xAI-modellen støtter også bildeanimering og målrettet videoredigering.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Fra beskrivelse til videoklipp
Grok Imagine Video lager video fra tekst. Selve xAI-modellen har også moduser med kildebilde og kildevideo. I Ailoots publiserte genereringsmetode er inndata en tekstbeskrivelse, og resultatet et videoklipp.
Genereringen skjer asynkront: først opprettes en oppgave, deretter hentes status og ferdig resultat med identifikatoren. Ifølge xAI kan generering av et klipp ta flere minutter; tiden avhenger av scenens kompleksitet, varighet, oppløsning og valgt modus.
Varighet og bildeformat
En varighet fra 1 til 15 sekunder er tilgjengelig for generering. Bildeformatene omfatter 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 og 2:3; standardformatet er 16:9. Denne versjonen tilbyr 480p og 720p, mens 1080p hører til versjon 1.5.
Animering av et kildebilde
I xAIs bildemodus blir bildet det første videobildet, og tekstinstruksjonen angir bevegelsen. Klippets form følger kildebildets sideforhold som standard. Et uttrykkelig angitt sideforhold endrer formen og kan strekke bildet.
Målrettet redigering
Ved arbeid med en ferdig video gjør modellen de beskrevne endringene og beholder resten av sceneinnholdet. Modusen bidrar til å endre et bestemt element samtidig som iscenesettelsen i kildeklippet bevares. Varighet og sideforhold arves fra originalen; ny varighet eller bildeform angis ikke.
Kildeklippet for redigering er begrenset til 8,7 sekunder, og resultatet til en oppløsning på høyst 720p. Materiale i 1080p skaleres ned til 720p. Innstillingene for tekstbasert generering overføres ikke automatisk til redigering.
Videreføring av et ferdig klipp
I en separat xAI-modus fortsetter denne versjonen kildeklippet fra det siste videobildet. Kildens MP4 skal vare fra 2 til 15 sekunder; den ekstra delen fra 2 til 10 sekunder, med 6 som standard. Resultatet kombinerer kildevideoen og fortsettelsen. Sideforhold og oppløsning arves fra kilden, med en grense på 720p; de kan ikke endres separat i denne modusen. Denne produsentfunksjonen skiller seg fra Ailoots publiserte tekstbaserte generering.
Referanser og versjonsgrenser
xAI tilbyr bruk av visuelle referanser for å styre utseendet til mennesker, klær og gjenstander i scenen. Referansen angir visuelle kjennetegn, ikke et nøyaktig bilde av det første videobildet. I den klassiske Grok Imagine Video kan et første videobilde ikke kombineres med referanser.
Denne versjonen tar ikke imot nøyaktig fastsetting av siste videobilde eller mellomliggende nøkkelbilder. Disse funksjonene hører til Grok Imagine Video 1.5. Generering, animering av et kildebilde og endring av et ferdig klipp er ulike moduser; Ailoots publiserte metode beskriver her generering fra tekst.
Ailoot · Videogenerering POST /v1/videos/generations grok-imagine-video
grok-imagine-videoStart
Grok Imagine Video lager korte klipp fra tekstbeskrivelser, med valg av varighet og bildeformat. Selve xAI-modellen støtter også bildeanimering og målrettet videoredigering.
- Godkjente inndata
- Tekst
- Resultater
- Video
Tilgjengelig i Ailoot · inndata & metoder
Ailoot · Videogenerering POST /v1/videos/generations
- Inndatatyper
text- Utdatatyper
video- Utdataformat
- mp4
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser grok-imagine-video | Standard— |
Feltprompt | Typestring | KravValgfritt | Verdier & grenser Minste lengde: 1 | Standard— |
Feltduration | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 15 Vilkår: Ikke oppgi både duration og seconds Enhet: sekunder | Standard1 |
Feltseconds | Typeinteger|integer_string | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 15 Alternativ: duration | Standard— |
Feltresolution | Typestring | KravValgfritt | Verdier & grenser 480p, 720p | Standard480p |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Vilkår: Hvis inndatabildet er oppgitt og sideforholdet utelates, arver leverandøren bildets sideforhold | Standard16:9 |
Feltsize | Typestring | KravValgfritt | Verdier & grenser 1280x720, 720x1280, 1920x1080, 1080x1920 Vilkår: Må samsvare med resolution/aspect_ratio hvis begge er angitt | Standard— |
Feltimage | Typeobject | KravValgfritt | Verdier & grenser Vilkår: Et faktisk støttet inndatabilde; gjør det mulig å utelate ledeteksten | Standard— |
Kombinasjoner av inngående materialer
Tekst til video · Påkrevd: prompt
Bilde til video · Påkrevd: image
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametermaterial_types | Avtaletext |
Parameterrequired | Avtalenull |
Parameteroptional_controls | Avtalenull |
Livssyklus: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Metodestrukturer og ID-er er eksakte; leverandørens evne er adskilt fra godkjenning av forespørselen.
Priser
Satser for Ailoot-metoder
POST /v1/videos/generations- Inndata
- 0,002 USD per inndatabilde
- Inndata
- 0,01 USD per sekund inndatavideo
- Utdata
- 0,05 USD per sekund ved 480p
- Utdata
- 0,07 USD per sekund ved 720p
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 →
Eksempelforespørsler
Ailoot · Videogenerering
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-imagine-video", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'Motta og lagre resultater
Ailoot · Videogenerering
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Kontroller jobbstatus
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
-H "Authorization: Bearer $AILOOT_API_KEY"Andre innholdslesinger
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--output video.mp4Behold alle ferdige resultater
Lagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Behold hele statusens JSON-svar og den faktiske request_id. Et ferdigstilt svar med status=done inneholder video.url med en URL til innhold du eier. Bevar rapportert varighet og hvert returnert resultatfelt.
Hvis det opprinnelige svaret må kontrolleres
Les den eksisterende opprinnelige jobben; send aldri en forespørsel med ukjent utfall på nytt.
Svarfelter
| Felt | Type |
|---|---|
Feltrequest_id | Typestring |
Feltid | Typestring |
Feltstatus | Typestring |
Feltvideo.url | Typeowned signed content URL |
Feltvideo.duration | Typenumber |
Feltvideo.respect_moderation | Typeboolean |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårUgyldige påkrevde felter, materialrepresentasjon eller parameterverdi | Neste trinnKorriger de angitte feltene før en ny opprettelsesforespørsel. |
Svar409 · video_not_ready | VilkårDet opprinnelige resultatinnholdet er ennå ikke tilgjengelig | Neste trinnSpør jevnlig etter den opprinnelige returnerte ID-en og følg Retry-After. |
Svarserver_error | VilkårDet returnerte svaret angir at operasjonen eller resultatet må kontrolleres | Neste trinnBevar den opprinnelige returnerte operasjons-/oppgave-ID-en, forespørselshodene og svaret; fortsett å lese den opprinnelige operasjonen på de støttede måtene. Ikke send opprettelsesforespørselen på nytt. |
Aliaser
Modellaliaser
Ailoot grok-imagine-video
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · grok-imagine-video
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos/generations·grok-imagine-video:text→video- Hvilke felt bruker forespørselen?
POST /v1/videos/generations·grok-imagine-video:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- Hvilke grenser gjelder?
POST /v1/videos/generations·grok-imagine-video:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15