FAQ da Uncensored API

Básico

O que é Uncensored API em uma frase?

É um endpoint de chat completions pago e apenas de texto que serve um único modelo, id uncensored, e não recusa conteúdo adulto lícito, ficção ou assuntos controversos.

Qual URL eu chamo?

Use https://api.uncensoredapis.com/v1 como base. Requisições de chat vão para POST /v1/chat/completions e a lista de modelos está em GET /v1/models. Qualquer outro caminho retorna 404.

Preciso aprender um novo SDK?

Não. As formas de requisição e resposta seguem a convenção comum de chat completions, então os pacotes oficiais Python e Node funcionam após você alterar a base URL e a chave. curl puro também funciona, como mostram os docs.

Existe uma maneira de testar antes de pagar?

Sim. Uma nova conta recebe $0,50 de crédito de teste, válido por 7 dias, e nenhum dado de pagamento é solicitado no sign-up. Registre-se com e-mail e senha na key page e a chave aparece imediatamente.

Posso escolher entre vários modelos?

Não. Há exatamente um modelo, e seu id é uncensored. Uma chamada à rota models retorna essa única entrada, então não há nada para selecionar ou alternar entre.

Para quem é o serviço?

Desenvolvedores que constroem produtos para adultos, incluindo ferramentas de ficção, apps de roleplay e assistentes de pesquisa. Você é responsável pelos seus próprios controles de idade e regras de conteúdo no que você lançar.

Chaves e acesso

Quantas chaves uma conta recebe?

Uma. Se precisar de um novo valor, regenere-o na conta; a chave anterior deixa de funcionar no mesmo momento, então implante a substituição imediatamente.

Onde a chave deve ficar?

Mantenha-a em uma variável de ambiente ou gerenciador de segredos em um servidor que você controla. JavaScript no navegador e binários móveis podem ser inspecionados, então roteie o tráfego do cliente através do seu próprio backend em vez de embutir a chave.

Como a chave é enviada?

Em um cabeçalho Authorization: Bearer em cada requisição. Um valor ausente ou incorreto retorna 401 com um objeto de erro JSON.

Quero uma chave de API sem censura para uma equipe. Podemos compartilhar uma?

Você pode, mas todos os processos compartilham a mesma cota de 300 requisições por minuto e o mesmo saldo. Coloque um gateway pequeno na frente da chave e dê a cada colega acesso ao gateway em vez da chave em si.

Limites e preços

Quão grande pode ser um prompt?

A janela de contexto é de 100.000 tokens, compartilhada por prompt e conclusão. O corpo de uma única requisição não pode ultrapassar 8 MB. Uma requisição cujo prompt mais max_tokens exceda a janela é rejeitada com 400.

Quão longa pode ser uma resposta?

O padrão é 2048 tokens. Você pode aumentar max_tokens para no máximo 32.000 por requisição. Quando uma resposta para devido ao limite, finish_reason lê length.

Quanto custa?

Tokens de entrada custam $0,25 por milhão e tokens de saída custam $1,00 por milhão. O saldo é pré-pago, não há assinatura e o saldo nunca expira. Veja a página de preços para a tabela.

Você pode dar uma estimativa rápida?

Considere uma rodada de chat com 1.500 tokens de prompt e 300 tokens de conclusão, apenas como ilustração. Isso é $0,000375 de entrada mais $0,0003 de saída, ou cerca de $0,000675 por rodada, então $1 compra aproximadamente 1.480 dessas rodadas.

O que acontece quando envio muitas requisições?

Cada chave pode fazer 300 requisições por minuto. Além disso, você recebe um 429, e a resposta correta é reduzir a velocidade e tentar novamente com um atraso.

Perguntas de integração

Quais parâmetros de amostragem posso definir?

Os padrões como temperature, top_p e stop são passados para a geração. Defina-os no corpo da requisição exatamente como faria em outro lugar.

A API lembra as rodadas anteriores para mim?

Não. Cada requisição é independente, então você reenvia a conversa em messages toda vez. Remova as rodadas mais antigas quando o total se aproximar da janela de 100.000 tokens.

Posso transmitir tokens para um navegador?

Sim, envie stream: true e leia os eventos enviados pelo servidor. Faça isso no seu backend e retransmita o texto para a página, para que a chave nunca chegue ao cliente.

Uma mensagem de sistema é suportada?

Sim. Coloque uma mensagem com o papel system primeiro no array para definir tom, formato e limites para a conversa.

O que devo verificar primeiro quando a saída parece cortada?

Leia finish_reason. Um valor de length significa que o limite foi atingido, então aumente max_tokens ou encurte o prompt. A referência lista todos os valores.

Saldo e faturamento

Como adiciono fundos?

Recarregue seu saldo pré-pago na sua conta. Não há assinatura para contratar e o saldo não utilizado permanece disponível porque nunca expira.

O que acontece quando o crédito de teste acaba?

O crédito de teste é válido por 7 dias. Após ser gasto ou expirado, as requisições retornam 402 com o código no_credit até você recarregar o saldo.

Posso ver quanto custou uma requisição?

Cada resposta inclui um bloco usage com tokens de prompt, conclusão e total. Multiplique pelas taxas por milhão para obter o valor cobrado e mantenha sua própria contabilidade se quiser um livro-caixa.

As requisições falhas são gratuitas para tentar novamente?

Retentar é permitido, mas mantenha-o limitado. Use um backoff curto para 429 e 503 e nunca faça loop em 400, 401, 402 ou 403, pois eles não se corrigirão. O errors playbook tem uma política pronta.

Conteúdo e comportamento

O que o modelo não fará?

Conteúdo adulto lícito não é recusado, nem ficção ou tópicos controversos. A exceção firme é qualquer conteúdo sexual envolvendo menores, que é bloqueado com 403 sempre, incluindo em histórias e roleplay. O serviço é para maiores de 18 anos.

Meus prompts são usados para treinar um modelo?

Não. Os prompts não são usados para treinamento.

Como isso difere de encaminhar por um agregador?

Um agregador encaminha você para muitos modelos, cada um com suas próprias regras. Este serviço é um modelo por trás de uma política. O guia uncensored OpenRouter detalha essa comparação em profundidade.

Ele pode ver imagens ou criar embeddings?

Não. Ele lida apenas com texto, sem embeddings, imagens, áudio, vídeo ou ajuste fino.

Solução de problemas

Recebo 402 com no_credit. O que faço agora?

Seu saldo acabou ou o teste expirou. Recarregue o saldo pré-pago e envie a requisição novamente.

Uma requisição retorna 503 upstream_busy.

É temporário. Aguarde alguns segundos e tente novamente, usando um atraso crescente e alguma aleatoriedade se você executar muitos workers.

Meu stream termina e não consigo encontrar a contagem de tokens.

Com streaming ativado, um fragmento final contendo usage é adicionado automaticamente, logo antes de data: [DONE]. Sua lista choices está vazia, então verifique isso antes de indexar.

Ferramentas e chamada de funções funcionam?

Sim, no formato padrão: passe um array tools e procure por tool_calls na resposta.