API do Mage · Modelo de imagem
API do Grok Image
Grok Imagine, em dois níveis
POST https://api.mage.space/v1/grok_image/generateResumo rápido
A API do Grok Image executa o Grok Image 2.0 e mais 1 variante pelo Mage em POST https://api.mage.space/v1/grok_image/generate. Uma requisição com as configurações padrão custa 90 Gems (cerca de US$ 0,09), sem assinatura. O Grok Image aceita personagens salvos e referências por @handle no prompt.
- ImagemSaída
- 2Variantes
- 90Gems por imagem, padrão
- $0.09Aproximadamente, em USD
Visão geral
O que a API do Grok Image faz
O modelo de imagem Grok Imagine da xAI em dois níveis. Gera ou edita a partir de até 3 imagens de referência, mantendo intactos os detalhes da origem. O filtro de segurança da xAI é aplicado.
Os modelos de imagem Grok Imagine da xAI em dois níveis, para gerar e editar a partir de imagens de referência: Grok Image 2.0 (`grok-imagine-image-2.0`), o padrão, e Grok Image (`grok-imagine-image`) para rascunhos econômicos. A xAI aposentou o Grok Image Quality (`grok-imagine-image-quality`) em 2 de novembro de 2026, e uma requisição que o use é recusada. O filtro de segurança da xAI é aplicado.
Aceita image e additional_images como entradas.
Início rápido
Chame a API do Grok Image
Defina MAGE_API_KEY, envie para /grok_image/generate e consulte status_url até a solicitação ser concluída.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_image/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-2.0"
}' | 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_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '1:1',
model_id: 'grok-imagine-image-2.0',
});
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_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-2.0",
})
print(request["result"]["url"])Modelos
Valores de model_id do Grok Image
Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.
| model_id | Nome | Padrão |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-2.0 | Grok Image 2.0 | Sim |
Opções
Parâmetros do Grok Image
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, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20 |
| resolution | 1k, 2k |
Entradas
Entradas de mídia aceitas pelo Grok Image
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. |
Mais modelos de imagem
Outras APIs de geração de imagens no Mage
API do Guava
Fotorrealismo que parece uma fotografia de verdade
API do HiDream
Rápido e versátil, com prompts negativos
API do Krea 2
Estética deslumbrante em segundos
API do Mango
Nossa família de imagens principal
API do MiniMax H3 Image
Imagens nativas de 16 megapixels, pesos abertos
API do MOSS-Image
Prompts longos e texto bilíngue, pesos abertos
Perguntas frequentes
Perguntas frequentes
Quanto custa a API do Grok Image?
Qual é o endpoint da API do Grok Image?
Quais modelos do Grok Image posso chamar?
O Grok Image aceita imagens de referência ou personagens?
Posso usar o Grok Image pelo Claude ou ChatGPT?
Por quanto tempo os resultados do Grok Image ficam armazenados?
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.