Grok Imagine 1.0

ID da solicitação grok-imagine-1.0

Protocolos

• POST /v1/images/generations · Gerar imagens · exemplo
• GET /v1/images/tasks/{task_id} · Consultar tarefa de imagem · exemplo

Autenticação

Obtenha uma chave em Gerenciar chaves de API. Para requisições JSON, defina Content-Type: application/json.

• Authorization: Bearer YOUR_API_KEY

Parâmetros da requisição

POST /v1/images/generations

Exemplos de requisição

Defina a chave de API na variável de ambiente local ICODEEASY_API_KEY e escolha um endpoint que aceite chamadas HTTP diretas. Caso o endpoint exija um cliente específico, siga o guia de configuração desse cliente.

Substitua as URLs e os IDs de mídia dos exemplos por ativos válidos.

Images Generations

curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "grok-imagine-1.0",
  "prompt": "A watercolor illustration of a paper lantern by a lake."
}'

Consultar tarefa de imagem

curl -sS 'https://api.icodeeasy.cc/v1/images/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

Respostas e tarefas

HTTP 200 · Sucesso síncrono

Com ?sync=1, leia as URLs geradas em data[].url. created é um timestamp Unix em segundos e id é o ID da tarefa.

{
  "id": "d142c93a-de26-40c9-be62-0de840d10960",
  "created": 1781599773,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

HTTP 202 · Envio assíncrono

{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "pending"
}

Com ?async=1, consulte GET /v1/images/tasks/{task_id} com a mesma chave de API. status é pending, completed ou failed. Quando a tarefa concluir, leia a URL da imagem em result_url.

HTTP 200 · Consulta de tarefa concluída

{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "completed",
  "model": "grok-imagine-1.0",
  "result_url": "https://example.com/generated-image.png"
}

Erros comuns

Se a consulta retornar failed, leia error. Se houver error_detail, confira retryable antes de enviar novamente.

Exemplos de resposta e erros

Guia completo de integração · Consulte o guia completo da API para ver os campos, estados de tarefas e formatos de resposta.

Recursos e limites

• text_to_image · Compatível
• image_to_image · Não publicado
• image_editing · Não compatível
• reference_images · Não publicado

Catálogo de recursos dos modelos · Ver preços