Pular para o conteúdo

API do Mage · Modelo de imagem

API do Grok Image

Grok Imagine, em dois níveis

POST https://api.mage.space/v1/grok_image/generate

Resumo 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_idNomePadrão
grok-imagine-imageGrok Image
grok-imagine-image-2.0Grok Image 2.0Sim

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.

CampoValores
aspect_ratio1: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
resolution1k, 2k

Entradas

Entradas de mídia aceitas pelo Grok Image

Envie cada uma como URL https, data URL ou upload de até 100 MB.

CampoFunção
imageA imagem de referência.
additional_imagesImagens de referência adicionais.

Mais modelos de imagem

Outras APIs de geração de imagens no Mage

  • Imagem · a partir de 37 Gems

    API do Guava

    Fotorrealismo que parece uma fotografia de verdade

  • Imagem · a partir de 20 Gems

    API do HiDream

    Rápido e versátil, com prompts negativos

  • Imagem · a partir de 20 Gems

    API do Krea 2

    Estética deslumbrante em segundos

  • Imagem · a partir de 42 Gems

    API do Mango

    Nossa família de imagens principal

  • Imagem · a partir de 15 Gems

    API do MiniMax H3 Image

    Imagens nativas de 16 megapixels, pesos abertos

  • Imagem · a partir de 25 Gems

    API do MOSS-Image

    Prompts longos e texto bilíngue, pesos abertos

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Grok Image?
Uma requisição do Grok Image com as configurações padrão (Grok Image 2.0) custa 90 Gems, cerca de US$ 0,09. Outras resoluções, durações e variantes mudam o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
Qual é o endpoint da API do Grok Image?
POST https://api.mage.space/v1/grok_image/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui um status_url para consultar o resultado.
Quais modelos do Grok Image posso chamar?
grok-imagine-image (Grok Image), grok-imagine-image-2.0 (Grok Image 2.0). O padrão é o Grok Image 2.0.
O Grok Image aceita imagens de referência ou personagens?
O Grok Image aceita image, additional_images. Ele também aceita personagens e referências salvos, chamados por @handle no prompt.
Posso usar o Grok Image pelo Claude ou ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Grok Image pelo nome. Seu assistente lê as opções com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do Grok Image ficam armazenados?
Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.

CharactersComunidade