PT ▾
Obter chave de API

Endpoints da API compatível com OpenAI: o que é suportado

Uma lista dos endpoints da API compatível com OpenAI que este serviço suporta, com requisições funcionais para cada um e uma lista clara do que está faltando.

Atualizado

Pontos principais

  1. Cinco caminhos: chat completions, respostas, modelos e duas rotas de saldo.
  2. O ID do modelo é uncensored, e uma chave funciona com qualquer SDK OpenAI.
  3. Sem imagens, áudio, vídeo, embeddings ou fine-tuning.
  4. Os limites retornam HTTP 429 com um código de erro claro.
Um hub central com cinco cabos, um por endpoint de API suportado

Os endpoints em resumo

Quais caminhos no estilo OpenAI um provedor realmente implementa? Aqui está a lista curta para esta API. URL base: https://api.uncensoredendpoint.com/v1. A autenticação é uma chave bearer em cada chamada.

Método e caminhoFinalidade
POST /v1/chat/completionsRequisições de chat, streaming, tools, modo JSON
POST /v1/responsesO formato de solicitação mais recente no estilo Responses
GET /v1/modelsLista o modelo; o ID é uncensored
GET /v1/dashboard/billing/credit_grantsSaldo no formato de API OpenAI
GET /v1/balanceBalance em forma simples

Essa é a cobertura inteira. Tudo que não está na tabela não é oferecido. Continue lendo para ver requisições funcionando e uma lista do que falta, para você planejar isso antes de escrever o código.

Completions de chat

Este é o endpoint que a maioria dos clientes usa. Aponte qualquer SDK OpenAI para a base URL e use o nome do modelo uncensored.

from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "List three uses of a webhook."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

Os parâmetros suportados incluem stream, tools, tool_choice, response_format com json_object, e o conjunto de amostragem: temperature, top_p, stop, seed e as penalidades. max_tokens é opcional, porque uma conclusão pode usar qualquer coisa que reste da janela de 100.000 tokens.

Com stream: true, a resposta chega como server-sent events e o uso é incluído no final, para que você ainda possa registrar as contagens de tokens.

Conversas com múltiplas rodadas

A API não mantém estado de conversa. Para um chat multi-turno, você envia a lista completa de mensagens a cada vez: mensagem do sistema primeiro, depois turnos alternados de usuário e assistente. Isso significa que os tokens de entrada crescem a cada turno, e o custo também, então corte ou resuma turnos antigos quando uma conversa ficar longa. A janela é de 100.000 tokens para prompt mais conclusão, o que é suficiente para a maioria dos chats, mas é fácil de preencher com documentos colados.

Respostas, modelos e saldo

Respostas

Exemplos mais recentes da OpenAI usam /v1/responses. Está disponível aqui também, então o código escrito para esse formato não precisa de reescrita.

curl https://api.uncensoredendpoint.com/v1/responses \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "input": "Write a haiku about caching."}'

Use o que seu cliente espera. Se você está começando do zero, chat completions tem o maior suporte de ferramentas.

Modelos e saldo

Liste os modelos para verificar se sua chave funciona. Você deve ver uma única entrada, uncensored, porque o serviço executa um único modelo e não é um roteador entre fornecedores.

curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"

# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"

# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"

Você também recebe o saldo em toda resposta no cabeçalho X-Balance-USD, o que é útil para um alerta de saldo baixo no seu app sem uma requisição extra. Outros cabeçalhos incluem X-Request-Id para perguntas de suporte, além de X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency.

Ferramentas e modo JSON na prática

Dois recursos transformam um endpoint de chat em algo em que você pode construir um produto. Chamada de funções permite que o modelo peça para seu código executar uma função. Modo JSON faz com que ele retorne uma saída analisável. Ambos usam os campos de requisição padrão.

Uma chamada de ferramenta se parece com isso. O modelo retorna uma entrada tool_calls, você executa a função e envia o resultado de volta como uma mensagem com role: "tool".

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Current weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)

msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)

Para o modo JSON, adicione response_format={"type": "json_object"} e diga no prompt que você quer JSON, idealmente com as chaves que você espera. Sempre analise dentro de um bloco try: nenhum modelo garante o esquema para cada chamada, então valide o resultado antes de confiar nele.

