Guia de Início Rápido da API Kimi

Pré-requisitos: Instalação do SDK

Instale o SDK oficial para sua linguagem para lidar com autenticação e serialização automaticamente. Nossa API adere ao padrão OpenAI, então qualquer biblioteca de cliente compatível funciona com alterações mínimas de configuração.

Para Python, instale a biblioteca via pip. Para Node.js, use npm ou yarn. Essas ferramentas gerenciam o cliente HTTP e a análise JSON para você.

Autenticação: Configurando sua chave de API kimi

Obtenha sua chave no painel e passe-a como Authorization cabeçalho. Use a URL base https://api.apikimi.cc/v1 para todas as solicitações.

Armazene a chave de forma segura em suas variáveis de ambiente ou arquivos de configuração. O formato do cabeçalho é Bearer YOUR_API_KEY.

Enviando sua primeira solicitação

Envie uma requisição POST para /v1/chat/completions com seu ID do modelo uncensored. A resposta retorna o texto gerado diretamente.

Certifique-se de definir o model field correctly. The API returns raw output without content refusals for lawful topics.

Respostas em Streaming

Ative o streaming definindo stream: true no corpo da sua solicitação. Isso retorna chunks como Eventos Enviados pelo Servidor (SSE).

Analise o fluxo SSE para exibir os tokens em tempo real. O último chunk inclui as estatísticas de uso de tokens para faturamento.

Configuração da Chamada de Função

Defina ferramentas no tools array dentro de sua solicitação. O modelo retorna chamadas de ferramentas em vez de texto direto quando apropriado.

Manipule as chamadas de ferramenta na lógica da sua aplicação e envie os resultados de volta para a API para processamento adicional. Suporte para tool_choice permite aplicação rigorosa.

Tratamento de Erros e Limites

Lide com erros HTTP padrão: 401 para chaves inválidas, 402 para crédito insuficiente e 429 para limites de taxa. A janela de contexto suporta 100,000 tokens no total.

A saída máxima é de 16.000 tokens por solicitação. Erros não consomem crédito. Ajuste sua lógica de retry com base no código de erro.

cURL

Copycurl https://api.apikimi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the key differences between Rust and Go memory management"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apikimi.cc/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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apikimi.cc/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

Copystream = 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)