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

POST/v1/chat/completions

Kimi K3

ID da solicitação k3

Protocolos

POST /v1/chat/completions · Chat Completions · exemplo
POST /v1/messages · Anthropic Messages · exemplo
POST /v1/messages/count_tokens · Count Tokens · exemplo
POST /v1/responses · OpenAI Responses · exemplo
POST /v1/responses/compact · Responses Compact · 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/chat/completions`

Campo	Tipo	Obrigatório	Descrição
`model`	`string`	Obrigatório	Defina o ID do modelo como `k3`.
`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.
`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.
`reasoning_effort`	`string`	Condicional	Nível de esforço de raciocínio solicitado. Os níveis disponíveis e a possibilidade de desativá-lo dependem do modelo e do endpoint.
`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 `k3`.
`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.
`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.

`POST /v1/messages/count_tokens`

Campo	Tipo	Obrigatório	Descrição
`model`	`string`	Obrigatório	Defina o ID do modelo como `k3`.
`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.
`system`	`string / object[]`	Opcional	Instruções de sistema em texto ou em um array de blocos de texto.
`tools`	`object[]`	Condicional	Definições de ferramentas incluídas na contagem de tokens de entrada. Envie as mesmas do pedido Messages.

`POST /v1/responses`

Campo	Tipo	Obrigatório	Descrição
`model`	`string`	Obrigatório	Defina o ID do modelo como `k3`.
`input`	`string / object[]`	Obrigatório	Texto de entrada ou array ordenado de itens. Itens de mensagem usam `role` e `content`.
`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.
`reasoning.effort`	`string`	Condicional	Nível de esforço de raciocínio solicitado. Os níveis disponíveis e a possibilidade de desativá-lo dependem do modelo e do endpoint.
`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 `k3`.
`input`	`string / object[]`	Obrigatório	Contexto a compactar. Envie texto ou os itens da conversa na ordem original. Os formatos aceitos dependem do endpoint.

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.

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": "k3",
  "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": "k3",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

Count Tokens

bash

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

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": "k3",
  "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": "k3",
  "input": "Explain how a rainbow forms in one sentence."
}'

Ler a resposta

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
Count Tokens · Leia a contagem de tokens de entrada em input_tokens.
OpenAI Responses · Em streaming, concatene os campos delta dos eventos response.output_text.delta e trate os eventos de conclusão e falha. SSE

Guia completo de integração

Recursos e limites

streaming · Compatível
tool_calling · Compatível
image_input · Não publicado
video_input · Não publicado

Aliases de compatibilidade e redirecionamentos aposentados

kimi-k3, k3[1m] → k3 (Alias)

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

Configurar Kimi Code: API Key, K3.1 Pro e Claude Code

Configure K3.1 Pro no Kimi Code CLI ou Claude Code. Compare opções persistentes e temporárias, valide a primeira chamada e resolva erros 401, de modelo e URL.

Chat Completions

Envie uma conversa no formato OpenAI Chat. Antes da requisição, confirme se o modelo e o endpoint escolhido aceitam o protocolo Chat.

Anthropic Messages

Envie uma requisição HTTP no formato Anthropic Messages. Para configurar o Claude Code, consulte os guias relacionados.

Criar conta e obter uma API Key

Kimi K3

Protocolos

Autenticação

Parâmetros da requisição

POST /v1/chat/completions

POST /v1/messages

POST /v1/messages/count_tokens

POST /v1/responses

POST /v1/responses/compact

Exemplos de requisição

Chat Completions

Anthropic Messages

Count Tokens

OpenAI Responses

Responses Compact

Ler a resposta

Recursos e limites

Aliases de compatibilidade e redirecionamentos aposentados

Guias relacionados

Configurar Kimi Code: API Key, K3.1 Pro e Claude Code

Chat Completions

Anthropic Messages

`POST /v1/chat/completions`

`POST /v1/messages`

`POST /v1/messages/count_tokens`

`POST /v1/responses`

`POST /v1/responses/compact`