Alternativas à API OpenAI: O que muda no seu código
A maioria das alternativas à API OpenAI copia o formato de solicitação da OpenAI, o que significa que a mudança é frequentemente apenas uma alteração de configuração. Este artigo mostra exatamente o que muda no código, o que pode quebrar e onde um endpoint de modelo único compatível com OpenAI é uma boa opção e onde não é.


O que uma alternativa oferece
As pessoas buscam alternativas à API OpenAI por diferentes motivos: preço, regras de conteúdo, tratamento de dados, disponibilidade regional ou o desejo de usar modelos de pesos abertos. Independentemente do motivo, o mesmo teste se aplica. A alternativa aceita o formato de solicitação que você já envia e retorna o formato de resposta que seu código já lê?
Se sim, as chamadas do seu SDK não mudam. Se não, você escreve um adaptador uma vez, o que também é aceitável, mas é o principal custo da mudança. O restante deste artigo assume o primeiro caso, um endpoint compatível com OpenAI.
A mudança de três linhas
Com o pacote Python oficial, a configuração original usa o host padrão e uma chave OpenAI. Para uma alternativa, você define três coisas: o base_url, a chave do novo provedor e o nome do modelo. Aqui está a versão final para este endpoint:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaimodels.com/v1", # was the default host
api_key=os.environ["NEW_PROVIDER_KEY"], # was your OpenAI key
)
r = client.chat.completions.create(
model="uncensored", # was an OpenAI model name
messages=[{"role": "user", "content": "Pitch me a plot twist for a mystery."}],
)
print(r.choices[0].message.content)
O mesmo funciona no Node passando baseURL para o construtor, em wrappers estilo LangChain pela opção de URL base, e em ferramentas que possuem um campo de endpoint personalizado. No curl, altere o host e o cabeçalho:
curl https://api.uncensoredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $NEW_PROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'O que pode quebrar após a troca
Nomes de modelos
Os IDs de modelo pertencem ao provedor. Qualquer coisa que use um nome fixo de modelo da OpenAI precisa ser atualizada. Coloque o nome na configuração.
Parâmetros
Opções principais como temperature, top_p, stop e max_tokens são herdadas. Outras, como logprobs ou certas opções de formato de resposta, dependem do provedor. Neste endpoint, temperature, top_p, stop, seed e as penalidades são passadas, e o modo JSON funciona com response_format: {"type":"json_object"}.
Qualidade da chamada de funções
O formato de serialização é compartilhado, mas a forma como um modelo escolhe ferramentas e preenche argumentos varia. Execute seus esquemas de ferramentas reais no novo modelo e valide os argumentos no seu código.
Comprimento do contexto e truncamento
Uma mudança na janela de contexto altera a quantidade de histórico que você pode enviar. Aqui, a janela é de 100.000 tokens para prompt mais conclusão.
Erros e limites
Provedores usam limites e códigos diferentes. Este retorna HTTP 429 com rate_limited para o limite de requisições por minuto e concurrency para o limite de requisições simultâneas, e um 429 com Retry-After: 5 em sobrecarga temporária. Sua lógica de retry deve lidar com 429 para qualquer provedor.
Comportamento
A maior mudança não é técnica. Modelos diferem em tom, hábitos de formatação e o que eles recusam. Teste com seus prompts reais, não os de demonstração.
Onde um endpoint de modelo único se encaixa
Este serviço é uma API de texto compatível com OpenAI com um único modelo de pesos abertos, operada por um provedor independente e ajustada para responder sem recusas de conteúdo para uso adulto legal. Não é a API oficial da OpenAI, Meta, Mistral, Qwen, DeepSeek, xAI, Google, Anthropic ou qualquer outro fornecedor, e não é um roteador entre fornecedores. O ID do modelo é uncensored.
Ele se encaixa bem nestes casos de uso: ferramentas de ficção e roleplay para adultos, aplicativos de companhia, assistentes de escrita que não devem parar no meio da cena e backends onde o comportamento estável em temas maduros é mais importante do que escolher entre muitos modelos. Também é adequado para desenvolvedores que querem um preço simples por token e prompts que não são usados para treinamento.
Onde não se encaixa
Seja honesto sobre os limites antes de mover o tráfego:
- Um único modelo. Você não pode escolher um modelo menor e mais barato para tarefas fáceis ou um maior para tarefas difíceis. Se você depende de roteamento de modelos, precisa de uma plataforma diferente.
- Apenas texto. Sem geração de imagem, áudio ou vídeo, sem embeddings e sem ajuste fino. Um aplicativo de recuperação que precisa de embeddings deve obtê-los em outro lugar.
- Não é o produto principal de um fornecedor. Se você precisa de um modelo específico nomeado para conformidade ou benchmarks, use esse fornecedor.
- Limite rígido. Sem conteúdo sexual envolvendo menores de idade, nunca.
Muitas equipes executam dois endpoints: um provedor principal e um segundo para conteúdo que o primeiro recusa. Como ambos compartilham o mesmo formato, isso é uma pequena quantidade de código, uma alteração de configuração e um fallback em caso de certos erros.
Custo: como comparar
Verifique a precificação atual de cada provedor e converta para o formato da sua requisição. Para este endpoint, o custo de entrada é $0.15 por 1M de tokens e o de saída $0.50 por 1M. Exemplo: 3.000 tokens de entrada e 500 de saída custam $0,00045 + $0,00025 = $0,00070 por chamada, então 10.000 chamadas por mês custam $7. Requisições falhas ou recusadas não são cobradas, não há assinatura e o crédito nunca expira.
Recargas variam de $20 a $500, por cripto (USDT na TRC20, USDC na Base), com bônus de +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Para uma tabela de como diferentes escolhas de modelos se comparam, consulte comparação de modelos de IA e precificação. A página de precificação tem a lista completa.
Um padrão de fallback para dois endpoints
Se você quiser um segundo endpoint para conteúdo que seu provedor principal recusa, mantenha ambos os clientes e escolha por requisição. Este esboço envia uma requisição para o provedor principal primeiro e tenta o segundo quando a resposta é um marcador de recusa que você define, ou quando uma chamada falha:
import os
from openai import OpenAI
main = OpenAI(api_key=os.environ["MAIN_KEY"])
second = OpenAI(
base_url="https://api.uncensoredaimodels.com/v1",
api_key=os.environ["NEW_PROVIDER_KEY"],
)
def ask(messages, main_model, use_second_first=False):
order = [(second, "uncensored"), (main, main_model)] if use_second_first else [(main, main_model), (second, "uncensored")]
last = None
for client, model in order:
try:
r = client.chat.completions.create(model=model, messages=messages)
return r.choices[0].message.content
except Exception as err:
last = err
raise last
Roteie por tipo de conteúdo onde você puder. Um recurso de escrita de histórias pode ir direto para o segundo endpoint com use_second_first=True, enquanto um assistente de faturamento permanece no principal. Isso evita pagar por uma chamada falha primeiro e mantém o comportamento previsível para os usuários.
Uma maneira segura de testar
Não mova todo o tráfego de uma vez. Solicite o crédito de teste de $0,50 na página da chave de API, que não precisa de cartão e dura 7 dias, depois execute estas etapas:
- Reexecutar 20 prompts reais dos seus logs contra o novo endpoint.
- Compare respostas, contagens de tokens e falhas com seu provedor atual.
- Forçar um 429 e confirmar que seu retry funciona.
- Envie 5% do tráfego de produção através de uma flag de recurso.
- Observe o cabeçalho
X-Balance-USDe sua taxa de erro por alguns dias antes de ampliar.
A documentação cobre os métodos, e LLM de codificação sem censura mostra um uso por desenvolvedor em detalhes.
Mais guias
Perguntas e respostas
Posso usar o SDK da OpenAI com outro provedor?
Sim, se o provedor for compatível com OpenAI. Defina a URL base, a chave e o nome do modelo com os valores do novo provedor.
Este serviço é a API da OpenAI?
Não. É um endpoint independente compatível com OpenAI que executa um modelo de pesos abertos, e não é uma API oficial da OpenAI ou de qualquer outro fornecedor.
Suporta streaming e ferramentas?
Sim. O streaming funciona via SSE com stream: true, e a chamada de funções usa o formato padrão de ferramentas e tool_calls.
O que devo verificar antes de mudar?
Nomes dos modelos, parâmetros suportados, comportamento de chamada de ferramentas, limites de contexto, tratamento de erros para 429 e, acima de tudo, como o modelo responde aos seus prompts reais.
Sua chave está a um passo de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.