DEVELOPER DOCS

Integre em cinco minutos

APIs compatíveis com OpenAI, Anthropic Messages, Responses e Gemini. Confira o suporte a modelo, protocolo e ferramentas antes de integrar.

01

Primeira solicitação

Crie uma chave no painel e execute:

Crie uma chave API no painel, substitua o valor de exemplo abaixo pela sua chave e execute no mesmo terminal dos exemplos. curl, o SDK e os clientes leem essa variável de ambiente.

Shell · Definir a chave API
export KIMISEEK_API_KEY="ks-your-key"
Shell
curl https://api.kimiseek.app/v1/chat/completions \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?Primeiro defina KIMISEEK_API_KEY neste terminal.}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek-v4-pro-0813",
  "max_completion_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello from KimiSeek"
    }
  ]
}'
02

Autenticação

Envie sua chave API KimiSeek em Authorization: Bearer para as APIs OpenAI; Anthropic Messages também aceita x-api-key. Chaves ks- podem ser copiadas na lista de chaves do painel.

Segurança

Não exponha chaves no navegador ou em repositórios públicos.

03

Modelos compatíveis e preços

Copie o ID da tabela para o campo model. Os valores são os preços atuais da KimiSeek para solicitações em tempo real.

Modelo e ID da APIFaixaEntradaEntrada em cacheSaídaContexto
DeepSeek V4 Pro 0813deepseek-v4-pro-0813Alias: deepseek-v4-proProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Pico (01:00–04:00, 06:00–10:00 UTC (Beijing time 09:00–12:00, 14:00–18:00)) · Tarifas por horário a partir de 2026-08-20 13:03:49.577 UTC; antes, tarifa de pico o dia todo¥4.5¥0.15¥13.51M
Fora do pico (fora de 01:00–04:00, 06:00–10:00 UTC (Beijing time 09:00–12:00, 14:00–18:00)) · Tarifas por horário a partir de 2026-08-20 13:03:49.577 UTC; antes, tarifa de pico o dia todo¥2.25¥0.075¥6.75
DeepSeek V4.1 Flashdeepseek-v4.1-flashAlias: deepseek-flashProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Fora do pico (fora de 01:00–04:00, 06:00–10:00 UTC (Beijing time 09:00–12:00, 14:00–18:00)) · Tarifas por horário a partir de 2026-08-16 16:00:00.000 UTC; antes, tarifa de pico o dia todo¥0.5¥0.01¥21M
Pico (01:00–04:00, 06:00–10:00 UTC (Beijing time 09:00–12:00, 14:00–18:00)) · Tarifas por horário a partir de 2026-08-16 16:00:00.000 UTC; antes, tarifa de pico o dia todo¥1¥0.02¥4
Qwen4 Maxqwen4-maxProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Padrão¥8.5¥0.425¥25.51M
GLM-5.3 Flashglm-5.3-flashProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Padrão¥0.4¥0.115¥1.41M
Qwen3.8 Maxqwen3.8-maxProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Padrão¥6¥0.75¥18991K
GLM-5.3glm-5.3Alias: GLM-5.3Protocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Padrão¥4¥1¥141.024M
Kimi K3kimi/kimi-k3Alias: kimi-k3Protocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Padrão¥16¥1.6¥801.048576M
Kimi K3.1 Pro Highspeedkimi/kimi-k3.1-pro-highspeedAlias: kimi-k3.1Alias: kimi-k3.1-proProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Padrão¥13¥0.65¥681.048576M
Qwen3.8 Flashqwen3.8-flashProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Padrão¥0.4¥0.05¥1.351M
Qwen3.8 27Bqwen3.8-27bProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Padrão¥0.9¥0.18¥3.61M
Qwen3.8 2.4T A95Bqwen3.8-2.4t-a95bProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Padrão¥9.6¥1.2¥28.81M
Qwen3.7 Maxqwen3.7-maxProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Padrão¥6¥1.2¥18991K
Qwen3.6 Plusqwen3.6-plusProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Entrada ≤ 256.000 tokens¥1.6Preço de entrada¥9.61M
Entrada ≥ 256.001 tokens¥6.4Preço de entrada¥38.4
Qwen3.7 Plusqwen3.7-plusProtocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Entrada ≤ 256.000 tokens¥1.6¥0.32¥6.41M
Entrada ≥ 256.001 tokens¥4.8¥0.96¥19.2
DeepSeek V4.1 Flash 1017deepseek-v4.1-flash-1017Protocolos disponíveis no momento: OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent.Fora do pico (fora de 01:00–04:00, 06:00–10:00 UTC (Beijing time 09:00–12:00, 14:00–18:00)) · Tarifas por horário a partir de 2026-10-18 23:42:09.074 UTC; antes, tarifa de pico o dia todo¥0.5¥0.05¥21.024M
Pico (01:00–04:00, 06:00–10:00 UTC (Beijing time 09:00–12:00, 14:00–18:00)) · Tarifas por horário a partir de 2026-10-18 23:42:09.074 UTC; antes, tarifa de pico o dia todo¥1¥0.1¥4

