Pontos principais
- Nossa URL base é https://api.uncensoredgptapi.com/v1 e o ID do modelo é
uncensored. - Os SDKs de Python e Node aceitam base_url ou baseURL; ambos também leem variáveis de ambiente.
- A maioria das falhas vem da falta de /v1, um caminho duplicado ou um nome de modelo antigo.
- GET /v1/models é a maneira mais rápida de confirmar se a URL e a chave estão corretas.
O que a URL base faz
O base_url da API GPT é o endereço que um SDK OpenAI coloca no início de cada caminho de endpoint. Por padrão, os SDKs oficiais enviam requisições para os servidores da OpenAI. Se você definir uma URL base diferente, o mesmo código de cliente envia o mesmo formato de requisição para outro servidor que fala o mesmo protocolo.
Isso é tudo que compatível com OpenAI significa na prática. Nossa API aceita POST /v1/chat/completions e GET /v1/models com as mesmas formas JSON, o mesmo cabeçalho Authorization: Bearer e o mesmo formato de streaming. Então você altera três valores:
- URL base:
https://api.uncensoredgptapi.com/v1 - Chave de API: a chave do seu painel
- Modelo:
uncensored
Nosso serviço é independente e executa um único modelo de pesos abertos. Não é a API da OpenAI nem um roteador para outros fornecedores, então nomes de modelo como gpt-4o não existem aqui. Use uncensored em todos os lugares.
Python com o SDK OpenAI
No SDK Python atual, passe base_url ao criar o cliente.
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredgptapi.com/v1",
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a base URL is in two sentences."},
],
)
print(resp.choices[0].message.content)Se o seu código é mais antigo e usa openai.api_base, ele está no SDK pré-1.0, onde a configuração global tem um nome diferente. Atualizar o pacote geralmente é mais fácil do que adaptar. Verifique a versão com pip show openai.
Ajuda saber como o SDK constrói uma requisição. Ele pega sua URL base, anexa o caminho do endpoint como /chat/completions e adiciona o cabeçalho Authorization: Bearer da sua chave. Esse é todo o mecanismo. Quando algo falhar, imprima ou registre a URL final e compare-o com o comando curl na próxima seção.
O mesmo cliente aceita as configurações timeout e max_retries. Os padrões tentam novamente algumas vezes em problemas de conexão, o que é adequado para a maioria dos scripts. Para limites de taxa, capture a exceção de limite de taxa do SDK e aguarde. Uma solicitação em streaming mantém seu slot de concorrência até o fim, então uma rajada de streams longos pode atingir o limite de concorrência mesmo quando sua contagem de requisições por minuto é baixa.
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY", max_retries=0)
def ask(text, tries=4):
for attempt in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": text}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")A espera de cinco segundos na primeira tentativa corresponde ao valor Retry-After: 5 que a API envia em sobrecarga temporária. Esperar mais em cada tentativa posterior evita sobrecarregar o endpoint.
Node e curl
O SDK Node usa baseURL com URL em maiúsculas.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredgptapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);Sem nenhum SDK, o curl mostra exatamente o que o SDK faz. A URL completa é a URL base mais /chat/completions.
curl https://api.uncensoredgptapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'Ler esse comando é a maneira mais clara de entender a URL base: tudo até e incluindo /v1 é a base, e o SDK adiciona o resto.
Variáveis de ambiente
Se você não puder editar o código, ou quiser uma configuração para vários scripts, os SDKs da OpenAI leem OPENAI_BASE_URL e OPENAI_API_KEY do ambiente quando nenhum valor explícito é fornecido.
export OPENAI_BASE_URL="https://api.uncensoredgptapi.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python my_script.pyIsso é útil para ferramentas que você não escreveu. Qualquer coisa construída no SDK OpenAI pode capturar as variáveis sem alterações, embora você ainda precise definir o nome do modelo para uncensored dentro da ferramenta. Se a ferramenta codificar um modelo, você precisará de sua própria configuração ou alteração de código.
Mantendo dois endpoints separados
Muitos projetos testam contra um endpoint e entregam contra outro, ou alternam entre eles por ambiente. Mantenha os três valores fora do seu código e leia-os da configuração, para que uma mudança seja uma alteração em um arquivo e não uma edição de código.
import os
from openai import OpenAI
client = OpenAI(
base_url=os.environ.get("LLM_BASE_URL", "https://api.uncensoredgptapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.environ.get("LLM_MODEL", "uncensored")Usar seus próprios nomes de variáveis em vez dos padrões do SDK evita uma armadilha silenciosa: uma ferramenta que lê OPENAI_API_KEY do shell enviará qualquer chave definida lá para qualquer URL base definida ao lado. Se você tiver uma chave antiga da OpenAI no seu perfil e uma URL base nova no seu projeto, você pode acabar enviando a chave de um serviço para o outro. Nomes separados tornam isso impossível, e você pode ver de relance qual endpoint um script usará.
Trate o nome do modelo como configuração também. É o valor mais frequentemente deixado para trás quando você muda, e produz as falhas mais confusas, já que tudo o resto parece correto.
Streaming e ferramentas usam o mesma URL base
Alterar a URL base não limita recursos. Streaming, chamada de funções e modo JSON passam pelo mesmo caminho /chat/completions, então o código que funcionou contra a API original continua funcionando. O streaming retorna Server-Sent Events, com uso relatado no final do stream.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY")
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Count from one to five."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
print()A verificação em chunk.choices é importante. O último chunk que carrega o uso pode não ter choices, e o código que indexa uma lista vazia falharia na última mensagem. As chamadas de ferramentas são transmitidas da mesma forma, como deltas parciais de tool_calls que você monta antes de executar a função, e os resultados voltam como mensagens com role: "tool". O modo JSON usa response_format={"type": "json_object"}.
Aplicativos e frameworks com campo de URL base
Muitos aplicativos expõem a mesma configuração sob nomes diferentes: API base, endpoint, URL personalizada da OpenAI ou host. A regra não muda. Cole a URL base incluindo /v1, cole a chave e digite uncensored como o nome do modelo.
SillyTavern, por exemplo, permite adicionar um endpoint compatível com OpenAI. A classe ChatOpenAI do LangChain aceita um argumento base_url. Outros front-ends chamam o campo de proxy URL ou proxy reverso. Os nomes dos campos variam por versão, então procure aquele que aceita uma URL terminada em /v1.
Alguns aplicativos pedem um modelo de um menu suspenso que preenchem chamando GET /v1/models. Esse endpoint funciona aqui e retorna a lista de modelos, então o menu suspenso deve mostrar uncensored assim que a URL e a chave estiverem corretas. Se permanecer vazio, a URL ou a chave estão erradas.
Quando um aplicativo oferece um campo de URL base e um campo "organização" ou "projeto", deixe os campos extras vazios. Eles existem para o serviço original e não significam nada aqui. Se um aplicativo insistir em uma chave que começa com um determinado prefixo, tente um tipo de conexão diferente, como uma opção genérica ou compatível com OpenAI personalizada, em vez do predefinido para o serviço original.
Algumas ferramentas de desktop testam a conexão solicitando um nome de modelo específico do provedor original e relatam uma falha mesmo quando o endpoint está bom. Nesse caso, pule o botão de teste e envie uma mensagem real. Se a resposta chegar, a URL, a chave e o modelo estão corretos, e a ferramenta está apenas sendo rigorosa em sua verificação.
Ferramentas baseadas em navegador também podem encontrar regras de cross-origin, já que a solicitação sai da página para um host diferente. Se uma ferramenta web falhar no navegador, mas a mesma chamada funcionar no curl, execute a solicitação de um pequeno servidor seu para que a chave fique fora do código do lado do cliente, que é o design mais seguro de qualquer maneira.
Erros comuns e como corrigi-los
Quase toda configuração falha vem de uma lista curta.
- Falta de /v1. A URL base é
https://api.uncensoredgptapi.com/v1, o endereço inteiro até/v1e não apenas o nome do host. Sem/v1, o SDK constrói caminhos que não existem. - Caminho duplicado. Se você colar
.../v1/chat/completionscomo a URL base, o SDK anexará o caminho novamente. Dê apenas a base. - Barra final. A maioria dos SDKs lida com isso, mas algumas ferramentas não. Tente sem uma.
- Nome de modelo antigo. Um nome de modelo como
gpt-4odeixado para trás do código original não corresponderá. Definauncensored. - Chave errada. Use a chave deste serviço. Uma chave OpenAI não funciona aqui, e a nossa não funciona na OpenAI.
- Erros de limite de taxa. HTTP 429 com código
rate_limitedsignifica muitas requisições por minuto; códigoconcurrencysignifica muitas ao mesmo tempo. Um 429 com um cabeçalhoRetry-After: 5marca sobrecarga temporária, então aguarde cinco segundos e tente novamente.
Nosso guia de solução de problemas aborda os erros de integração com mais detalhes.
Verifique a configuração em uma única chamada
Antes de executar toda a sua aplicação, chame o endpoint de modelos. É barato e confirma a URL e a chave juntas.
curl https://api.uncensoredgptapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"Se isso retornar uma lista contendo uncensored, envie uma solicitação de chat real. Para uma chave completa, espere até 8 requisições simultâneas e 300 requisições por minuto; uma chave de teste permite 2 simultâneas e 60 por minuto. Cada resposta inclui X-Request-Id, X-Balance-USD e os cabeçalhos de limite de requisições, úteis ao depurar.
Para obter uma chave, cadastre-se e use a página da chave de API, onde novos usuários podem reivindicar um crédito de teste de $0,50 com um clique. A documentação cobre streaming, chamada de funções e modo JSON assim que a conexão funcionar.
