Primeira requisição em cinco minutos

Instale o SDK OpenAI Python/Node

Comece instalando a biblioteca cliente padrão da OpenAI. Isso funciona porque nossa API segue a mesma interface compatível com OpenAI. Você não precisa de um SDK de fornecedor especial. Basta executar pip install openai para Python ou npm install openai para Node.js. A biblioteca cuida da serialização JSON e das requisições HTTP automaticamente.

Configure URL Base e Chave de API

Aponte seu cliente para nosso endpoint. Defina a URL base como https://api.kimiapi.top/v1 e forneça sua chave de API obtida no painel. Esta chave autentica seu crédito pré-pago. Você pode gerar uma nova chave instantaneamente via Google ou e-mail na página de cadastro. Não é necessário cartão de crédito para começar.

Copycurl https://api.kimiapi.top/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."}]
  }'

Envie sua primeira conclusão de chat

Envie uma mensagem simples para o modelo uncensored. Este modelo é ajustado para responder sem recusas para uso adulto lícito. Ele suporta uma janela de contexto de 100.000 tokens, embora a saída máxima seja de 32.000 tokens. A resposta retorna texto diretamente. Erros e recusas não consomem seu crédito.

Copyfrom openai import OpenAI

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

Ative o streaming com SSE

Para respostas em tempo real, ative o streaming. O SDK transmite tokens via Server-Sent Events (SSE). O último chunk contém o uso total de tokens para faturamento. Esta abordagem reduz a latência percebida para saídas longas. Você pode processar cada token conforme ele chega na lógica da sua aplicação.

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)

Use o modo JSON para saída estruturada

Garanta uma saída consistente e legível por máquina definindo response_format como {"type": "json_object"}. Isso força o modelo a retornar JSON válido. É ideal para extração de dados ou geração de configuração. O modelo não quebrará a estrutura, facilitando a análise das respostas no seu código.

Copyimport OpenAI from "openai";

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

Verifique o uso e os custos

Monitore seu uso pelo painel. O custo de entrada é de $0,25 por milhão de tokens; a saída é de $1,00 por milhão de tokens. Se receber 401, verifique sua chave. 402 significa que você precisa recarregar com USDT ou USDC. 429 indica que você atingiu o limite de 300 requisições por minuto. O crédito nunca expira, então recarregue quando for conveniente.