Início rápido para usuários do Kimicode

Pré-requisitos

Antes de escrever código, crie uma conta em kimicode.cc usando Google ou e-mail. Você receberá uma única chave de API imediatamente. Não há verificação por telefone e não é necessário cartão de crédito. Sua conta começa com $0.50 em crédito de teste grátis válido por sete dias. Se precisar de mais capacidade, recarregue via criptomoeda (USDT na rede TRC20 ou USDC na Base) a partir de $10. O crédito nunca expira e erros ou recusas não consomem tokens.

Certifique-se de que seu ambiente de desenvolvimento tenha Node.js (v18+) ou Python 3.8+. Esta API segue estritamente a especificação do cliente openai, o que significa que você pode substituir nosso endpoint sem alterar a lógica da biblioteca. Oferecemos um único modelo sem censura sob o ID uncensored.

Instalar SDK

Instale o SDK oficial da OpenAI para sua linguagem preferida. Isso garante compatibilidade com nossos recursos de streaming, chamada de funções e modo JSON.

Para Python, use pip para instalar a biblioteca padrão:

• pip install openai

Para Node.js, instale o pacote npm:

• npm install openai

Essas bibliotecas lidam automaticamente com a formatação HTTP. Você não precisa de um cliente específico do fornecedor. A API kimicode aceita parâmetros padrão como temperature, top_p e max_tokens.

Inicializar Cliente

Configure seu objeto de cliente com a URL base kimicode e sua chave de API. A URL base é https://api.kimicode.cc/v1. Defina o api_key com o valor recebido no cadastro. Esta configuração substitui o endpoint padrão api.openai.com.

• URL Base: https://api.kimicode.cc/v1
• Modelo: uncensored
• Autenticação: Token Bearer via api_key

Não misture esta chave com outros fornecedores. Ela funciona exclusivamente com o endpoint kimicode. O cliente verificará a chave na primeira requisição. Se a chave for inválida, você receberá um erro 401 imediatamente.

Fazer Requisição

Envie uma requisição padrão de conclusão de chat. O ID do modelo deve ser uncensored. Você pode ajustar max_tokens até 32.000. Se omitido, o padrão é 2.048. A janela de contexto é de 100.000 tokens no total para prompt e conclusão combinados.

• Entrada: Mensagens de texto no array messages.
• Saída: Resposta de texto em choices[0].message.content.

Este endpoint suporta modo JSON via response_format: {"type": "json_object"}. Não suporta embeddings, imagens ou áudio. Foque na geração de texto de alta qualidade sem recusas de conteúdo para tópicos adultos legais.

Respostas em Streaming

Ative o streaming definindo stream: true. A API retorna Server-Sent Events (SSE). Cada chunk contém texto parcial. As estatísticas de uso de tokens são incluídas no último chunk do stream. Isso permite a exibição em tempo real da saída sem aguardar a resposta completa.

• Flag de Stream: Defina como true no corpo da requisição.
• Tipo de Evento: chat.completion.chunk
• Dados: Contém delta.content para partes de texto.

O streaming não altera o preço. Você paga pelos tokens totais processados. Erros durante o streaming são tratados de forma elegante. Se a conexão cair, você pode reiniciar a requisição. O modelo sem censura mantém a coerência mesmo em streams longos dentro do limite de 100k.

Limites, Erros e Contexto

Monitore seus limites de uso: 300 requisições por minuto por chave, 8 requisições simultâneas e um corpo de requisição de 8 MB. Se você exceder o limite de requisições, receberá um erro 429. Se seu crédito pré-pago for esgotado, receberá um erro 402; recarregue via cripto para retomar. Um erro 401 indica uma chave de API inválida ou ausente. Observe que requisições falhas e recusas não consomem tokens. O limite rígido de conteúdo bloqueia conteúdo sexual envolvendo menores. Todo o outro conteúdo adulto legal é permitido.

Chamada de Funções

Defina ferramentas no parâmetro tools. O modelo retorna chamadas de ferramentas na resposta. Use tool_choice para impor comportamento específico. Este recurso funciona idêntico ao padrão da OpenAI. Analise as chamadas de ferramentas no seu código e execute-as. Envie os resultados de volta em mensagens subsequentes. A API kimicode lida com definições de ferramentas de forma eficiente. Certifique-se de que seu esquema JSON seja válido. A chamada de funções não requer créditos adicionais além do uso de tokens. É ideal para construir agentes ou fluxos de extração de dados estruturados.

cURL

Copycurl https://api.kimicode.cc/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

Copyfrom openai import OpenAI

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