Formatbilleder, opløsninger og omkostningsstyring
På denne side
Opdateret 3. november 2026 baseret på xAIs videodokumentation: API’en accepterer ni formatbilleder (herunder
21:9og5:2) og tre opløsninger, hvor1080pafhænger af modellen; de tre videomodeller har hver deres prisfastsættelse; og parameterensizemed sine pixeldimensioner, som blev præsenteret i den ældre version, forekommer ikke i API-referencen. Kilder: Video Generation · Videos API · Pricing.
Optimer dine videogenereringer
Det er ikke nok at kunne skrive en prompt for at gå i produktion. To faktorer afgør resten: den tekniske indramning af dine outputs og omkostningskontrol. Et studie, der genererer to hundrede klip om måneden uden en prototypestrategi, betaler flere gange den nødvendige pris, og et team, der først ved slutningen af et projekt opdager, at dets format ikke matcher distributionskanalen, må starte forfra. Denne lektion dækker begge punkter sammen, fordi de påvirker hinanden.
Vælg det rigtige formatbillede
Parameteren aspect_ratio fastsætter proportionerne for den genererede video. Ni værdier accepteres, og hver svarer til en specifik distributionsdestination.
| Format | Proportioner | Primær anvendelse |
|---|---|---|
16:9 | Bredt landskab | YouTube, præsentationer, hjemmesider |
9:16 | Portræt | TikTok, Stories, Reels |
1:1 | Kvadrat | Sociale opslag, thumbnails |
4:3 | Klassisk landskab | Dokumenter, slides |
3:4 | Klassisk portræt | Pinterest, plakater |
3:2 | Fotolandskab | Porteføljer, gallerier |
2:3 | Fotoportræt | Plakater, forsider |
21:9 | Bredt biograformat | Cinematiske optagelser |
5:2 | Banner | Web-bannere, sidehoveder |
Hvis der ikke angives en eksplicit parameter, anvender API’en 16:9. Dette er en fornuftig standard for webbet, men det bliver en fælde, så snart du fodrer det med vertikale formater: En kampagne beregnet til Reels skal deklarere 9:16 ved hver anmodning, ellers vil du modtage landskabsbilleder, der skal beskæres, hvilket medfører tab af komposition. To tilstande er undtaget fra denne indstilling: Ved billede-til-video følger outputtet forholdet i kildebilledet, og ved redigering følger det forholdet i kildevideoen.
Tre opløsninger, afhængigt af modellen
Parameteren resolution accepterer tre værdier. Standardværdien, 480p, er beregnet til forhåndsvisninger og udkast: Rendering er hurtigere, hvilket gør den til en ideel testplatform til at validere en prompt, før du kører den igen i endelig kvalitet. 720p svarer til HD-kvalitet, der er tilstrækkelig til de fleste web- og mobilapplikationer. 1080p giver dig endelig Full HD, men ikke på alle modeller:
| Model | Maksimal opløsning |
|---|---|
grok-imagine-video-1.5 | Native 1080p (720p i reference-to-video) |
grok-imagine-video-1.5-lite | 1080p, via opskalering fra 720p |
grok-imagine-video | 720p |
Redigering kan ikke justeres: Den producerede video beholder opløsningen fra kilden, begrænset til 720p. Og der findes ingen finere indstilling end disse trin: API-referencen indeholder ingen parameter for pixelstørrelse. Hvis din distribution kræver eksakte dimensioner, skal du vælge det nærmeste forhold og den nærmeste opløsning og derefter beskære under redigering.
{
"model": "grok-imagine-video-1.5",
"prompt": "Your description",
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": 5
}
Hvad produktion virkelig koster
Prisen beregnes per sekund genereret video og afhænger af modellen: $0.020 for grok-imagine-video-1.5-lite, $0.050 for grok-imagine-video og $0.080 for grok-imagine-video-1.5. Stigningen er fuldstændig lineær, hvilket gør budgettet forudsigeligt.
| Varighed | 1.5-lite | grok-imagine-video | 1.5 |
|---|---|---|---|
| 1 sekund | $0.02 | $0.05 | $0.08 |
| 3 sekunder | $0.06 | $0.15 | $0.24 |
| 5 sekunder | $0.10 | $0.25 | $0.40 |
| 8 sekunder (standard) | $0.16 | $0.40 | $0.64 |
| 10 sekunder | $0.20 | $0.50 | $0.80 |
| 15 sekunder | $0.30 | $0.75 | $1.20 |
Pr. 3. november 2026 viser xAI-siden Models en enkelt pris per sekund for hver model uden sondring for opløsning, mens siden Video Overview henviser til priser “per opløsning”: Tjek prislisten, før du igangsætter en stor batch.
Den første optimeringsmulighed er valget af model. xAI anbefaler grok-imagine-video-1.5-lite, som er fire gange billigere end version 1.5, til enkle videoer, og grok-imagine-video-1.5, når du har brug for referencebilleder, stemmer, pålagte billeder eller native 1080p; redigering og udvidelse fungerer derimod kun med grok-imagine-video. Den anden muligheder er antallet af forsøg. Prototyp systematisk kort: Valider bevægelsesretningen på to eller tre sekunder, før du begår dig til en generering på ti eller femten sekunder. Forfin prompten, indtil den er rigtig første gang, da hver nygenerering koster fuld pris. Kør disse forsøg i 480p: Den viste pris ændrer sig ikke, men den forkortede genereringstid lader dig iterere hurtigere. Og husk rate-grænsen, når du planlægger en batch.
Denne ræsonnement er let at beregne. For et projekt med femogtyve fem-sekunders videoer med grok-imagine-video kommer den rå produktion op på 20 × $0.25, altså $5.00 ($2.00 med lite-versionen, $8.00 med 1.5). Antag to gennemsnitlige iterationer per video, og du er oppe på $10.00. Læg en eksperimentel margen på 50% til, og du præsenterer et budget på $15.00, der holder. Dette er størrelsesordenen, du skal kommunikere til en kunde, ikke den teoretiske omkostning fra den første beregning.
Håndtering af rate-grænser
API-grænser tælles i anmodninger per sekund, per model, og vokser med dit teams niveau, som igen er fastlagt af dine kumulative udgifter: På startniveauet accepterer videomodeller 10 anmodninger per sekund, og API’en svarer 429 Too Many Requests ud over dette (Rate limits). I almindelig brug nås denne grænse sjældent: Da generering er asynkron og langvarig, bruger du mere tid på at vente end på at indsende. Risikoen opstår ved massive batches, der lanceres parallelt, hvor få linjer kode kan mætte kvoten på et øjeblik. Det er nok at sprede indsendelserne for at holde sig inden for grænserne.
import asyncio
async def soumettre_lot(prompts, par_seconde=5):
"""Submits generations without exceeding the rate limit."""
for prompt in prompts:
await soumettre_video(prompt) # POST, without waiting for completion
await asyncio.sleep(1 / par_seconde)
Til meget store batches, der kan vente, tilbyder API Batch en anden vej: Dens anmodninger tæller ikke med i rate-grænserne, og de tre videomodeller accepterer det (kun i visse regioner for grok-imagine-video og grok-imagine-video-1.5). Forvent ikke besparelser: Batch-rabatten gælder kun for tekstmodeller, og video faktureres til standardtaksten. Behandlingen sker generelt inden for 24 timer, uden garanti.
Lever videoen uden at downloade den
Sidste nyttige indstilling i produktion: Parameteren output.upload_url angiver en signeret URL (S3 eller GCS presigned, Azure SAS), hvortil videoen automatisk sendes via HTTP PUT med headeren Content-Type: video/mp4, så snart den er genereret.
{
"model": "grok-imagine-video",
"prompt": "Your description",
"duration": 5,
"output": {
"upload_url": "https://your-storage.com/upload/video.mp4"
}
}
I praksis fjerner dette et helt trin fra din pipeline: Du behøver ikke downloade hver fil og derefter skubbe den til dit lager; videoen ankommer direkte til sin destination. Ved en strøm på flere dusin klip om dagen er det så meget mindre overførselskode og fejlhåndtering, der skal vedligeholdes.
Priser registreret 3. november 2026 — priserne udvikler sig regelmæssigt: Før enhver budgetberegning skal du tjekke den aktuelle prisliste på den officielle xAI-side for modeller og priser.
Vigtige pointer
- Ni formatbilleder er tilgængelige,
16:9som standard; ved billede-til-video følger outputtet billedets forhold - Tre opløsninger: 480p (standard), 720p og 1080p, sidstnævnte kun på 1.5-modeller
- Ingen parameter indstiller en pixelstørrelse: forhold og opløsning er nok
- Prisen er lineær, per sekund: $0.020, $0.050 eller $0.080 afhængigt af modellen
- Prototyp kort, i 480p, med den billigste model, der er tilstrækkelig
output.upload_urlautomatiserer levering; API Batch omgår rate-grænser, uden rabat på video