Documentação da API: Endpoints OpenAI-Compatible

Autenticação & URL Base

Acesse a API definindo sua chave exclusiva e a URL base nas variáveis de ambiente. O endpoint está localizado em https://api.apikeykimi.com/v1. Você deve incluir o cabeçalho Authorization: Bearer YOUR_API_KEY com cada solicitação. Esta chave é gerada instantaneamente no cadastro via Google ou e-mail. É a única credencial necessária para autenticação. Nenhuma configuração de escopos ou permissões é necessária.

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

Endpoint Chat Completions

Envie mensagens para o modelo usando o padrão /v1/chat/completions endpoint. endpoint. Especifique o ID do modelo como uncensored no corpo da solicitação. A API retorna texto gerado com base no seu histórico de prompts. Você pode ajustar parâmetros como temperatura e top_p para controlar a criatividade. O modelo suporta chamada de funções e modo JSON para saídas estruturadas.

Copyfrom openai import OpenAI

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

Respostas em Streaming (SSE)

Ativar entrega de tokens em tempo real definindo stream: true na sua solicitação. O servidor retorna um stream de Server-Sent Events. Cada bloco contém texto parcial até que a resposta esteja completa. Isso é ideal para interfaces de chat e exibições de codificação ao vivo. Os detalhes de uso de tokens aparecem no último bloco do stream.

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)

Function Calling & JSON Mode

Defina ferramentas ou force a saída JSON usando o response_format parâmetro. Defina json_object para garantir respostas JSON válidas. Você também pode passar definições de ferramentas para chamada de funções. O modelo adere estritamente a essas restrições. Isso permite uma integração confiável com serviços externos. Use tool_choice para controlar como as ferramentas são invocadas.

Limites de Tokens & Restrições

A janela de contexto suporta até 100.000 tokens para entrada e saída combinadas. A saída máxima por solicitação é de 16.000 tokens. Se você não definir max_tokens, o limite padrão é 2.048 tokens. As solicitações são limitadas a 8 MB no tamanho do corpo. Você está limitado a 300 solicitações por minuto. Apenas 8 solicitações podem ser executadas simultaneamente por chave.

Tratamento de Erros & Limites de Uso

Lide com erros verificando o código de status HTTP. Um 401 indica uma chave de API inválida ou expirada. Um erro 402 significa que seu crédito pré-pago está esgotado. Uma resposta 429 sinaliza que você excedeu o limite de taxa de 300 solicitações por minuto. Erros e recusas não consomem tokens. Verifique seu saldo no painel para evitar interrupções.

Node.js

Copyimport OpenAI from "openai";

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