Migrando um projeto OpenAI existente

Se seu app já usa um SDK OpenAI, a migração são três edições e nenhuma nova biblioteca. A maioria dos SDKs lê as mesmas duas variáveis de ambiente, então você muitas vezes não precisa alterar nada no código.

export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEY
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);

Depois, procure no seu código por nomes de modelo como um ID de modelo GPT e substitua-os por uncensored, porque o serviço tem um único modelo. Remova chamadas para embeddings, imagens ou áudio e direcione-os para outro provedor. Mantenha uma lista de verificação curta: URL base alterada, nome do modelo alterado, chave armazenada em uma variável de ambiente e não no repositório, lógica de nova tentativa para 429 e um alerta de saldo baixo baseado no cabeçalho de saldo. Para configuração da chave, consulte como obter uma chave de API de IA sem censura. Depois, execute uma única requisição de teste e verifique se X-Balance-USD retorna, antes de mudar o tráfego real.

O que não é oferecido

Conhecer as lacunas economiza um dia de depuração. Esta API é apenas para texto. Estes endpoints da OpenAI não estão disponíveis:

  • Geração de imagens e visão computacional. Sem geração ou edição de imagens.
  • Áudio. Sem conversão de fala para texto ou texto para fala.
  • Vídeo. Não oferecido.
  • Embeddings. Se você cria recuperação, precisa de um serviço de embedding separado.
  • Fine-tuning. Você não pode treinar no serviço.

Chamadas para esses caminhos falharão, então mantenha-os fora de qualquer configuração de cliente compartilhada. Uma configuração típica combina esta API para chat com outro provedor para embeddings, e seu app escolhe a base URL por tarefa.

Limites, erros e retentativas

Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto. Uma chave de teste permite 2 simultâneas e 60 por minuto. O corpo máximo é de 8 MB. Quando você ultrapassa um limite, recebe HTTP 429 com um código de erro que diz qual: rate_limited para requisições por minuto, concurrency para muitas requisições de uma vez. Em sobrecarga temporária, você também recebe 429, com um cabeçalho Retry-After: 5.

Um detalhe pega as pessoas desprevenidas: uma solicitação em streaming mantém seu slot de concorrência até o fim do streaming, então leitores lentos contam contra o limite. Um adaptador de nova tentativa simples lida com tudo isso:

import time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")

def ask(prompt, tries=4):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (i + 1))
    raise RuntimeError("still rate limited")

Requisições falhas ou recusadas não são cobradas, então novas tentativas em erros não custam nada a mais. Para trabalhos em lote, limite seu pool de workers para 8 em uma chave completa, ou 2 em uma chave de teste, em vez de depender de novas tentativas. Um pool fixo é mais fácil de gerenciar e evita que um streaming lento ocupe todos os recursos.

Custo e acesso

O preço é $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída, a partir de crédito pré-pago sem assinatura e sem expiração. Recarregue com qualquer valor inteiro de $20 a $500, por cripto (USDT em TRC20, USDC em Base). Recargas maiores adicionam um bônus: +5% a partir de $50, +10% a partir de $100, +15% a partir de $200. Veja a página de preços.

Para experimentar, cadastre-se com Google ou e-mail, depois reivindique o crédito de teste de $0,50 com um clique na página da chave de API. A documentação cobre cada parâmetro, e a visão geral do endpoint explica o que é o serviço: um modelo de pesos abertos para uso adulto legal, sem recusas de conteúdo e com proibição firme de conteúdo sexual envolvendo menores de idade.

Perguntas e respostas

Suporta streaming e chamada de funções?

Sim. Use stream: true para eventos enviados pelo servidor com uso no final, e ferramentas com tool_choice para chamada de funções.

Existe um endpoint de embeddings?

Não. O serviço é apenas para chat de texto, então use outro provedor para embeddings.

Como verifico meu saldo?

Chame GET /v1/balance ou o caminho credit_grants no estilo OpenAI, ou leia o cabeçalho X-Balance-USD em qualquer resposta.

O que acontece quando atingo o limite de requisições?

Você recebe HTTP 429 com o código rate_limited ou concurrency. Aguarde e tente novamente; em caso de sobrecarga temporária, o cabeçalho Retry-After indica 5 segundos.

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.

Obter chave de APILer a documentação