Documentação da API Mini cpm

Autenticação e URL Base

Inicie cada solicitação com sua chave de API e a URL base correta. Usamos cabeçalhos padrão da OpenAI para compatibilidade. Sua chave concede acesso imediato ao modelo sem censura. A URL base é HTTPS://api.cpmmini.com/v1. Use o cabeçalho Authorization: Bearer . Mantenha sua chave segura. Ela identifica sua conta de crédito pré-pago. Não há taxas de assinatura aqui. Pague apenas por token utilizado.

Primeira solicitação

Envie sua primeira mensagem para o endpoint de conclusões de chat. Isso confirma que sua chave funciona e que os créditos são deduzidos corretamente. O modelo uncensored responde sem as recusas típicas. Use curl para um teste rápido. Substitua YOUR_API_KEY pela sua chave real do painel. Esta etapa verifica a conectividade e a latência. Erros como 401 indicam uma chave inválida. Verifique o painel da sua conta se falhar. A resposta retorna o texto gerado.

Integração do SDK Python

Use a biblioteca oficial da OpenAI para Python para acesso programático. Defina a URL base para o nosso endpoint. Isso garante que todas as requisições sejam roteadas para nosso modelo sem censura. Instale a biblioteca via pip. Passe sua chave da API na inicialização do cliente. Solicite o modelo uncensored. O SDK cuida de retentativas e análise de JSON. Essa abordagem simplifica a integração em seus bots existentes. Também funciona com loops assíncronos. Verifique o saldo de crédito após a chamada.

Configuração do SDK Node

Integre com Node.js usando o pacote npm. Configure a URL base para apontar para nossa API. Isso mantém a compatibilidade com os padrões do OpenAI. Instale a dependência em seu projeto. Inicialize o cliente com sua chave. Chame o método de conclusões de chat. O objeto de resposta contém o texto gerado. Lidar com erros com graça em sua aplicação. Esta configuração suporta tanto CommonJS quanto módulos ES. É ideal para chatbots do lado do servidor.

Respostas em Streaming

Transmita tokens para experiências de usuário em tempo real. Ative o streaming nos parâmetros da solicitação. A API envia blocos conforme são gerados. Isso reduz a latência percebida para os usuários. Use o endpoint SSE para dados contínuos. Analise cada bloco para construir a mensagem final. Este recurso funciona com SDKs Python e Node. É essencial para interfaces de chat. Monitore o uso de tokens no último bloco. Seu crédito é deduzido com base no total de tokens enviados.

Limites, Erros e Contexto

Monitore seus limites de taxa e o status do crédito. Você tem direito a 300 solicitações por minuto. Apenas oito solicitações simultâneas por chave são permitidas. Um erro 429 significa que você atingiu o limite. Um erro 402 indica crédito insuficiente. Recarregue com criptomoedas para continuar. A janela de contexto suporta 100.000 tokens. Isso permite conversas longas sem perder o histórico. Erros e recusas não custam créditos. Seu crédito pré-pago nunca expira. Gerencie suas chaves no painel.

cURL

Copycurl https://api.cpmmini.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send test message"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)