Modelos de textoUsuários avançadosAtualizado em 2026-11-11

POST/v1/responses

Grok 4.7

ID da solicitação grok-4.7

Protocolos

POST /v1/responses · OpenAI Responses · exemplo
POST /v1/responses/compact · Responses Compact · exemplo
POST /v1/chat/completions · Chat Completions · exemplo
POST /v1/messages · Anthropic Messages · 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
Anthropic Messages · x-api-key: YOUR_API_KEY

Parâmetros da requisição

`POST /v1/responses`

Campo	Tipo	Obrigatório	Descrição
`model`	`string`	Obrigatório	Defina o ID do modelo como `grok-4.7`.
`input`	`string / object[]`	Obrigatório	Texto de entrada ou array ordenado de itens. Itens de mensagem usam `role` e `content`.
`input[].content[]`	`object`	Condicional	Para imagens, use um bloco de conteúdo com `type: input_image`. Os formatos aceitos dependem do endpoint.
`instructions`	`string`	Opcional	Instruções para o modelo sobre a tarefa e os requisitos da saída.
`max_output_tokens`	`integer`	Opcional	Limita o número de tokens de saída. O limite aceito depende do modelo e do endpoint.
`stream`	`boolean`	Opcional	`true` solicita um fluxo SSE. `false` solicita uma resposta JSON. Os modos disponíveis dependem do endpoint.
`store`	`boolean`	Condicional	Quando o campo for aceito, `false` solicita que a resposta não seja armazenada para recuperação posterior.
`text.format`	`object`	Condicional	Use `text.format` para saída estruturada, por exemplo `type: json_schema`. Use apenas em endpoints que aceitem o formato.
`temperature`	`number`	Condicional	Controla a aleatoriedade da amostragem. Os valores aceitos e a aplicação do campo dependem do modelo e do endpoint.
`top_p`	`number`	Condicional	Limita candidatos da amostragem por probabilidade acumulada. Use quando o modelo e o endpoint oferecerem suporte.
`tools`	`object[]`	Condicional	Definições das ferramentas disponíveis ao modelo. Os tipos de ferramenta e formatos de parâmetros dependem do protocolo e do endpoint.
`tool_choice`	`string / object`	Condicional	Controla a seleção de ferramentas. Use seleção forçada ou nominal apenas se o endpoint oferecer suporte.

`POST /v1/responses/compact`

Campo	Tipo	Obrigatório	Descrição
`model`	`string`	Obrigatório	Defina o ID do modelo como `grok-4.7`.
`input`	`string / object[]`	Obrigatório	Contexto a compactar. Envie texto ou os itens da conversa na ordem original. Os formatos aceitos dependem do endpoint.

`POST /v1/chat/completions`

Campo	Tipo	Obrigatório	Descrição
`model`	`string`	Obrigatório	Defina o ID do modelo como `grok-4.7`.
`messages`	`object[]`	Obrigatório	Envie as mensagens na ordem da conversa. Cada mensagem contém `role` e `content`.
`messages[].content`	`string / object[]`	Condicional	Corpo da mensagem. Use texto simples ou um array de blocos de conteúdo definidos pelo protocolo.
`messages[].content[]`	`object`	Condicional	Para imagens, use um bloco de conteúdo com `type: image_url`. Os formatos aceitos dependem do endpoint.
`stream`	`boolean`	Opcional	`true` solicita um fluxo SSE. `false` solicita uma resposta JSON. Os modos disponíveis dependem do endpoint.
`max_completion_tokens`	`integer`	Condicional	Limita os tokens gerados, incluindo tokens de raciocínio quando aplicável. Use em endpoints que aceitem o campo.
`max_tokens`	`integer`	Condicional	Campo de compatibilidade para limitar tokens de saída. Use este campo ou `max_completion_tokens` conforme o endpoint.
`temperature`	`number`	Condicional	Controla a aleatoriedade da amostragem. Os valores aceitos e a aplicação do campo dependem do modelo e do endpoint.
`top_p`	`number`	Condicional	Limita candidatos da amostragem por probabilidade acumulada. Use quando o modelo e o endpoint oferecerem suporte.
`response_format`	`object`	Condicional	Para saída estruturada, use `type: json_object`, ou `type: json_schema` com `json_schema` quando o endpoint aceitar esquemas.
`tools`	`object[]`	Condicional	Definições das ferramentas disponíveis ao modelo. Os tipos de ferramenta e formatos de parâmetros dependem do protocolo e do endpoint.
`tool_choice`	`string / object`	Condicional	Controla a seleção de ferramentas. Use seleção forçada ou nominal apenas se o endpoint oferecer suporte.

