SpaceXAI: Grok Imagine Video 1.5
Grok Imagine Video 1.5 iz besedila, začetne slike ali vizualnih referenc ustvarja kratke videe z usklajenim zvokom. Ponuja izvorno ustvarjanje iz besedila in slike v 1080p, do 14 referenčnih slik in tri prednastavljene glasove ter nadzor prve, zadnje in vmesnih sličic za usmerjanje prizorov z liki in izdelki.
O modelu
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Grok Imagine Video 1.5 je polna generativna različica družine Grok Imagine video. Proizvajalec poudarja gibanje, fizično neprekinjenost ter zvočne učinke, vzdušje in govor, ustvarjene skupaj s sliko. Video iz besedila in slike se izriše v izvorni ločljivosti 1080p, ustvarjanje z referencami pa omogoča več nadzora nad tem, kdo ali kaj nastopi v prizoru. Uporaben rezultat je kratek video z zvokom, denimo predstavitev izdelka, izmenjava replik med likoma ali natančno uprizorjen prehod med vizualnimi sidri.
Pri ustvarjanju videa iz besedila opišite motiv kadra, okolje, dogajanje, premikanje kamere, osvetlitev in zvok. Proizvajalec pojasnjuje, da različica 1.5 interno ustvari začetno sliko in jo nato animira; vmesna slika ni vrnjena. Pri ustvarjanju iz slike priložena slika postane prva sličica, poziv pa opisuje nadaljnje dogajanje. Sliko pripravite tako, da že vsebuje želeno kadriranje in vidne podrobnosti. Nastali posnetek sledi razmerju stranic izvorne slike, zato pokončni izhod potrebuje ustrezen začetni izrez.
Pri ustvarjanju videa iz referenc imajo slike drugačno vlogo: usmerjajo ljudi, predmete, oblačila ali lokacije, ne da bi samodejno določile začetno sličico. Dokumentirana omejitev je do 14 referenčnih slik, izhod pa traja do 15 sekund pri 720p. Vsaki sliki dodelite jasno vlogo v prizoru in jo označite z njenim mestom na seznamu referenc. V proizvajalčevi sintaksi poziva je prva referenca <IMAGE_0>, nato <IMAGE_1> in tako naprej. Če je pripeta tudi začetna slika, zavzame prvi indeks, ločene reference pa se začnejo z naslednjim. Ta vrstni red je pomemben, kadar opis razlikuje med osebo, izdelkom in okoljem.
Izviren opis z referencami lahko lik postavi ob stol iz ene slike v sobo iz druge, s počasnim približevanjem detajlu materiala stola. Motiv in ključni izdelek naj bosta na referencah lahko razločljiva. Proizvajalec svetuje, da vsaki referenci dodelite eno vlogo in stalno mesto, pri številnih vhodih pa ohranite malo nastopajočih in mirujoče rekvizite. Preverite, ali se oblika in oznake predvidenega predmeta prenesejo v prizor in ali kamera razkrije podrobnost, zahtevano v opisu.
Ustvarjanje videa iz referenc lahko dodeli tudi do tri prednastavljene glasove. V pozivu ločeno označite predvidenega govorca in njegov glas z dokumentiranimi pozicijskimi glasovnimi referencami ter podajte točen dialog, ki naj ga govorec izreče. Model podpira govor, usklajen z gibanjem ustnic. Pri kratki izmenjavi napišite replike, ki pustijo prostor za odgovor, nato pa v posnetku preverite tako pripis govorca kot gibanje ust. Glasovna referenca izbere govorno identiteto; navodila za kamero in prizor morajo še vedno opisati, kako so liki prikazani.
Nadzor prve in zadnje sličice zasidra končni točki kadra, do štiri ključne sličice pa lahko pripnejo slike v vmesnih časih. Proizvajalčev vodič za ključne sličice te čase postavlja strogo v notranjost posnetka, na mrežo z razmikom ene tretjine sekunde; dve sidri, ki se uvrstita v isto časovno mesto, sta zavrnjeni. Pripravite sidra, ki sodijo v isti prizor, in opišite gibanje med njimi. Pri razkritju izdelka lahko začetek kaže zaprto razstavno enoto, zadnja sličica pa razkrit predmet. Pri zanki je lahko ista slika prva in zadnja sličica. Prehod poslušajte in si ga oglejte v celoti, namesto da bi ocenjevali le pripete slike.
Običajno ustvarjanje videa iz besedila in slike podpira posnetke dolžine 1–15 sekund ter izhod 480p, 720p ali izvorni 1080p. Ustvarjanje iz referenc je omejeno na 720p. Kadriranje na podlagi besedila vključuje razmerja 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 in 5:2. Dolžino in obliko izberite glede na dogajanje in namen. Proizvajalec privzeto ustvari zvok, dokumentira pa tudi možnost tihega videa. Opis lahko določi izgovorjeno repliko, bližnje učinke in oddaljeno ambientalno ozadje, da zvok prispeva k istemu prizoru, namesto da postane nedoločeno ozadje.
Dokumentirani potek ustvarjanja je asinhron: vrne identifikator zahteve, nato pa končni rezultat z lokacijo in dolžino posnetka. Primer rezultata kaže na video MP4, njegova gostovana izhodna lokacija pa je začasna. Pri pripravi montaže shranite končni posnetek in vhodni opis. Neprekinjenost, obstojnost predmetov, gibanje, kadriranje in zvok preverite glede na predvideni kader. Vmesni zapis obdelave je uporaben za spremljanje dela, predvajljiv video pa je gradivo za pregled.
Razlike med različicami vplivajo na načrt. Lite je namenjen preprostemu ustvarjanju iz besedila ali animaciji ene slike, njegova možnost 1080p pa je povečana iz 720p. Polna različica 1.5 dodaja referenčne slike, prednastavljene glasove in pripete sličice. Klasična različica Grok Imagine Video omogoča urejanje in podaljševanje obstoječih videov. Ločene navedbe hitrosti za Video 1.5 Fast se nanašajo na to poimenovano različico, zato za ta model ne določajo fiksnega časa dokončanja. Pri daljšem zaporedju uprizorite skladne kratke kadre ter pri njihovem sestavljanju preverite neprekinjenost likov, izdelkov in zvoka.
Ailoot Ultra · Video POST /v1/videos x-ai/grok-imagine-video-1.5
x-ai/grok-imagine-video-1.5Začetek
Grok Imagine Video 1.5 iz besedila, začetne slike ali vizualnih referenc ustvarja kratke videe z usklajenim zvokom. Ponuja izvorno ustvarjanje iz besedila in slike v 1080p, do 14 referenčnih slik in tri prednastavljene glasove ter nadzor prve, zadnje in vmesnih sličic za usmerjanje prizorov z liki in izdelki.
- Dovoljeni vhodi
- Besedilo · Slike
- Rezultati
- Video
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · Video POST /v1/videos
- Vhod
text,image- Izhod
video- Izhodni format
- izvirni bajti MP4; brez normalizacije ali prekodiranja
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve x-ai/grok-imagine-video-1.5 | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljeduration | Vrstainteger | ZahtevaObvezno | Vrednosti in omejitve 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Najmanj: 1 Največ: 600 | Privzeto— |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 480p, 720p, 1080p | Privzeto— |
Poljeaspect_ratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 | Privzeto— |
Poljegenerate_audio | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve false | Privzeto— |
Poljeframe_images | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 1 Največ elementov: 1 Vhodna vsebina: Polje objektov sličic. Vsak objekt vsebuje type=image_url, image_url z url in frame_type. Uporabite URL slike HTTPS in nastavite frame_type na first_frame. Vsaka vloga sličice se lahko pojavi največ enkrat. Natančni ključi: type, image_url, frame_type Pogoji: Ti ključi opisujejo vsak objekt sličice; image_url vsebuje samo url. Pri zahtevi samo z besedilom izpustite frame_images. | Privzeto— |
Poljeinput_references | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljecallback_url | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Vzorec: ^https:// | Privzeto— |
Poljesession_id | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljetrace | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljeuser | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Kombinacije vhodnih gradiv
Iz besedila v video · Pisni poziv. · Obvezno: model, prompt, duration
Podajte prompt kot besedilo in duration v celih sekundah. Izberite podprto ločljivost in po potrebi razmerje stranic.
model: Vrsta: string · x-ai/grok-imagine-video-1.5
prompt: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da
Iz slike v video · Pisni poziv in slika prve sličice. · Obvezno: model, prompt, duration, frame_images
frame_images je polje. Vsak objekt sličice vsebuje type, image_url in frame_type; image_url vsebuje url. Nastavite type na image_url. Uporabite first_frame. Vsaka vloga sličice se lahko pojavi največ enkrat. Za vsako sličico podajte javni URL slike HTTPS. Izberite podprto ločljivost in po potrebi razmerje stranic.
Natančni ključi: type, image_url, frame_type
model: Vrsta: string · x-ai/grok-imagine-video-1.5
prompt: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt, duration |
Parametermaterial_types | Specifikacijatext, image |
Parameteradditional_properties | Specifikacijafalse |
Parameteroptional_controls | Specifikacijaresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user |
Življenjski cikel: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Cenik
Kako se izračuna končni strošek
Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
- Hitri način
- Ni navedeno Ko je izbran hitri način
- Način flex
- Ni navedeno Ko je izbran način flex
- Najvišja raven razmišljanja
- Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)
Ocenjene cene za primerjavo
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Predvidena količina | Obračunska enota | Obračunski pogoji | Strošek |
|---|---|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Obračunska enota— | Obračunski pogoji— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov |
| NastavitevVhodna slika | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sliko | Obračunski pogojiV tem cenovnem ključu ni naveden noben dodaten pogoj. | Strošek Vhod · Vhodna slika · Ocena samo za primerjavo $0.02 na sliko |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojiresolution: 1080p | Strošek Izhod · Cena videa · Ocena samo za primerjavo $0.5 na sekundo videa |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojiresolution: 480p | Strošek Izhod · Cena videa · Ocena samo za primerjavo $0.16 na sekundo videa |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojiresolution: 720p | Strošek Izhod · Cena videa · Ocena samo za primerjavo $0.28 na sekundo videa |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Obračunska enota— | Obračunski pogoji— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.16 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
Podrobnosti referenčne tarife
Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.
Cenovne reference konfiguracij videa
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| NastavitevVhodna slika | Obračunski pogojiV tem cenovnem ključu ni naveden noben dodaten pogoj. | Strošek Vhod · Vhodna slika $0.02 na sliko Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
| NastavitevCena videa | Obračunski pogojiresolution: 480p | Strošek Izhod · Cena videa $0.16 na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
| NastavitevCena videa | Obračunski pogojiresolution: 720p | Strošek Izhod · Cena videa $0.28 na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
| NastavitevCena videa | Obračunski pogojiresolution: 1080p | Strošek Izhod · Cena videa $0.5 na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
Primeri zahtev
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":"x-ai/grok-imagine-video-1.5","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
Prejmi in shrani rezultate
Ailoot Ultra · Video
podpisani URL-ji vsebine v vaši lasti
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Preveri stanje opravila
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
Branje druge vsebine
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
Ohrani vse dokončane rezultate
Shranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.
Ohranite vsak dejanski izhod v vaši lasti in njegove vrnjene izmerjene metapodatke.
Če je treba preveriti izvirni odgovor
503 result_pending_check + prvotni id + X-Should-Retry:false; prvotne zahteve nikoli ne ponovite
Polja odgovora
| Polje | Vrsta | Pomen |
|---|---|---|
Poljeindex | Vrstainteger | PomenPoložaj tega videa na seznamu izhodov, štet od nič. |
Poljecontent_url | Vrstastring | PomenPodpisani URL HTTPS za prenos tega dokončanega videa. |
Poljesha256 | Vrstastring | null | PomenIzvleček SHA-256 izvirnih video bajtov; null, če ni na voljo. |
Poljesize_bytes | Vrstainteger | null | PomenVelikost izvirne video datoteke v bajtih; null, če ni na voljo. |
Poljeduration_ms | Vrstainteger | null | PomenIzmerjeno trajanje videa v milisekundah; null, če ni na voljo. |
Poljewidth | Vrstainteger | null | PomenŠirina videa v slikovnih pikah; null, če ni na voljo. |
Poljeheight | Vrstainteger | null | PomenVišina videa v slikovnih pikah; null, če ni na voljo. |
Poljevideo_codec | Vrstastring | null | PomenIdentifikator video kodeka; null, če ni zabeležen. |
Poljehas_audio | Vrstaboolean | null | PomenAli video vsebuje zvočno sled; null, če ni izmerjeno. |
Poljeaudio_codec | Vrstastring | null | PomenIdentifikator zvočnega kodeka; null, kadar identifikator ni zabeležen. |
Napake in naslednji koraki
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor404 · not_found_error | PogojDostop do videa ni na voljo ali ta ID videa ni bil najden. | Naslednji korakPreverite dostop do videa. Za obstoječi video uporabite njegov prvotni javni ID in isti ključ API. |
Odgovor401 · authentication_error | PogojKljuč API se ne ujema z overjenim računom. | Naslednji korakPred oddajo preverite svoj ključ API in dostop do računa. |
Odgovor400 · invalid_request_error | PogojZahteve ni bilo mogoče prebrati ali je indeks prenosa neveljaven. | Naslednji korakPopravite telo zahteve. Pri prenosu izberite indeks izhoda, ki ga je vrnilo prvotno opravilo. |
Odgovor422 · price_unavailable | PogojIzbrane video konfiguracije ni mogoče ovrednotiti. | Naslednji korakIzberite podprto konfiguracijo videa in izpolnite njene obvezne možnosti, preden oddate popravljeno zahtevo. |
Odgovor422 · invalid_request_error | PogojVideo vhod ali prvotno nadaljevalno opravilo ni veljavno. | Naslednji korakUporabite veljavne vhode HTTPS. Za nadaljevanje uporabite javni ID svojega dokončanega prvotnega videa z istim ključem API. |
Odgovor402 · billing_error | PogojRazpoložljivo dobroimetje ali omejitve ne omogočajo rezervacije. | Naslednji korakPreden pošljete novo zahtevo, preverite razpoložljivo dobroimetje in omejitve. |
Odgovor503 · server_error | PogojPreverjanje videa, shramba ali dostop do storitve začasno ni na voljo. | Naslednji korakPočakajte, da bo storitev na voljo. Če že imate ID videa, preverite to prvotno opravilo, namesto da ustvarite novo generacijo. |
Odgovor503 · result_pending_check | PogojPrvotni video rezultat in zaračunani znesek je treba preveriti. | Naslednji korakOhranite vrnjeni ID videa in preverjajte to opravilo. Med preverjanjem ne pošljite nadomestne zahteve za ustvarjanje. |
Odgovor503 · owned_result_unavailable | PogojPrenos obstoječega videa začasno ni na voljo. | Naslednji korakPozneje preverite isto video opravilo in prenesite njegov obstoječi izhod. Novo ustvarjanje ustvari ločeno operacijo. |
Odgovor409 · video_not_ready | PogojVideo vsebina ni objavljena. | Naslednji korakPreverite stanje prvotnega opravila. Prenesite, ko sporoči completed; če sporoči failed, upoštevajte njegovo obvestilo o preverjanju zaračunanega zneska. |
Druga imena
Druga imena modelov
Ailoot Ultra x-ai/grok-imagine-video-1.5
Druga imena poti metod
Uporabite zgoraj navedene poti metod.
Povezani ID-ji za klic
FAQ · SpaceXAI: Grok Imagine Video 1.5
- Kateri vhodi in rezultati so na voljo?
POST /v1/videos·x-ai/grok-imagine-video-1.5:text,image→video- Katera polja uporablja zahteva?
POST /v1/videos·x-ai/grok-imagine-video-1.5:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,callback_url,session_id,trace,user- Katere omejitve veljajo?
POST /v1/videos·x-ai/grok-imagine-video-1.5:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1