PT ▾
Obter chave de API

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 é.

Atualizado

Vários cabos coloridos conectados a uma única porta de conector padrão, mostrando endpoints de API intercambiáveis
Quatro plataformas com nuvem, hub de rede, caixa de GPU e cubo conectados a um saldo central, para comparar opções de modelo

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:

  1. Reexecutar 20 prompts reais dos seus logs contra o novo endpoint.
  2. Compare respostas, contagens de tokens e falhas com seu provedor atual.
  3. Forçar um 429 e confirmar que seu retry funciona.
  4. Envie 5% do tráfego de produção através de uma flag de recurso.
  5. Observe o cabeçalho X-Balance-USD e 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.

01

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.

Obter chave de API