Como usar uma API compatível com OpenAI em 5 etapas
Usar uma API no estilo OpenAI requer cinco passos: obter uma chave, instalar um SDK, apontá-lo para a URL base correta, nomear um modelo e enviar mensagens. Veja cada um com código pronto para copiar.

Pontos principais
- Qualquer SDK da OpenAI funciona aqui após você alterar a URL base para https://api.uncensoredaiapis.com/v1 e usar sua própria chave.
- O ID do modelo é uncensored; as principais rotas são POST /v1/chat/completions e GET /v1/models.
- Streaming, modo JSON e chamada de funções usam os mesmos parâmetros da API oficial.
- O preço é $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída, e você pode começar com $0,50 de crédito de teste.
O resumo
Se você quer saber como usar chamadas da API OpenAI com um serviço que não é a OpenAI, a resposta é que o formato de requisição é uma convenção compartilhada. Um cliente que a utiliza precisa de três valores: onde enviar requisições (a URL base), quem você é (a chave) e qual modelo executar. Altere esses três e o mesmo código funciona. Este site segue essa convenção, então os pacotes padrão Python e Node.js da OpenAI, e curl puro, funcionam contra ele.
Fique claro sobre o que isso significa e o que não significa. Compatível significa que a interface corresponde. Não significa que este é o serviço oficial da OpenAI ou que executa modelos da OpenAI. O backend é um modelo de pesos abertos, executado por um provedor independente e ajustado para responder sem recusas de conteúdo para uso adulto legal, e você o seleciona com o ID do modelo uncensored. Ele lida apenas com texto: sem imagens, áudio, embeddings ou fine-tuning.
As cinco etapas abaixo levam cerca de dez minutos. Se preferir ler snippets prontos em vários idiomas, consulte a página de exemplos de código.
Passo 1: obter uma chave
Cadastre-se com Google, ou com e-mail e senha, e abra a página de chave de API. Novos usuários podem resgatar $0,50 de crédito de teste com um clique. É válido por 7 dias, limitado a um por pessoa e não precisa de cartão. Copie a chave e armazene-a como uma variável de ambiente em vez de colá-la no código:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"A chave de teste permite 2 requisições simultâneas e 60 requisições por minuto. Uma chave com fundos permite 8 simultâneas e 300 por minuto. Os detalhes do que o teste inclui estão na FAQ do teste grátis.
Etapa 2: instalar um SDK e enviar a primeira requisição
Instale o pacote oficial para sua linguagem. Ambos são as mesmas bibliotecas que você usaria para qualquer serviço no estilo OpenAI:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openaiAgora uma primeira chamada em Python. A única diferença da configuração padrão é o argumento base_url:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)E a mesma chamada em Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);Etapa 3: entender o array de mensagens
Modelos de chat não lembram nada entre as chamadas. Cada requisição carrega toda a conversa como uma lista de mensagens, e cada mensagem tem um papel.
systemdefine comportamento e estilo. Coloque a persona, regras de formato e restrições aqui.usercontém o que a pessoa perguntou.assistantcontém as respostas anteriores do modelo. Você as adiciona você mesmo ao continuar uma conversa.toolcarrega o resultado de uma chamada de função, coberto abaixo.
Para continuar um chat, anexe a resposta do assistente e a próxima mensagem do usuário à mesma lista e envie tudo novamente. É por isso que conversas longas custam mais: cada chamada paga pelos tokens de entrada do histórico completo. A janela comporta 100.000 tokens no total, prompt e resposta juntos, então remover turnos antigos é uma parte normal da construção de um app de chat.
Os campos de amostragem úteis são passados: temperature, top_p, stop, seed e as penalidades de frequência e presença. max_tokens é opcional. Defina-o quando quiser limitar o comprimento da resposta e o gasto.
Etapa 4: streaming, modo JSON e ferramentas
Streaming
Adicione stream: true para receber tokens como eventos enviados pelo servidor. Isso faz as interfaces parecerem rápidas, pois o texto aparece enquanto o modelo ainda está escrevendo, e o uso é relatado no final do stream.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}Modo JSON
Use response_format: {"type": "json_object"} quando seu código analisar a resposta. Descreva as chaves desejadas também no prompt.
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'Chamada de ferramentas
Passe uma lista de tools com esquemas de função, e opcionalmente tool_choice. Quando o modelo quiser executar uma função, a resposta conterá tool_calls. Você executa a função no seu próprio código e envia a saída de volta como uma mensagem com role tool. Chamadas de ferramentas também fazem streaming. Este é o bloco de construção para agentes; a página de casos de uso mostra onde isso compensa.
Etapa 5: conhecer os limites, custos e erros
Acima do limite, a API retorna HTTP 429. O código de erro é rate_limited para muitas requisições por minuto e concurrency para muitas de uma vez. Uma sobrecarga temporária também gera 429, com o cabeçalho Retry-After: 5. Uma requisição em streaming mantém seu slot de concorrência até o fim do stream, então feche streams que você não está mais lendo. O limite do corpo é 8 MB. Cada resposta carrega os cabeçalhos X-Request-Id e X-Balance-USD, e o primeiro é o que você cita para o suporte.
Os custos são simples. Uma chamada de chat com 3.000 tokens de entrada e 700 de saída custa 3.000 vezes $0,15 por milhão, que é $0,00045, mais 700 vezes $0,50 por milhão, que é $0,00035, totalizando $0,0008. Mil chamadas assim custam $0,80. Requisições falhas ou recusadas não são cobradas, e o crédito nunca expira. A página de preços lista recargas de $20 a $500 com +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Você pode pagar apenas com cripto (USDT na TRC20, USDC na Base).
Como isso difere da API oficial
Três diferenças valem a pena planejar. Primeiro, o nome do modelo: use uncensored, não um nome de modelo da OpenAI. Segundo, o escopo: você recebe apenas completions de chat e a lista de modelos, então recursos como geração de imagem, fala, embeddings e fine-tuning não estão aqui. Terceiro, o comportamento: o modelo é ajustado para não recusar solicitações adultas legais, então a saída pode diferir de um assistente fortemente filtrado. Uma regra nunca muda: sem conteúdo sexual envolvendo menores de idade.
Alguns hábitos ajudam no primeiro dia. Mantenha a chave em uma variável de ambiente, registre o X-Request-Id de cada chamada e defina max_tokens enquanto experimenta para que uma resposta descontrolada não gaste mais do que você planejou. Ao construir uma interface de chat, faça streaming da resposta e reduza turnos antigos quando o histórico crescer. Ao construir um pipeline que analisa saída, use o modo JSON e ainda proteja a análise, porque uma resposta cortada no limite de tokens não é JSON válido. E quando duas partes do seu programa chamam a API ao mesmo tempo, conte-as contra as 8 requisições simultâneas que uma chave completa permite.
Não esqueça o custo dos testes. Algumas dezenas de experimentos com prompts curtos custam muito menos de um centavo no total, então o crédito de teste de $0,50 rende muito enquanto você aprende o formato de requisição.
Se você está migrando um app existente, o guia de migração percorre as alterações em ordem. Prompts enviados aqui não são usados para treinamento. Para a maioria dos apps, a migração são os três valores do início desta página e um nome de modelo.
Mais guias
Perguntas e respostas
Preciso do SDK oficial da OpenAI?
Você pode usá-lo, e é a rota mais fácil. Qualquer cliente compatível com OpenAI ou HTTP puro também funciona, desde que suporte uma URL base personalizada.
Qual nome de modelo eu envio?
Envie uncensored. A URL base é https://api.uncensoredaiapis.com/v1.
Esta é a API oficial da OpenAI?
Não. Segue o mesmo formato de requisição, mas o modelo é um modelo de pesos abertos executado por um provedor independente, e o serviço é separado da OpenAI.
Quanto custa uma requisição?
Tokens de entrada custam $0,15 por 1M e tokens de saída $0,50 por 1M. Uma requisição com 3.000 tokens de entrada e 700 tokens de saída custa cerca de $0,0008.
Posso testar antes de pagar?
Sim. Após o cadastro, você pode resgatar $0,50 de crédito de teste com um clique. É válido por 7 dias e não precisa de cartão.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.