PT ▾
Obter chave de API

kimiapikey.comDocs

API Kimi: primeira requisição em cinco minutos

Obtenha sua primeira resposta em menos de cinco minutos usando a interface compatível com OpenAI. Este guia cobre configuração, autenticação e uso básico do modelo sem censura.

Obter chave de API

Pré-requisitos

Para começar, você precisa de uma chave de API de kimiapikey.com. Entre apenas com e-mail e senha; não é necessário cartão de crédito para o teste. Você também precisa de um ambiente de linguagem compatível com um SDK oficial ou compatível instalado. Nossa API segue o formato de chat-completions do OpenAI, então o código existente para GPT-3.5/4 geralmente funciona com alterações mínimas. Certifique-se de que a versão do seu SDK seja recente o suficiente para suportar o parâmetro base_url.

URL base e autenticação

Nossa API está em https://api.kimiapikey.com/v1. A autenticação é feita por meio do cabeçalho Authorization padrão. Envie sua chave como token Bearer. Isso funciona com qualquer cliente que aceite endpoints compatíveis com OpenAI. Se você estiver usando um proxy ou cliente personalizado, certifique-se de que ele encaminhe corretamente o cabeçalho Authorization. O ID do modelo que você solicitará é uncensored.

Primeira requisição

Envie uma conclusão de chat simples para verificar sua configuração. Use o comando curl abaixo, substituindo YOUR_API_KEY pela sua chave real. Esta requisição envia um prompt curto para o modelo uncensored. Se for bem-sucedida, você receberá uma resposta JSON contendo a resposta do modelo. Verifique o array choices para ver o texto gerado. Se você receber um erro 401, sua chave é inválida ou expirada.

SDK Python

Use a biblioteca oficial Python da OpenAI para a integração mais fácil. Defina o base_url para nosso endpoint e forneça sua chave. Este exemplo demonstra uma chamada básica de geração de texto. Você pode ajustar o parâmetro model se necessário, embora uncensored seja o padrão. Esta abordagem mantém seu código portátil entre diferentes serviços compatíveis com OpenAI.

SDK Node.js

Para projetos JavaScript/TypeScript, use o pacote npm openai. Configure o cliente com nossa URL base e sua chave de API. Isso permite que você faça requisições diretamente do seu ambiente Node. A sintaxe espelha o SDK Python, garantindo consistência se você mudar de linguagem. Lembre-se de lidar corretamente com as respostas assíncronas usando await.

Respostas em streaming

Para saída em tempo real, ative o streaming no seu SDK. Isso envia pedaços de texto conforme são gerados, reduzindo a latência percebida. Use a flag stream na sua requisição. O SDK retornará respostas parciais, permitindo que você atualize a interface do usuário incrementalmente. Isso é ideal para interfaces de chat ou geração de conteúdo longo, onde o feedback imediato é valioso.

Limites e erros

Cada chave está limitada a 300 requisições por minuto. Se você exceder isso, receberá um erro 429. O corpo da sua requisição não deve exceder 8 MB. Uma janela de contexto de 100.000 tokens aplica-se à soma do prompt e da conclusão. Erros comuns incluem 401 (chave inválida) e 402 (crédito insuficiente). Recarregue via painel para continuar usando a API. Os créditos nunca expiram e não há mensalidades.

cURL

curl https://api.kimiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

from openai import OpenAI

client = OpenAI(base_url="https://api.kimiapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.kimiapikey.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Streaming

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Perguntas e respostas

A API suporta chamada de funções?

Sim, o endpoint suporta chamada de ferramentas/funções no formato padrão do OpenAI. Você pode definir ferramentas na sua requisição e o modelo retornará argumentos estruturados.

O que acontece se eu exceder o limite de requisições?

Você receberá um erro 429 Muitas Requisições. Aguarde brevemente e tente novamente, ou atualize o nível de crédito pré-pago para manter maior capacidade.

O modelo é treinado com os meus dados?

Não. Os prompts enviados para a API não são usados para treinamento. Seus dados permanecem privados e não são usados para melhorar o modelo base.

Sua chave está a um formulário de distância

Crie uma conta, copie a chave, altere a URL base. Essa é toda a configuração.

Obter chave de APILer a documentação

Especificações técnicas

Todos os limites e recursos reais da API em um só lugar — confira antes de recarregar.

ItemValor
Formatocompatível com OpenAI: qualquer SDK da OpenAI funciona trocando a base URL e a chave
ID do modelouncensored
AutenticaçãoAuthorization: Bearer YOUR_KEY
EndpointsPOST /v1/chat/completions · GET /v1/models
Base URLhttps://api.kimiapikey.com/v1
Saída máximaaté o restante da janela de 100.000 tokens; max_tokens opcional (sem limite separado)
Parâmetrostemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Chamada de funçõessim — tools, tool_choice; resposta com tool_calls, inclusive em streaming; resultados como role: tool
Streamingsim — server-sent events; o último bloco traz o uso de tokens
Janela de contexto100.000 tokens (entrada + saída)
Modo JSONresponse_format: {"type": "json_object"}
Concorrência8 requisições ao mesmo tempo por chave
Limite de taxa300 requisições por minuto por chave
CabeçalhosX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Tamanhoaté 8 MB por requisição
Preço$0,15 por 1M tokens de entrada · $0,50 por 1M de saída
Cobrançacrédito pré-pago pelo uso real; erros e recusas são grátis
Bônus+5% a partir de $50, +10% a partir de $100, +15% a partir de $200
Validadecrédito pago não expira, sem assinatura
RecargaUSDT (TRC20) ou USDC (Base), qualquer valor inteiro de $20 a $500
Teste grátis$0,50 por 7 dias, sem cartão · Chave de teste: 2 requisições paralelas, 60 por minuto; limites totais (8 e 300) após a primeira recarga
Chavesuma chave ativa por conta; uma nova substitui a anterior
LoginGoogle ou e-mail e senha
Conteúdoconteúdo adulto permitido; conteúdo sexual com menores é recusado

Erros e o que fazer

Erros chegam em JSON com um type fixo; requisições com falha ou recusadas não são cobradas.

CódigoTipoSignificado
400bad_requestJSON inválido, mensagens vazias, parâmetro errado ou contexto longo demais
401missing_key · invalid_key · key_revokedchave ausente, errada ou substituída
402no_creditsem crédito — recarregue e continue na hora
403content_blockedconteúdo sexual com menores — recusado, sem cobrança
404not_foundendpoint desconhecido
413request_too_largecorpo acima de 8 MB
429rate_limited · concurrencyacima de 300/min ou 8 em paralelo — aguarde e tente de novo
503upstream_busymodelo ocupado — tente em alguns segundos