Guia de Integração para Desenvolvedores

Autenticação e configuração da URL base

Come gerando sua chave de API no painel. A URL base é HTTPS://api.apiaicheap.com/v1. Envie sua chave no cabeçalho Authorization como um token bearer.

• Clique em "Obter chave de API" e faça login com Google ou e-mail.
• Copie a chave imediatamente; ela é mostrada apenas uma vez.

Esta chave autentica todas as solicitações ao endpoint de conclusões de chat.

Cabeçalho de exemplo

Autorização: Bearer SUA_CHAVE_API

Primeira solicitação com cURL

Envie uma conclusão de chat básica para testar sua configuração. Use o endpoint POST /v1/chat/completions com o modelo "uncensored".

Isso confirma seu saldo de créditos e latência.

• Defina o role como "user".
• Mantenha a mensagem simples para o primeiro teste.

Verifique a resposta para um campo de texto gerado.

• Procure pelo valor "content".

Se você receber um 200 OK, sua integração está funcionando.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Integração do SDK Python

Use a biblioteca oficial da OpenAI para Python para uma integração fácil. Aponte-a para a URL base e defina sua chave da API.

Esta abordagem lida com tentativas novamente e análise de JSON automaticamente.

• Instale a biblioteca via pip.
• Defina o parâmetro base_url para o nosso endpoint.

Chame o método chat.completions.create.

Envie sua lista de mensagens como um argumento.

• Inclua o nome do modelo "uncensored".

Acesse o texto da resposta por meio dos atributos do objeto.

Esse método é limpo e legível para scripts de produção.

Copyfrom openai import OpenAI

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

Configuração do SDK Node.js

O SDK Node.js funciona de forma semelhante à versão Python. Inicialize o cliente com sua chave e nossa URL base.

Isso permite que você use padrões assíncronos familiares com await.

• Importe o pacote OpenAI.
• Configure a URL base no construtor.

Crie uma solicitação de conclusão com suas mensagens.

Lide com a promessa para obter o resultado.

• Extraia o conteúdo da mensagem da resposta.

Registre a saída para verificar se o modelo responde corretamente.

Esta configuração é ideal para servidores web e serviços de backend.

Copyimport OpenAI from "openai";

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

Respostas em streaming com SSE

Ative o streaming definindo stream como true na sua solicitação. A API retorna fragmentos conforme são gerados por meio de Eventos Enviados pelo Servidor.

Isso reduz a latência percebida para os usuários em aplicativos de chat.

• Defina stream: true no payload.
• Processe cada chunk conforme chega.

Combine os blocos para formar a resposta final.

Os detalhes de uso de tokens aparecem no último chunk.

• Verifique o campo "usage" no último chunk.

Esta abordagem mantém a interface do usuário responsiva durante gerações longas.

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)

Limites, erros e janela de contexto

Sua conta tem um limite de 300 solicitações por minuto por chave. A janela de contexto suporta 100.000 tokens no total para prompt e conclusão.

Os erros são tratados com códigos de status HTTP padrão.

• 401 indica uma chave de API inválida ou ausente.
• 402 significa que seu crédito pré-pago está esgotado.
• 429 sinaliza que você excedeu o limite de taxa.

As recusas não custam crédito. Erros também são gratuitos.

A saída máxima é de 16.000 tokens por solicitação. Defina max_tokens se precisar de menos.

Essa estrutura garante faturamento e desempenho previsíveis.