Preços dos modelos de imagem

Preços em CNY por imagem, com o desconto atual de cada modelo. Referências e imagens geradas são cobradas separadamente. A tabela mostra as faixas de resolução e a expansão da descrição; sem tarifa específica, aplica-se a saída normal.

Modelo de imagemReferência / imagemSaída / imagemCom expansão / imagem
Qwen Image 3.0 Proqwen-image-3.0-proProtocolos disponíveis no momento: OpenAI Images · /v1/images/generations.¥0.016262.144–2.250.000 pixels¥0.22.250.001–4.194.304 pixels¥0.4—
Qwen Image 3.0qwen-image-3.0Protocolos disponíveis no momento: OpenAI Images · /v1/images/generations.¥0.016262.144–4.194.304 pixels¥0.144—
Wan 2.7 Image Prowan2.7-image-proProtocolos disponíveis no momento: OpenAI Images · /v1/images/generations.¥0589.824–16.777.216 pixels¥0.4—
Wan 2.7 Imagewan2.7-imageProtocolos disponíveis no momento: OpenAI Images · /v1/images/generations.¥0589.824–4.194.304 pixels¥0.16—
Z-Image Turboz-image-turboProtocolos disponíveis no momento: OpenAI Images · /v1/images/generations.¥0262.144–4.194.304 pixels¥0.08262.144–4.194.304 pixels¥0.16

Preços dos modelos de texto em CNY por 1 milhão de tokens. A faixa depende do intervalo de entrada, do início da solicitação e das condições de vigência de cada modelo. Ver preços completos e detalhes do cache explícito

Catálogo público legível por máquina, sem API key: GET https://api.kimiseek.app/v1/models

Exemplos da API

Os exemplos usam modelos e protocolos configurados no momento. Use sua própria chave API KimiSeek.

Shell · OpenAI-compatible
curl https://api.kimiseek.app/v1/chat/completions \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?Primeiro defina KIMISEEK_API_KEY neste terminal.}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek-v4-pro-0813",
  "max_completion_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello from KimiSeek"
    }
  ]
}'
Shell · Anthropic Messages
curl https://api.kimiseek.app/v1/messages \
  -H "x-api-key: ${KIMISEEK_API_KEY:?Primeiro defina KIMISEEK_API_KEY neste terminal.}" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek-v4-pro-0813",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello from KimiSeek"
    }
  ]
}'
Shell · OpenAI Responses
curl https://api.kimiseek.app/v1/responses \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?Primeiro defina KIMISEEK_API_KEY neste terminal.}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek-v4-pro-0813",
  "input": "Hello from KimiSeek",
  "max_output_tokens": 1024
}'
Shell · Gemini
curl https://api.kimiseek.app/v1beta/models/deepseek-v4-pro-0813:generateContent \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?Primeiro defina KIMISEEK_API_KEY neste terminal.}" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Hello from KimiSeek"
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 1024
  }
}'

API de geração de imagens

Use /v1/images/generations para chamar modelos de imagem. Na edição, defina image com referências HTTPS ou URLs de dados de imagem (data URL).

Shell · Images API
curl https://api.kimiseek.app/v1/images/generations \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?Primeiro defina KIMISEEK_API_KEY neste terminal.}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-3.0-pro",
  "prompt": "A red panda reading under a cedar tree",
  "size": "1024x1024",
  "n": 1,
  "prompt_extend": false
}'

SDK oficial da OpenAI

Altere apenas model. Cada chamada segue para o upstream configurado para o modelo.

TypeScript · OpenAI SDK
import OpenAI from "openai";

const apiKey = process.env.KIMISEEK_API_KEY;
if (!apiKey) throw new Error("Primeiro defina KIMISEEK_API_KEY neste terminal.");

const client = new OpenAI({
  apiKey,
  baseURL: "https://api.kimiseek.app/v1",
});

const reply = await client.chat.completions.create({
  model: "deepseek-v4-pro-0813",
  messages: [{ role: "user", content: "Hello from KimiSeek!" }],
  max_completion_tokens: 1024,
});
04

