Documentação da API - KimiCode
Come a enviar solicitações para nossa API de LLM sem censura em segundos. O serviço é totalmente compatível com OpenAI, então basta alterar a URL base e a chave de API no seu código de cliente existente.
URL Base e Autenticação
Conecte seu código à nossa API atualizando a URL base e fornecendo sua chave no cabeçalho. Suportamos autenticação padrão, então clientes SDK existentes do OpenAI funcionam imediatamente sem configuração complexa. Sua chave de API aparece instantaneamente após o cadastro via Google ou e-mail, sem necessidade de número de telefone.
Cada conta possui uma chave ativa por vez; gerar uma nova chave substitui a anterior. As requisições são autenticadas via cabeçalho Authorization, garantindo acesso seguro ao seu crédito pré-pago.
Primeira solicitação
Envie sua primeira mensagem usando o endpoint padrão de conclusões de chat com uma simples requisição POST. Isso confirma que sua integração funciona antes de você mergulhar em recursos avançados ou dados em streaming. A resposta retorna a saída de texto do modelo uncensored.
- Substitua YOUR_API_KEY pela sua chave do painel.
- Defina o modelo para 'uncensored' para o nosso modelo específico de pesos abertos.
curl https://api.kimicodepricing.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List available plan tiers and token costs"}]
}'
Integração do SDK Python
Use a biblioteca oficial da OpenAI para Python para interagir com nossa API apontando-a para a URL base. Essa abordagem aproveita uma sintaxe familiar, permitindo que você altere de provedor sem reescrever toda a lógica da sua aplicação. A biblioteca cuida automaticamente da tokenização e do formato das requisições.
- Instale o pacote openai via pip.
- Configure a URL base para apontar para nosso serviço.
from openai import OpenAI
client = OpenAI(base_url="https://api.kimicodepricing.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)
Integração do SDK Node
Integre nossa API em suas aplicações JavaScript ou TypeScript usando o SDK Node. Isso garante comportamento consistente entre seus ambientes frontend e backend. Você pode passar mensagens e receber respostas exatamente como faria com qualquer serviço compatível com OpenAI.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimicodepricing.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 e Uso de Tokens
Ative o streaming para receber geração de tokens em tempo real via Server-Sent Events (SSE). Isso reduz a latência percebida para os usuários e permite a exibição imediata de resultados parciais. Os dados de uso de tokens, incluindo contagens de entrada e saída, estão embutidos no último bloco do fluxo.
Esse método é ideal para interfaces de chat onde o feedback instantâneo é importante. Você pode analisar o stream para atualizar a interface do usuário progressivamente sem esperar pela resposta completa.
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)
Limites, Erros e Contexto
Gerencie seu uso entendendo os limites de taxa e os códigos de erro comuns. A API suporta uma janela de contexto de 100.000 tokens, permitindo histórico de conversas profundo. Você está limitado a 300 solicitações por minuto e 8 solicitações simultâneas por chave.
- 401 indica uma chave de API inválida ou ausente.
- 402 sinaliza que seu crédito pré-pago está esgotado.
- 429 significa que você excedeu o limite de taxa.
Erros não consomem seu crédito, então você pode repetir solicitações falhas sem penalidade.
FAQs
Qual é o preço do kimicode por token?
Cobramos $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. Erros e recusas não consomem crédito, portanto, você paga apenas por respostas bem-sucedidas.
A API suporta respostas em streaming?
Sim, a API suporta streaming via Server-Sent Events (SSE). Os detalhes do uso de tokens estão incluídos no último chunk do stream, permitindo que você acompanhe os custos em tempo real.
Como lidar com limites de taxa?
Você está limitado a 300 solicitações por minuto e 8 solicitações simultâneas por chave. Exceder esses limites retorna um código de erro 429, que não deduz do seu crédito.
Sua chave de API aguarda
Cadastre-se, pegue sua chave e substitua a URL base. Pronto.