Apps de roleplay (RisuAI, Agnai, Chub, KoboldAI Lite, Janitor AI)

Apps de roleplay permitem conversar com personagens, e a maioria deixa você levar o seu próprio modelo de IA por uma conexão compatível com OpenAI. A SpicyAPI fala esse protocolo, então você pode apontar esses apps para ela, escolher qualquer modelo de texto da SpicyAPI e pagar com o seu saldo.

Esta página cobre cinco apps web e desktop: RisuAI, Agnai, Chub, KoboldAI Lite e Janitor AI. Para o SillyTavern, veja SillyTavern. Os apps são feitos por terceiros e mudam as telas; os nomes de campos abaixo vêm do código-fonte publicado e das páginas de ajuda de cada app, e cada seção diz o que foi conferido e o que não foi.

O que você precisa

• Uma conta SpicyAPI com saldo. Veja Prepare sua conta e Cobrança.
• Uma chave de API que começa com sk-spicy-. Veja Autenticação.
• Um id de modelo. Os modelos de texto se chamam <maker>/<model>/chat, escritos aqui como MODEL_ID_FROM_CATALOG. MODEL_ID_FROM_CATALOG representa um id de modelo de chat que você copia do catálogo ao vivo (GET /api/v1/models); nunca digite o marcador em si. O id precisa ser digitado exatamente, inclusive o /chat no final. A lista completa está em spicyapi.ai/models; com a sua chave, GET https://api.spicyapi.ai/v1/models também a retorna, e os ids de chat são os que terminam em /chat. Veja Catálogo de modelos e schemas.

Qual app usa qual campo

A diferença entre o endereço curto e o completo importa. Apps que adicionam /chat/completions sozinhos quebram se você o incluir, e o Janitor AI precisa dele escrito por inteiro.

Escolha um modelo

Roleplay pede um modelo que se mantenha no personagem, escreva respostas longas e não recuse pedidos comuns de história. O ranking de roleplay e LLMs classifica os modelos de texto da SpicyAPI nesses pontos e mostra os preços atuais. Consulte-o em vez de confiar em uma lista escrita aqui, porque modelos e classificações mudam.

Cada página de modelo também mostra um rótulo de política de conteúdo (por exemplo, sem restrições, intermediário ou filtrado). Esse rótulo indica com que liberdade o modelo responde; escolha um modelo cujo rótulo combine com as histórias que você quer escrever.

O DeepSeek V4.1 Flash é um bom primeiro modelo para testar: está perto do topo do ranking e é um dos mais baratos. Copie o id dele (termina em /chat) do catálogo ao vivo em spicyapi.ai/models em vez de digitá-lo de memória.

Dois limites que vale conhecer:

• Alguns modelos aceitam no máximo 256 mensagens por requisição. Em um chat muito longo, um app que envia o histórico inteiro pode passar disso. Procure no app a configuração de quanto histórico enviar, ou o tamanho do contexto, e reduza. A página do modelo lista os limites dele.
• Entrada de imagem só funciona com modelos que leem imagens. Um chat de roleplay comum não precisa disso.

Configurações de amostragem

Os apps de roleplay enviam um monte de configurações de amostragem a cada mensagem: temperature, top-p, top-k, min-p, top-a, frequency, presence e repetition penalty. Os modelos diferem quanto às que aceitam.

A SpicyAPI ignora as que o modelo não usa em vez de recusar a mensagem. Ela também ignora n: 1, uma lista de stop vazia e stop strings em um modelo que não tem nenhuma. Quando ignora algo, a resposta traz um cabeçalho X-Spicy-Ignored-Params com os nomes das configurações descartadas, para você ver exatamente o que não teve efeito.

Quando um modelo aceita uma configuração, mas não o valor que você enviou, a SpicyAPI usa o valor aceito mais próximo: uma temperature acima do máximo do modelo vira esse máximo, e uma lista de stop strings maior do que o modelo permite mantém as primeiras entradas. Essas mudanças aparecem em um cabeçalho X-Spicy-Adjusted-Params, por exemplo temperature=1, stop=kept 1 of 3. Assim você pode deixar seus presets habituais como estão.

Campos que não são de amostragem são diferentes: se um app enviar algo que o modelo não conhece de forma alguma, a SpicyAPI ainda responde com um erro 400 que cita o campo.

Modelos de raciocínio e Max tokens

Alguns modelos pensam antes de responder. O raciocínio consome tokens, e esses tokens contam para Max tokens (também chamado de Max output, Response length ou max_new_tokens, conforme o app).

• Defina Max tokens com folga. Se for muito pequeno, digamos 20 ou 200, um modelo de raciocínio pode gastar todo o orçamento pensando e não devolver texto. Você recebe um erro upstream_failed dizendo que o orçamento de saída foi gasto com raciocínio. Comece com 1.000 ou mais e aumente se as respostas forem cortadas.
• Pensar custa dinheiro e tempo. Você paga pelos tokens de raciocínio como por qualquer outra saída, e a primeira palavra chega mais tarde. Alguns modelos aceitam a instrução de pensar menos por meio de reasoning_effort. Os níveis variam por modelo; um nível que o modelo não oferece é trocado pelo mais próximo que ele oferece, e configurações de raciocínio no estilo OpenRouter (o Agnai envia essas) são traduzidas para reasoning_effort. Apps que têm uma caixa Additional Parameters ou de parâmetros personalizados podem enviá-lo, por exemplo reasoning_effort com um valor menor; a maioria dos apps abaixo não o envia sozinha.
• Alguns apps exibem o raciocínio no chat. O Janitor AI o envolve em tags <think>. O Chub não o mostra de jeito nenhum.

Mantenha o gasto sob controle

