grok-imagine-video
Grok Imagine Video skaber korte videoer fra tekst med valg af varighed og billedformat. xAI-modellen understøtter også billedanimation og målrettet videoredigering.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Fra beskrivelse til video
Grok Imagine Video skaber video fra tekst. xAI-modellen har også tilstande med udgangsbillede og video. Ailoots offentliggjorte genereringsmetode bruger tekstbeskrivelse som input og video som resultat.
Genereringen er asynkron: et job oprettes først, hvorefter status og resultat hentes med identifikatoren. Ifølge xAI kan det tage flere minutter; tiden afhænger af scenekompleksitet, varighed, opløsning og tilstand.
Varighed og billedformat
Videoen kan være 1 til 15 sekunder. Billedformaterne er 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 og 2:3, med 16:9 som standard. Versionen tilbyder 480p og 720p; 1080p hører til version 1.5.
Animation af udgangsbillede
I billedtilstanden hos xAI bliver billedet startframe, mens tekstinstruktionen styrer bevægelsen. Videoformen følger som standard udgangsbilledets format. Et eksplicit billedformat ændrer formen og kan strække billedet.
Målrettet redigering
Ved færdig video anvender modellen ændringerne med bevarelse af resten af sceneindholdet. Tilstanden ændrer et element og bevarer den oprindelige iscenesættelse. Varighed og billedformat arves fra originalen; nye værdier angives ikke.
Redigeringsinput er begrænset til 8,7 sekunder, og resultatet til højst 720p. 1080p-materiale nedskaleres til 720p. Indstillinger for videogenerering ud fra tekst gælder ikke automatisk for redigering.
Fortsættelse af en færdig video
I en særskilt xAI-tilstand fortsætter versionen videoen fra sidste frame. MP4-udgangsvideoen skal være 2 til 15 sekunder, og tilføjelsen 2 til 10 sekunder med 6 som standard. Resultatet samler original og fortsættelse. Billedformat og opløsning arves med grænse på 720p og kan ikke ændres særskilt. Producentmuligheden adskiller sig fra Ailoots offentliggjorte videogenerering ud fra tekst.
Referencer og versionsgrænser
xAI tilbyder visuelle referencer til at styre personer, tøj og genstande i scenen. Referencen angiver visuelle egenskaber, ikke et præcist første frame. Klassisk Grok Imagine Video kan ikke kombinere startframe og referencer.
Versionen accepterer ikke præcis fastlåsning af sidste frame eller mellemliggende keyframes; det hører til Grok Imagine Video 1.5. Generering, billedanimation og ændring af video er forskellige tilstande; Ailoots metode her beskriver videogenerering ud fra tekst.
Ailoot · Videoer POST /v1/videos/generations grok-imagine-video
grok-imagine-videoStart
Grok Imagine Video skaber korte videoer fra tekst med valg af varighed og billedformat. xAI-modellen understøtter også billedanimation og målrettet videoredigering.
- Accepterede input
- Tekst
- Resultater
- Video
Tilgængelig i Ailoot · input og metoder
Ailoot · Videoer POST /v1/videos/generations
- Inputtyper
text- Outputtyper
video- Outputformat
- mp4
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser grok-imagine-video | Standard— |
Feltprompt | Typestring | KravValgfrit | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltduration | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 1 Maksimum: 15 Betingelser: Angiv ikke både duration og seconds Enhed: sekunder | Standard1 |
Feltseconds | Typeinteger|integer_string | KravValgfrit | Værdier og grænser Minimum: 1 Maksimum: 15 Alternativ: duration | Standard— |
Feltresolution | Typestring | KravValgfrit | Værdier og grænser 480p, 720p | Standard480p |
Feltaspect_ratio | Typestring | KravValgfrit | Værdier og grænser 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Betingelser: Hvis der angives et inputbillede, og billedformatet udelades, overtager udbyderen billedets format | Standard16:9 |
Feltsize | Typestring | KravValgfrit | Værdier og grænser 1280x720, 720x1280, 1920x1080, 1080x1920 Betingelser: Skal stemme overens med resolution/aspect_ratio, hvis begge angives | Standard— |
Feltimage | Typeobject | KravValgfrit | Værdier og grænser Betingelser: Et faktisk, understøttet inputbillede; tillader, at prompten udelades | Standard— |
Kombinationer af inputmaterialer
Tekst til video · Påkrævet: prompt
Billede til video · Påkrævet: image
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametermaterial_types | Kontrakttext |
Parameterrequired | Kontraktnull |
Parameteroptional_controls | Kontraktnull |
Livscyklus: 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
Metodernes strukturer og ID’er er præcise; leverandørens muligheder er adskilt fra adgangstilladelse.
Priser
Ailoot-metodetakster
POST /v1/videos/generations- Input
- 0,002 US$ pr. inputbillede
- Input
- 0,01 US$ pr. sekund inputvideo
- Output
- 0,05 US$ pr. sekund ved 480p
- Output
- 0,07 US$ pr. sekund ved 720p
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot · Videoer
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."}'Hent og gem resultater
Ailoot · Videoer
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Kontrollér opgavestatus
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"Læsning af andet indhold
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 færdige resultater
Gem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Behold hele status-JSON-svaret og det faktiske request_id. Et færdigt svar med status=done indeholder video.url med en indholds-URL, du ejer. Bevar den oplyste varighed og hvert returneret resultatfelt.
Hvis det oprindelige svar skal kontrolleres
Læs det eksisterende oprindelige job; indsend aldrig en afsendelse med ukendt udfald igen.
Svarfelter
| Felt | Type |
|---|---|
Feltrequest_id | Typestring |
Feltid | Typestring |
Feltstatus | Typestring |
Feltvideo.url | Typeowned signed content URL |
Feltvideo.duration | Typenumber |
Feltvideo.respect_moderation | Typeboolean |
Fejl og næste trin
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar400 · invalid_request_error | BetingelseUgyldige obligatoriske felter, materialerepræsentation eller parameterværdi | Næste trinRet de angivne felter før en ny oprettelsesanmodning. |
Svar409 · video_not_ready | BetingelseDet oprindelige resultatindhold er endnu ikke tilgængeligt | Næste trinForespørg på status med det oprindeligt returnerede ID, og overhold Retry-After. |
Svarserver_error | BetingelseDet returnerede svar angiver, at operationen eller resultatet skal kontrolleres | Næste trinGem det oprindeligt returnerede operations-/opgave-ID, anmodningens headere og svaret; fortsæt med de understøttede læseanmodninger for den oprindelige operation. Send ikke oprettelsesanmodningen igen. |
Aliaser
Modelaliaser
Ailoot grok-imagine-video
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · grok-imagine-video
- Hvilke input og resultater er tilgængelige?
POST /v1/videos/generations·grok-imagine-video:text→video- Hvilke felter bruger anmodningen?
POST /v1/videos/generations·grok-imagine-video:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- Hvilke grænser gælder?
POST /v1/videos/generations·grok-imagine-video:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15