API Grok Image para geração e edição
Acesse o Grok Image pela API independente do GoEnhance. Gere a partir de um prompt de texto ou envie até nove imagens de referência para edição de imagem para imagem e, depois, recupere o resultado assíncrono por polling ou callback HTTPS. O GoEnhance não é a xAI e esta não é a API oficial da xAI.
Criar uma API Key
Um único endpoint para novas imagens e edições guiadas por referências
Geração de imagem a partir de texto
Defina model como grok-image, envie um prompt de 1–2.000 caracteres e escolha 2:3, 3:2, 1:1, 9:16 ou 16:9. A proporção vale para requisições somente de texto.
Edição com imagens de referência
Inclua image_list com uma a nove URLs de imagem acessíveis para executar a geração de imagem para imagem. Quando há referências, o campo de proporção documentado é ignorado.
Use apenas os campos de requisição documentados e valide-os antes do envio.
Recursos da API Grok Image
Endpoint de imagens unificado
Envie um POST com JSON para <code>https://api.goenhance.ai/api/v1/images/generations</code>.
Seleção exata do modelo
Defina o valor obrigatório de <code>model</code> como <code>grok-image</code>.
Validação do prompt
Informe um prompt de texto obrigatório com 1 a 2.000 caracteres.
Imagens de referência opcionais
Envie de um a nove objetos de URL em <code>image_list</code> para requisições de imagem para imagem.
Proporções para requisições só de texto
Escolha 2:3, 3:2, 1:1, 9:16 ou 16:9 quando nenhuma lista de referências for enviada.
Tratamento assíncrono do resultado
Armazene o <code>img_uuid</code> e, em seguida, faça polling nos detalhes da tarefa ou processe os eventos de callback HTTPS.
A documentação atual do GoEnhance lista uma tarifa fixa para cada imagem gerada.
Preços da API Grok Image
1,3 token por imagem
Cada geração bem-sucedida do Grok Image está documentada em 1,3 token do GoEnhance.
$0.026 por imagem
O equivalente documentado em dólares é de $0.026 para cada imagem gerada.
Trate as respostas de saldo
Verifique o código da resposta JSON além do status HTTP; tokens insuficientes podem retornar <code>code: 100</code>.
Integre a API Grok Image em quatro passos
1
1. Crie uma API key
Crie uma key do GoEnhance e envie-a a partir do seu servidor no cabeçalho
Authorization. 2
2. Monte a requisição
Envie por POST
model: grok-image com um prompt. Adicione image_list para a edição guiada por referências ou escolha uma proporção compatível para a geração a partir de texto. 3
3. Acompanhe a tarefa e leia o resultado
Leia
data.img_uuid de uma resposta bem-sucedida e associe esse valor ao seu próprio registro de tarefa. Depois faça polling em GET /api/v1/jobs/detail ou informe uma custom_callback_url HTTPS pública, tratando processamento, sucesso e falha como estados explícitos.Conecte a geração e a edição de imagens a produtos que já cuidam de prompts, revisão e entrega.
Casos de uso do Grok Image para desenvolvedores
Ilustração editorial
Gere conceitos de cena originais a partir de briefings de pauta e encaminhe-os para uma fila de revisão.
Variações criativas de campanha
Produza direções visuais conduzidas por prompt nas proporções retrato, quadrada ou paisagem compatíveis.
Reestilização guiada por referências
Use imagens de origem aprovadas para criar variações visuais controladas e revisá-las depois.
Arte conceitual de produto
Transforme descrições de produto estruturadas e referências opcionais em materiais de exploração visual.
Concepção de personagens e cenários
Crie conceitos preliminares de personagens, objetos de cena e ambientes a partir de prompts descritivos.
Pipelines criativos automatizados
Conecte tarefas assíncronas a callbacks, moderação, armazenamento, aprovação e processamento posterior.
Respostas para dúvidas comuns sobre preços, entradas, proporções e integração.