Chats de roleplay são longos, e os apps reenviam a conversa inteira a cada mensagem, então o custo por mensagem cresce junto com o chat.

Para cada app, crie uma chave própria no console. Abra Advanced ao criá-la e defina um limite de gasto diário (e um mensal, se quiser). Se o app se comportar mal, entrar em loop ou a chave vazar, o prejuízo para no limite, e você pode revogar só aquela chave sem mexer em mais nada. Uma chave também pode ser restrita a modelos específicos. Veja Autenticação.

Esses apps guardam sua chave nos servidores deles ou no seu navegador. O site do RisuAI, o Agnai e o Janitor AI enviam a sua chave e o seu chat pelos servidores deles; o Chub e o KoboldAI Lite enviam as requisições direto do seu navegador. Uma chave separada e com limite é a precaução certa em todos os casos.

RisuAI

O RisuAI roda em risuai.xyz, como app desktop ou no seu próprio servidor. Conferido no código-fonte do RisuAI (versão 2026.8.250).

De onde vêm as requisições. No risuai.xyz, o RisuAI normalmente repassa as requisições pelo próprio servidor, então a sua chave e o seu chat passam por ele. O app desktop e um servidor próprio enviam as requisições direto da sua máquina. Só a opção "Force Plain Fetch" do site, escondida entre as configurações não recomendadas, envia as requisições pelo navegador; a SpicyAPI aceita essas também.

Amostragem. As configurações padrão da Custom API do RisuAI enviam frequency, presence e repetition penalty, min-p e top-a. A SpicyAPI ignora as que o modelo não usa, então os padrões funcionam.

Agnai

O Agnai fica em agnai.chat. Conferido no código-fonte do Agnai (branch dev, 06/10/2026). A SpicyAPI não está na lista de provedores nativos do Agnai, então você a adiciona como uma conexão personalizada compatível com OpenAI.

De onde vêm as requisições. Com um provedor adicionado assim, quem envia a requisição é o servidor do Agnai, então a sua chave fica guardada no Agnai.

Amostragem. O Agnai sempre envia temperature e top-p, que alguns modelos não aceitam. A SpicyAPI os ignora para esses modelos, então modelos como DeepSeek V4 e Kimi K3 funcionam.

Não recomendado: modos diretos pelo navegador. O Agnai também tem um tipo de conexão Self-Host e uma opção Use Local Requests em presets antigos, que fazem o seu navegador chamar o endereço diretamente. Pelo código-fonte, esses modos adicionam um campo chamado think que a SpicyAPI não aceita, e a SpicyAPI responde 400 para campos que não conhece. Isso não foi testado com a SpicyAPI. Se você receber um 400 aí, volte para a configuração de provedor acima.

Chub

O Chub (chub.ai) envia as requisições direto do seu navegador para o endereço que você informa. Conferido no código de front-end publicado do Chub (build de 28/06/2026); as telas do Chub podem ter mudado desde então. A conexão pelo navegador funciona porque a SpicyAPI permite requisições vindas de páginas web.

O Chub avisa na própria página de configurações que o seu IP e o histórico do chat podem ser registrados quando você usa um reverse proxy. Esse aviso é do Chub, não da SpicyAPI.

Coisas que o código-fonte mostra e que podem surpreender:

• O Chub para de ler uma resposta em streaming depois de 120 segundos. Um modelo de raciocínio que pensa por muito tempo pode ser cortado; reduza o esforço de raciocínio ou escolha um modelo que responda mais rápido.
• O Chub não exibe o raciocínio do modelo, apenas a resposta.

KoboldAI Lite

O KoboldAI Lite é uma única página web em lite.koboldai.net. Conferido no index.html publicado. Ele chama o endereço diretamente do seu navegador, o que funciona porque a SpicyAPI permite requisições vindas de páginas web.

Deixe "CORS Proxy" desativado. O KoboldAI Lite tem uma opção para passar as requisições por um proxy mantido pelo autor dele. Você não precisa disso para a SpicyAPI, e ativá-la envia a sua chave pelo servidor de outra pessoa.

Amostragem. A configuração de repetição dele é enviada à API como presence penalty. A SpicyAPI a ignora nos modelos que não a usam.

Janitor AI

O recurso de "proxy" do Janitor AI envia o seu chat para um endereço que você escolhe. Segundo a central de ajuda do Janitor, os campos ficam no ícone de engrenagem da página de chat, em API Settings e depois Add Configuration.

Se o Janitor mostrar um erro de rede ou de conexão, como "A network error occurred", a página do Janitor provavelmente está bloqueando requisições para endereços que não sejam os da OpenAI. A página web do Janitor tem uma política de segurança que permite requisições diretas a apenas um endereço de IA de terceiros, o da OpenAI. Quando o Janitor envia a requisição a partir do seu navegador, o navegador a recusa antes que a SpicyAPI veja qualquer coisa, e a SpicyAPI não pode mudar isso. Se a sua chave não mostra uso no console enquanto esse erro aparece, essa é a causa.

Se isso acontecer, use o SillyTavern ou o RisuAI.

Outros fatos da central de ajuda do Janitor e do código da página:

• Alguns bots do Janitor têm os proxies desativados pelos autores, então um bot pode recusar conversar por um proxy, não importa o que você informe.
• O Janitor mostra o raciocínio do modelo envolvido em tags <think>. Use um Max tokens maior ou um esforço de raciocínio menor para mantê-lo curto.
• O Janitor limita o tamanho de cada mensagem que você digita.

Solução de problemas

Os códigos de erro estão explicados em Erros. Todo erro termina com um request_id; informe-o ao suporte para que a requisição seja localizada com exatidão. Suas requisições também aparecem em Logs no console, a forma mais rápida de saber se uma requisição chegou à SpicyAPI.