FAQ da API sem censura: registro, cobrança, endpoints, códigos de erro e limites de conteúdo

Registro e teste grátis

Como registrar-se? É necessário vincular um cartão bancário?

Registre-se na página /get-api-key/ com e-mail e senha. Não é necessário vincular cartão. A chave aparece na tela imediatamente após o registro, sem espera de aprovação.

Qual o valor do crédito de teste para novas contas e por quanto tempo vale?

Novas contas recebem $0,50 de crédito de teste válido por 7 dias. Considerando o preço de saída de $1,00 por milhão de tokens, isso gera aproximadamente 500.000 tokens de resposta, suficiente para testes de integração e validações em pequena escala.

Quantas chaves posso ter por conta? E se eu perder a chave?

Cada conta possui apenas uma chave. Se ela for comprometida ou perdida, você pode gerar uma nova na conta; a chave antiga será invalidada imediatamente. Todos os serviços usando a chave antiga receberão erro 401, portanto, atualize as variáveis de ambiente após a troca.

O que acontece quando o teste expira?

Após a expiração do crédito de teste, as requisições retornarão 402 com o código de erro no_credit. Para continuar usando, basta recarregar o saldo pré-pago da conta; o código não precisa ser alterado.

Cobrança e saldo

Qual o preço e como é a cobrança?

Cobrança por token: entrada $0,25 / milhão de tokens, saída $1,00 / milhão de tokens. Sem assinaturas ou mensalidades; pague apenas pelo que usar. Veja a página de preços para detalhes.

O saldo expira?

Não. O saldo pré-pago recarregado não tem validade. Apenas o crédito de teste de $0,50 para novas contas tem limite de 7 dias.

Como saber quanto uma requisição custou?

O campo usage em cada resposta indica o número de tokens de entrada e saída. Multiplique pelo preço unitário para obter o custo. Em respostas em streaming, o último bloco também contém usage; observe que o choices deste bloco é um array vazio.

Como evitar custos inesperados altos?

Use dois métodos: limite a saída com max_tokens (padrão 2048) e, em conversas multi-turno, corte o histórico para evitar que a entrada cresça indefinidamente. Como é pré-pago, as requisições param quando o saldo acaba, evitando cobranças extras.

Quanto custa uma requisição comum?

Exemplo: entrada de 2.000 tokens e saída de 500 tokens. Custo de entrada: ~$0,0005; custo de saída: ~$0,0005. Total: ~$0,001 por requisição (ou ~$1 para mil requisições). O valor exato está no campo usage da resposta.

O que acontece quando o saldo acaba?

A API retorna 402 com o código de erro no_credit. Após recarregar, você pode continuar usando sem precisar regenerar a chave.

Endpoints e parâmetros

Qual é o endereço da API e o nome do modelo?

Base URL: https://api.wuxianzhiapi.com/v1. O nome do modelo é fixo: uncensored. Endpoints disponíveis: POST /v1/chat/completions e GET /v1/models.

É compatível com SDKs OpenAI?

Compatível. Com a biblioteca oficial Python openai v1+ ou npm openai v4+, basta alterar base_url e a chave. Veja exemplos de código e o guia de migração.

Qual o tamanho do contexto? Qual o limite de max_tokens?

Janela de contexto de 100.000 tokens (soma de prompt e saída). O valor de max_tokens é 2048 por padrão, com máximo de 32.000 por solicitação. O corpo da requisição não pode exceder 8 MB.

Suporta streaming e chamada de funções?

Sim. Para streaming, use stream: true; o servidor anexa automaticamente um bloco final com usage. Para chamada de funções, use os parâmetros tools e tool_choice no formato OpenAI. Os resultados das ferramentas são retornados como mensagens com role: "tool".

Por que o último bloco da resposta em streaming não tem texto?

É um bloco de estatísticas de uso adicionado automaticamente. O array `choices` está vazio e `usage` contém o número de tokens desta requisição. Verifique se `choices` está vazio antes de extrair o conteúdo para evitar erro de índice fora dos limites.

Existe limite de requisições?

Cada chave de API permite 300 requisições por minuto. Ao exceder, o servidor retorna 429; aguarde e tente novamente, sendo recomendável usar backoff exponencial.

