API do Mage · Modelo de vídeo
API do Grok Video
O Grok Imagine em movimento
POST https://api.mage.space/v1/grok_video/generateResumo rápido
A API do Grok Video executa o Grok Video pelo Mage em POST https://api.mage.space/v1/grok_video/generate. Uma solicitação com as configurações padrão custa 375 Gems (cerca de $0,375), sem assinatura. O Grok Video usa personagens e referências salvos por @handle no prompt.
- VídeoSaída
- 1Variante
- 375Gems por clipe, padrão
- $0.375Aproximadamente, em USD
Visão geral
O que a API do Grok Video faz
O Grok Imagine da xAI para vídeo, a partir de texto, até 5 referências ou um clipe de origem curto. De 1 a 15 segundos em até 720p. O filtro de segurança da xAI se aplica.
O Grok Imagine da xAI para vídeo, a partir de texto, imagens de referência ou um vídeo de origem para editar. O filtro de segurança da xAI se aplica.
Aceita image, additional_images e video como entradas.
Início rápido
Chame a API do Grok Video
Defina MAGE_API_KEY, envie para /grok_video/generate e consulte o status_url até a solicitação ser concluída.
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"])Modelos
Valores de model_id do Grok Video
Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.
| model_id | Nome | Padrão |
|---|---|---|
| grok-imagine-video | Grok Video | Sim |
Opções
Parâmetros do Grok Video
Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.
| Campo | Valores |
|---|---|
| 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 |
Entradas
Entradas de mídia aceitas pelo Grok Video
Envie cada uma como URL https, data URL ou upload de até 100 MB.
| Campo | Função |
|---|---|
| image | A imagem de referência. |
| additional_images | Imagens de referência adicionais. |
| video | O vídeo de origem. |
Regras
O que a API do Grok Video exige
- Um vídeo de origem deve ter no máximo 8,7 segundos e não pode ser combinado com imagens de referência.
- Até 5 imagens de referência, que limitam o clipe a 10 segundos.
Mais modelos de vídeo
Outras APIs de geração de vídeo no Mage
API do Kiwi
Vídeo do dia a dia, sem configuração
API do Lemon
Todos os recursos de vídeo, por um preço mais amigável
API do LTX Video
Vídeo open-weights rápido para iterar
API Magejutsu
Refaça qualquer vídeo mantendo o movimento
API do Melon
Anime em movimento, com áudio opcional
API do MiniMax-H3
Vídeo aberto e rápido com som estéreo
Perguntas frequentes
Perguntas frequentes
Quanto custa a API do Grok Video?
Qual é o endpoint da API do Grok Video?
Quais modelos do Grok Video posso chamar?
O Grok Video aceita imagens de referência ou personagens?
Posso usar o Grok Video no Claude ou no ChatGPT?
Por quanto tempo os resultados do Grok Video ficam guardados?
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.