Recursos para Desenvolvedores

Documentacao da API Grok 5 Imagine

Integre o modelo Grok 5 Imagine da xAI em suas aplicacoes. Suporte para geracao de texto-para-imagem, texto-para-video e imagem-para-video com uma API REST simples.

Autenticacao

A API Grok 5 Imagine utiliza autenticacao por Bearer Token. Passe sua Chave de API no cabecalho da requisicao.

Autenticacao

Authorization: Bearer sk-your-api-key-here

Mantenha sua chave de API segura. Nao a compartilhe em codigos do lado do cliente.

Precos

Tipo	Custo	Descricao
Texto para Imagem `(text2img)`	5 Creditos	Gere imagens a partir de prompts de texto usando Grok 5 AI.
Texto para Video `(text2video)`	24 Creditos	Gere videos a partir de prompts de texto usando Grok 5 AI.
Imagem para Video `(img2video)`	24 Creditos	Gere videos a partir de imagens usando Grok 5 AI.

Criar Tarefa

POSThttps://grok5ai.com/api/generate

Geracao Assincrona

Precos

Os creditos variam por modelo: text2img custa 5 creditos, text2video e img2video custam 24 creditos cada.

Inicia uma tarefa de geracao. A API retorna um task_id imediatamente, que voce usa para consultar os resultados.

Parametros do Corpo

Parametro	Tipo	Obrigatorio	Descricao
model	string	Obrigatorio	Modelo a usar: text2img, text2video ou img2video.
prompt	string	Condicional	A descricao em texto para a geracao. Maximo de 5000 caracteres. Obrigatorio para text2img e text2video.
image_urls	array	Condicional	Array de URLs de imagens para o modo img2video. Obrigatorio se task_id nao for fornecido.
task_id	string	Condicional	ID de tarefa de uma geracao anterior para usar como imagem de entrada. Obrigatorio se image_urls nao for fornecido.
callback_url	string	Opcional	URL de Webhook para notificacao de conclusao da tarefa.

Exemplos de Requisicao

Exemplo Texto para Imagem (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2img",
    "prompt": "A serene mountain landscape at sunset"
  }'

Exemplo Texto para Video (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2video",
    "prompt": "A timelapse of clouds moving over mountains"
  }'

Exemplo Imagem para Video (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "img2video",
    "image_urls": ["https://example.com/image.jpg"]
  }'

Resposta de Sucesso

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS"
  }
}

Resposta de Erro

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

Verificar Status

GEThttps://grok5ai.com/api/status

Consulte este endpoint para verificar o progresso da sua tarefa. Recomendamos consultar a cada 5-10 segundos.

Parametros de Consulta

Parametro	Tipo	Descricao
task_id	string	O ID da tarefa recebido do endpoint de geracao. Obrigatorio

Valores de Status

PENDINGTarefa na fila

IN_PROGRESSEm processamento

SUCCESSConcluido

FAILEDOcorreu um erro

cURL

curl -X GET "https://grok5ai.com/api/status?task_id=grok5abc123def456img" \
  -H "Authorization: Bearer YOUR_API_KEY"

Resposta (Em Andamento)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}

Resposta (Concluida)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}

Resposta (Falhou)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Codigos de Erro

Codigo	Descricao
200	Sucesso
400	Bad Request - Parametros invalidos (prompt ausente, modelo invalido, etc.)
401	Unauthorized - Chave de API ausente ou invalida
404	Not Found - O ID da tarefa nao existe
500	Internal Server Error - Por favor, tente novamente ou entre em contato com o suporte

Precisa de Ajuda?

Confira nosso canal de suporte ou envie-nos um e-mail.

Contatar Suporte