`POST /v1/messages`

Campo	Tipo	Obrigatório	Descrição
`model`	`string`	Obrigatório	Defina o ID do modelo como `grok-4.7`.
`messages`	`object[]`	Obrigatório	Envie as mensagens `user` e `assistant` em ordem. Coloque instruções de sistema no campo `system` de nível superior.
`messages[].content`	`string / object[]`	Obrigatório	Corpo da mensagem. Use texto simples ou um array de blocos de conteúdo definidos pelo protocolo.
`messages[].content[]`	`object`	Condicional	Use um bloco de conteúdo com `type: image` e coloque os dados da imagem em `source`. Os formatos aceitos dependem do endpoint.
`system`	`string / object[]`	Opcional	Instruções de sistema em texto ou em um array de blocos de texto.
`max_tokens`	`integer`	Obrigatório	Limita o número de tokens de saída. O limite aceito depende do modelo e do endpoint.
`stream`	`boolean`	Opcional	`true` solicita um fluxo SSE. `false` solicita uma resposta JSON. Os modos disponíveis dependem do endpoint.
`temperature`	`number`	Condicional	Controla a aleatoriedade da amostragem. Os valores aceitos e a aplicação do campo dependem do modelo e do endpoint.
`top_p`	`number`	Condicional	Limita candidatos da amostragem por probabilidade acumulada. Use quando o modelo e o endpoint oferecerem suporte.
`tools`	`object[]`	Condicional	Definições das ferramentas disponíveis ao modelo. Os tipos de ferramenta e formatos de parâmetros dependem do protocolo e do endpoint.
`tool_choice`	`object`	Condicional	Controla a seleção de ferramentas. Use seleção forçada ou nominal apenas se o endpoint oferecer suporte.

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.

OpenAI Responses

bash

curl -N -sS 'https://api.icodeeasy.cc/v1/responses' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "grok-4.7",
  "instructions": "You are a helpful assistant.",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ],
  "stream": true,
  "store": false
}'

Responses Compact

bash

curl -sS 'https://api.icodeeasy.cc/v1/responses/compact' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "grok-4.7",
  "input": "Explain how a rainbow forms in one sentence."
}'

Chat Completions

bash

curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "grok-4.7",
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ],
  "stream": false
}'

Anthropic Messages

bash

curl -sS 'https://api.icodeeasy.cc/v1/messages' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "grok-4.7",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

Ler a resposta

OpenAI Responses · Em streaming, concatene os campos delta dos eventos response.output_text.delta e trate os eventos de conclusão e falha. SSE
Chat Completions · Leia o texto em choices[].message.content. Em um fluxo SSE, os incrementos aparecem em choices[].delta. JSON · SSE
Anthropic Messages · Leia os blocos do tipo text em content[]. Em streaming, processe os eventos SSE de blocos de conteúdo na ordem. JSON · SSE

Guia completo de integração

Recursos e limites

streaming · Compatível
tool_calling · Compatível
image_input · Condicional — Depende do endpoint compatível e do formato da solicitação
video_input · Não compatível

Aliases de compatibilidade e redirecionamentos aposentados

grok-4.5 → grok-4.7 (Alias)

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

API Grok 4.7 e configuração do Claude Code

Configure Grok 4.7 no Claude Code com uma chave I Code Easy em macOS, Linux ou Windows. Verifique requisições, resolva erros e diferencie texto dos modelos Imagine.

OpenAI Responses

Envie uma entrada no formato OpenAI Responses. O exemplo usa streaming via HTTP. Veja o guia relacionado para configurar o Codex.

Guia avançado do config.toml do Codex

Configure modelos, esforço de raciocínio, credenciais, providers, profiles e compatibilidade no config.toml sem usar campos obsoletos.

Criar conta e obter uma API Key

Grok 4.7

Protocolos

Autenticação

Parâmetros da requisição

POST /v1/responses

POST /v1/responses/compact

POST /v1/chat/completions

POST /v1/messages

Exemplos de requisição

OpenAI Responses

Responses Compact

Chat Completions

Anthropic Messages

Ler a resposta

Recursos e limites

Aliases de compatibilidade e redirecionamentos aposentados

Guias relacionados

API Grok 4.7 e configuração do Claude Code

OpenAI Responses

Guia avançado do config.toml do Codex

`POST /v1/responses`

`POST /v1/responses/compact`

`POST /v1/chat/completions`

`POST /v1/messages`