Geração Grok 5 Imagine

Documentação da API

Use estes endpoints para submeter trabalhos Grok 5 Imagine e verificar o seu status. Cada chamada gasta créditos com base no modelo utilizado.

Autenticação

Todos os pedidos devem incluir a sua chave de API dentro do Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Chaves ausentes ou inválidas retornam 401 Unauthorized.

POST

https://grok5imagine.com/api/generate

Criar tarefa de geração

Submete um novo trabalho Grok 5 Imagine. A chamada retorna imediatamente um task_id enquanto a renderização é concluída de forma assíncrona.

Parâmetro	Tipo	Obrigatório	Descrição
model	string	Não	Modelo a usar: grok-imagine/text-to-image (padrão), text-to-video, image-to-video ou upscale.
input	object	Sim	Objeto de parâmetros de entrada contendo prompt, image_urls ou task_id conforme o modelo.
input.prompt	string (max 5000 chars)	Não	Prompt de texto descrevendo o que gerar (obrigatório para text-to-image e text-to-video).
input.image_urls	string[]	Não	Array de URLs de imagens (obrigatório para image-to-video).
input.task_id	string	Não	ID de tarefa anterior para upscale ou geração image-to-video.
callback_url	string	Não	URL do webhook para receber notificações de conclusão da tarefa.
public	boolean	Não	Expor a tarefa a galerias públicas.

Consumo de Crédito

Os créditos são deduzidos quando a tarefa é criada. Trabalhos falhados são automaticamente reembolsados.

Modelo	Créditos deduzidos
grok-imagine/text-to-image	5
grok-imagine/text-to-video	24
grok-imagine/image-to-video	24
grok-imagine/upscale	12

Exemplo de pedido

{
  "model": "grok-imagine/text-to-image",
  "input": {
    "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
  }
}

Exemplo de resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "IN_PROGRESS"
  }
}

GET / POST

https://grok5imagine.com/api/status

Verificar status da tarefa

Use este endpoint para consultar o registro mais recente. Quando a tarefa ainda está em IN_PROGRESS, consultamos o provedor mais uma vez antes de responder.

Parâmetro	Tipo	Obrigatório	Descrição
task_id	string	Sim	ID retornado por /generate. Enviar via query (?task_id=) ou corpo JSON.

Campo	Descrição
task_id	ID retornado de /generate.
status	SUCCESS (SUCESSO)
request	Cópia higienizada do payload submetido.
response	Objeto contendo array resultUrls quando o status é SUCCESS.
consumed_credits	Créditos cobrados pela tarefa (0 quando reembolsado).
error_message	Erro do provedor quando o status é FAILED.
created_at	Carimbo de data/hora UTC quando o trabalho foi armazenado.

Exemplo de pedido

GET https://grok5imagine.com/api/status?task_id=n31b6d54c8f4b4c4e8kie
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://grok5imagine.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "n31b6d54c8f4b4c4e8kie"
}

Exemplo de resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "SUCCESS",
    "request": {
      "model": "grok-imagine/text-to-image",
      "input": {
        "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
      }
    },
    "response": {
      "resultUrls": [
        "https://static.gogloai.com/grok-imagine/image_001.png"
      ]
    },
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Tratamento de Erros

401 Unauthorized - Chave API ausente ou inválida.
402 Payment Required - O saldo de crédito não pôde cobrir a dedução.
429 Too Many Requests - Reduza a cadência de polling ou a taxa de pedidos.
500 - Problema transitório; tente novamente com backoff exponencial.