API do Grok Image

Resumo rápido

A API do Grok Image executa o Grok Image Quality e mais 2 variantes pelo Mage em POST https://api.mage.space/v1/grok_image/generate. Uma solicitação nas configurações padrão custa 75 Gems (cerca de US$ 0,075), sem assinatura. O Grok Image aceita personagens e referências salvos, chamados por @handle no prompt.

• Imagem

  Saída

• 3

  Variantes

• 75

  Gems por imagem, padrão

• $0.075

  Aproximadamente, em USD

Visão geral

O que a API do Grok Image faz

Modelo de imagem Grok Imagine da xAI em três níveis de qualidade. 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 se aplica.

Modelos de imagem Grok Imagine da xAI em três níveis de qualidade, para gerar e editar a partir de imagens de referência. O filtro de segurança da xAI se aplica.

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.

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-quality"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// 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-quality',
});

console.log(request.result.url);

# 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-quality",
})

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.

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.

Entradas

Entradas de mídia aceitas pelo Grok Image

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

Mais modelos de imagem

Outras APIs de geração de imagens no Mage

Perguntas frequentes

Perguntas frequentes

Comece a criar com o Mage

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

Relacionados

• API de geração de imagens com IA
• Referência da API do Grok Image
• Playground do Grok Image
• Todos os modelos da API
• Servidor MCP do Mage