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.
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.
Especificações técnicas
Todos os limites e recursos reais da API em um só lugar — confira antes de recarregar.
| Item | Valor |
|---|---|
| Formato | compatível com OpenAI: qualquer SDK da OpenAI funciona trocando a base URL e a chave |
| ID do modelo | uncensored |
| Autenticação | Authorization: Bearer YOUR_KEY |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| Saída máxima | até o restante da janela de 100.000 tokens; max_tokens opcional (sem limite separado) |
| Parâmetros | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Chamada de funções | sim — tools, tool_choice; resposta com tool_calls, inclusive em streaming; resultados como role: tool |
| Streaming | sim — server-sent events; o último bloco traz o uso de tokens |
| Janela de contexto | 100.000 tokens (entrada + saída) |
| Modo JSON | response_format: {"type": "json_object"} |
| Concorrência | 8 requisições ao mesmo tempo por chave |
| Limite de taxa | 300 requisições por minuto por chave |
| Cabeçalhos | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Tamanho | até 8 MB por requisição |
| Preço | $0,15 por 1M tokens de entrada · $0,50 por 1M de saída |
| Cobrança | cré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 |
| Validade | crédito pago não expira, sem assinatura |
| Recarga | USDT (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 |
| Chaves | uma chave ativa por conta; uma nova substitui a anterior |
| Login | Google ou e-mail e senha |
| Conteúdo | conteú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ódigo | Tipo | Significado |
|---|---|---|
400 | bad_request | JSON inválido, mensagens vazias, parâmetro errado ou contexto longo demais |
401 | missing_key · invalid_key · key_revoked | chave ausente, errada ou substituída |
402 | no_credit | sem crédito — recarregue e continue na hora |
403 | content_blocked | conteúdo sexual com menores — recusado, sem cobrança |
404 | not_found | endpoint desconhecido |
413 | request_too_large | corpo acima de 8 MB |
429 | rate_limited · concurrency | acima de 300/min ou 8 em paralelo — aguarde e tente de novo |
503 | upstream_busy | modelo ocupado — tente em alguns segundos |