API di Mage · Modello video
API Grok Video
Grok Imagine in movimento
POST https://api.mage.space/v1/grok_video/generateIn breve
L'API Grok Video esegue Grok Video tramite Mage su POST https://api.mage.space/v1/grok_video/generate. Una richiesta con le impostazioni predefinite costa 375 Gems (circa 0,375 $), senza abbonamento. Grok Video usa personaggi e riferimenti salvati tramite @handle nel prompt.
- VideoOutput
- 1Variante
- 375Gems per clip, predefinito
- $0.375Circa, in USD
Panoramica
Cosa fa l'API Grok Video
Grok Imagine di xAI per i video, a partire da un testo, fino a 5 riferimenti o una breve clip di partenza. Da 1 a 15 secondi fino a 720p. Si applica il filtro di sicurezza di xAI.
Grok Imagine di xAI per i video, a partire da un testo, immagini di riferimento o un video di partenza da modificare. Si applica il filtro di sicurezza di xAI.
Accetta image, additional_images, video come input.
Guida rapida
Chiama l'API Grok Video
Imposta MAGE_API_KEY, invia a /grok_video/generate e interroga status_url finché la richiesta non è completata.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_video/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "grok-imagine-video"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('grok_video', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '5',
model_id: 'grok-imagine-video',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("grok_video", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "grok-imagine-video",
})
print(request["result"]["url"])Modelli
Valori model_id di Grok Video
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| grok-imagine-video | Grok Video | Sì |
Opzioni
Parametri di Grok Video
Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.
| Campo | Valori |
|---|---|
| aspect_ratio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 |
| resolution | 480p, 720p |
| duration | 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
Input
Input multimediali accettati da Grok Video
Invia ciascuno come URL https, data URL o upload fino a 100 MB.
| Campo | Ruolo |
|---|---|
| image | L'immagine di riferimento. |
| additional_images | Immagini di riferimento aggiuntive. |
| video | Il video di origine. |
Regole
Cosa impone l'API Grok Video
- Un video di partenza può durare al massimo 8,7 secondi e non può essere combinato con immagini di riferimento.
- Fino a 5 immagini di riferimento, che limitano la clip a 10 secondi.
Altri modelli video
Altre API per generare video su Mage
API di Kiwi
Video di tutti i giorni, senza configurazione
API Lemon
Tutte le funzioni video, a un prezzo più accessibile
API di LTX Video
Video veloce open-weights per iterare
API Magejutsu
Rifai qualsiasi video mantenendone il movimento
API di Melon
Anime in movimento, con audio opzionale
API MiniMax-H3
Video open veloce con audio stereo
FAQ
Domande frequenti
Quanto costa la API di Grok Video?
Qual è l'endpoint della API di Grok Video?
Quali modelli Grok Video posso richiamare?
Grok Video supporta immagini di riferimento o personaggi?
Posso usare Grok Video da Claude o ChatGPT?
Per quanto tempo vengono conservati i risultati di Grok Video?
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.