Claude Code e Codex

Configurar com CC Switch

Use a interface do CC Switch para adicionar a KimiSeek separadamente ao Codex e ao Claude Code.

  1. Primeiro, crie ou copie uma chave de API KimiSeek no painel. Gerenciar chaves de API
  2. No CC Switch, selecione Codex ou Claude Code e adicione um provedor personalizado ou edite um existente.
  3. Preencha os dados abaixo. Site e observações são opcionais.
    Nome do provedor
    kimiseek
    API Key
    Sua chave de API KimiSeek (começa com ks-)
    Modelo padrão
    As capturas usam glm-5.3-flash. Você também pode copiar um ID de modelo disponível no catálogo acima.
  4. Informe o endereço da API (Base URL) do cliente indicado abaixo. Deixe a opção URL completa desativada.
  5. Salve, ative a KimiSeek na lista de provedores do cliente e reinicie o cliente. Se usar os dois, configure e ative cada um separadamente.

Codex

Modelo padrão: deepseek-v4-pro-0813

A Base URL do Codex deve incluir o sufixo /v1.
Endereço da API · Base URL
https://api.kimiseek.app/v1
CC Switch · Codex · https://api.kimiseek.app/v1
Codex · Captura da configuração (clique para ampliar)

Claude Code

Modelo padrão: deepseek-v4.1-flash

A Base URL do Claude Code não deve incluir o sufixo /v1.
Endereço da API · Base URL
https://api.kimiseek.app/
CC Switch · Claude Code · https://api.kimiseek.app/
Claude Code · Captura da configuração (clique para ampliar)

Claude Code usa a API compatível com Anthropic Messages.

Shell · Claude Code
export ANTHROPIC_BASE_URL="https://api.kimiseek.app"
export ANTHROPIC_MODEL='deepseek-v4.1-flash'
export ANTHROPIC_AUTH_TOKEN="${KIMISEEK_API_KEY:?Primeiro defina KIMISEEK_API_KEY neste terminal.}" && claude

Codex usa Responses e a variável KIMISEEK_API_KEY.

As ferramentas de cliente Responses suportam apenas funções simples; ferramentas custom, namespace e hospedadas são descartadas e não executadas. Suporte a ferramentas: Codex · Responses

TOML · Codex
model = "deepseek-v4-pro-0813"
model_provider = "kimiseek"

[model_providers.kimiseek]
name = "KimiSeek"
base_url = "https://api.kimiseek.app/v1"
env_key = "KIMISEEK_API_KEY"
wire_api = "responses"
Protocolo Gemini

generateContent e streamGenerateContent aceitam apenas parts[].text; envie a chave em x-goog-api-key. Imagens, arquivos, tools, toolConfig e histórico de chamadas de função retornam HTTP 400 antes do encaminhamento ou cobrança. Para ferramentas, use outra interface compatível e um modelo com esse suporte. A saída também é apenas de texto; geração de áudio ou imagem retorna HTTP 400 antes do encaminhamento ou cobrança.

05

Streaming

Use stream: true para SSE; o uso gerado é cobrado ao concluir ou interromper o fluxo.

Códigos de erro

400Solicitação ou modelo inválido401Chave inválida ou cota esgotada402Saldo CNY insuficiente503Canal de modelo indisponível

Cobrança em CNY

Tokens de entrada, cache e saída são multiplicados pelas tarifas e liquidados em CNY.

Saldo e limites de suspensão

Cada solicitação reserva o custo estimado (no mínimo ¥0.10) no saldo disponível da conta e da chave. Solicitações em andamento e cobranças pendentes também usam esse saldo. Se faltar saldo, aguarde ou reduza o limite de saída ou o orçamento de raciocínio separado.

Cada conta pode executar até 4 solicitações de modelo ao mesmo tempo. A reserva não é uma cobrança; o uso real determina o valor final. O excedente da estimativa também é cobrado e pode deixar o saldo negativo. Recargas cobrem primeiro valores devidos. Sem limite de saída, reserva-se o máximo do modelo. O orçamento de raciocínio separado é somado; se não definido, usa-se conservadoramente o limite de contexto.

Três minutos até a primeira chamada

Crie uma conta e uma chave de API. O custo das chamadas é descontado do seu saldo. 30% de desconto na primeira recarga. Recarregue ¥500, pague ¥350, receba ¥500 de saldo. Recarregue ¥1000, pague ¥850, receba ¥1000 de saldo A recarga mínima continua sendo ¥10, adequada para testes.