Suporta vetores, imagens, áudio ou fine-tuning?

Não. Oferecemos apenas conversação de texto. Há apenas um modelo: uncensored. Não há embeddings, nem geração de imagens, áudio, vídeo ou fine-tuning.

Códigos de erro

Todas as respostas de erro são em JSON, no formato {"error":{"code":...,"message":...}}. Abaixo, explicamos como lidar com cada erro com base no código de status.

O que significa o erro 400?

O problema está na própria requisição. O caso mais comum é o prompt somado ao max_tokens exceder 100.000 tokens, ou o formato JSON estar incorreto ou com tipos de campo errados. Corrija a requisição; tentar novamente sem alterações não adiantará.

Como investigar o erro 401?

A chave de API é inválida ou não foi enviada. Verifique se o cabeçalho da requisição está Authorization: Bearer <chave>, se as variáveis de ambiente estão ativas e se a chave não foi regenerada. Chaves antigas tornam-se inválidas imediatamente após a regeneração.

O que significa o erro 402 no_credit?

O saldo acabou ou o crédito de teste grátis expirou. Recarregue sua conta para restaurar o acesso; não é necessário trocar a chave de API.

O que significa o erro 403 content_blocked?

A requisição acionou o bloqueio de conteúdo. Conteúdo sexual envolvendo menores de idade é sempre bloqueado, incluindo ficção e roleplay, e isso não pode ser ajustado. Modifique o conteúdo da requisição e tente novamente; reenviar o mesmo conteúdo resultará no mesmo bloqueio.

O que causa o erro 404?

Você acessou um endpoint que não existe. Isso geralmente ocorre por erro na URL, como a omissão de /v1, ou por chamar um endpoint não suportado, como embeddings ou geração de imagens.

Como lidar com os erros 429 e 503?

O 429 indica que você excedeu o limite de requisições de 300 por minuto. O 503 retorna o código de erro upstream_busy, indicando que o modelo está temporariamente ocupado; tente novamente após alguns segundos. Para ambos, o backoff exponencial é recomendado. Consulte a página de exemplos de código para ver um exemplo.

Limites de conteúdo

O modelo sem censura gera qualquer coisa?

Não. Conteúdo adulto legal, criações fictícias e tópicos controversos não são bloqueados. Mas conteúdo sexual envolvendo menores é sempre bloqueado (403), seja fictício ou roleplay. O uso deve ser legal.

Para quais usuários é destinado?

Apenas para usuários adultos com 18 anos ou mais. Se usar em produtos finais, confirme a idade no seu app e mantenha mecanismos de denúncia e gestão de conta.

Pode ser usado para roleplay, romances e jogos?

Sim, este é o uso mais típico. Consulte o artigo Aplicações para exemplos de prompts e estimativas de custo por cenário.

Em quais situações o roleplay retorna 403?

O retorno 403 ocorre apenas quando o bloqueio de conteúdo é acionado, tipicamente envolvendo conteúdo sexual com menores de idade, incluindo configurações fictícias. Conteúdo legal entre adultos não é rejeitado apenas por ser roleplay. Ao receber 403, ajuste a persona ou a trama antes de fazer outra requisição.

As informações do modelo são necessariamente confiáveis?

Não necessariamente. O fato de não haver rejeição não significa que o conteúdo seja preciso. Para conclusões baseadas em fatos, dados, direito ou medicina, você deve verificar as informações antes de usá-las.

Privacidade

Meus prompts serão usados para treinar o modelo?

Não. Os prompts que você envia não serão utilizados para treinamento.

Como devo guardar minha chave de API?

Coloque a chave nas variáveis de ambiente do servidor. Não a inclua em páginas front-end, apps móveis ou repositórios públicos. Se houver vazamento, regenere na conta; a chave antiga será invalidada imediatamente.

Como devo tratar os dados dos usuários no meu aplicativo?

Isso depende do seu próprio produto. Recomendamos enviar apenas o conteúdo necessário para concluir a tarefa. Não inclua informações sensíveis, como nomes reais, números de documentos ou contatos, nos prompts. Deixe claro em sua própria política de privacidade como os dados serão tratados.