Chamar um modelo

O seu site pode fazer uma pergunta a um modelo: da Anthropic ou da OpenAI com a sua chave, ou à própria IA de cada visitante, pelo OpenRouter. A chave nunca fica na página.

Por que não colocar a chave na página

Porque um site publicado é público. Uma chave no arquivo é uma chave no navegador de todo mundo que abre o site, e a primeira coisa que essas pessoas vão fazer com ela não é o que você tinha em mente. Usar a sua própria chave numa hospedagem de site estático costuma ser um jeito de vazá-la.

Por isso a chave fica conosco. A sua página faz o pedido ao próprio endereço, nós adicionamos a chave e repassamos o pedido.

Quem paga

Alguém paga por cada resposta. Nas configurações do site, em IA, você escolhe quem, uma vez para o site todo:

• Você, com uma chave salva. No Pro e no Team. A sua própria chave da Anthropic ou da OpenAI paga, até um limite mensal que você define.
• Cada visitante, com a própria conta do OpenRouter. Em todos os planos, Free incluído. Cada visitante conecta uma vez e paga pelas próprias chamadas.
• Desligado. O site não chama nenhum modelo.

Só uma opção por vez, para você sempre saber de quem é o dinheiro que uma chamada gasta.

Chaves salvas

Uma chave é salva uma vez, em Chaves e conexões, na seção Chaves de modelo, e depois cada site escolhe uma numa lista. Dê um nome a cada chave, como “Anthropic, trabalho”, e guarde quantas quiser, inclusive várias do mesmo provedor. As chaves de um espaço de trabalho são salvas nas configurações do espaço, pelo proprietário ou por um administrador, e só os sites desse espaço podem usá-las. As suas chaves pessoais nunca pagam pelo site de um espaço de trabalho, nem o contrário.

Depois de salva, a chave nunca mais aparece: só os quatro últimos caracteres, quando foi usada pela última vez e quais sites a usam. Uma chave que algum site ainda usa não pode ser removida até esse site escolher outra, e o Solta diz quais são esses sites.

Crie uma chave separada só para o Solta, com um limite de gastos no provedor. O nosso limite é uma proteção. O limite do provedor é o que segura, aconteça o que acontecer aqui.

Escolher um modelo

Você escolhe um nível, não um modelo, e toda chamada do site usa o modelo desse nível, seja qual for o modelo que a página pedir. As respostas também ficam limitadas ao tamanho máximo do nível, para que uma página não possa pedir uma redação inteira na sua chave. Os mesmos níveis valem quando os visitantes pagam.

Uma resposta curta é uma pergunta de cerca de 400 tokens e uma resposta de cerca de 200, pelo preço de tabela do provedor. Quem cobra é o seu provedor, não nós.

O limite mensal e o limite por visitante

Quando a sua chave paga, o preço de cada resposta é calculado pelo que o provedor diz ter usado, e o site para num limite mensal em dólares: US$ 10, se você não definir outro. As configurações do site mostram em que ponto ele está, como “US$ 3,20 de US$ 10 este mês”. Mandamos um e-mail quando chegar a 80% e de novo a 100%. No limite, as chamadas são recusadas com { "code": "ai_allowance" } e uma frase que a sua página pode mostrar, até o mês virar ou você aumentar o limite. Trocar a chave não recomeça o mês.

Cada visitante também tem um número de chamadas por hora, 20 se você não definir outro, seja quem for que paga: contadas por endereço IP e por um cookie no site, para que um visitante não esgote o limite do mês na hora do almoço. Passando disso, as chamadas são recusadas com { "code": "ai_visitor_limit" } e um retry-after.

Como usar

Com a sua chave pagando, faça um POST para /_solta/ai. O corpo é o corpo de requisição do próprio provedor, e o que volta é a resposta do próprio provedor, sem mudanças, porque o formato é dele e não cabe a nós prometê-lo. O modelo e a resposta mais longa são os do nível. As respostas voltam inteiras, sem streaming.

const res = await fetch("/_solta/ai", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    max_tokens: 512,
    messages: [{ role: "user", content: "Summarise this page" }],
  }),
});

const answer = await res.json();

Os visitantes usam a própria IA

Em todos os planos, Free incluído. Escolha Cada visitante, com a própria conta do OpenRouter e cada visitante paga pelas próprias chamadas: ele conecta a própria conta do OpenRouter uma vez, só neste site, com um limite de gastos que escolhe lá. A sua chave não é usada, e ninguém cola chave em lugar nenhum.

Não há nada para instalar. Toda página do site tem window.solta.ai:

const answer = await solta.ai.chat({
  messages: [{ role: "user", content: "Summarise this page" }],
});

O modelo é o do nível que você escolheu, com o nome que o OpenRouter usa, como anthropic/claude-sonnet-5.5. solta.ai.request() devolve a resposta inteira do OpenRouter, no formato chat-completions da OpenAI. solta.ai.status() diz se este visitante está conectado, e solta.ai.disconnect() o esquece.

A chave que o OpenRouter cria fica guardada aqui, criptografada, e nunca chega à página. Ela só funciona no seu site, e é excluída quando o visitante se desconecta, depois de 90 dias sem uso, ou quando você escolhe qualquer opção que não seja os visitantes. Conectar exige o site numa aba própria, então, dentro da página do site no Solta ou de uma incorporação, o visitante recebe a opção de abrir uma. Num site Privado, que só as pessoas dele abrem pelo Solta, use a sua própria chave.

O que os visitantes veem

Na primeira vez que o site precisa da IA dele, um visitante que ainda não conectou vê isto, no idioma do próprio navegador, e a chamada segue assim que ele conecta:

Use a sua própria IA

Este site usa IA que você mesmo paga, pelo OpenRouter. Conecte uma vez: você define um limite de gastos lá e pode desconectar quando quiser.

Agora não · Conectar com o OpenRouter

O Solta guarda sua chave criptografada, nunca nesta página, e a apaga depois de 90 dias sem uso.

Depois de conectado, uma pequena etiqueta “IA: conectada · Desconectar” fica num canto da página, para que ele sempre veja que o site gasta o crédito dele e possa interromper. Ele pode escondê-la pelo resto da visita. As configurações do seu site mostram as mesmas palavras.

O que isto não faz

Não há como distinguir com certeza um visitante de outro. Qualquer pessoa que pode abrir o seu site pode fazer ele chamar o modelo, e com a sua chave isso é gastar o seu dinheiro. Não há como evitar isso enquanto o site for público: um segredo entregue ao público não é segredo. O nível, o limite mensal, o limite por visitante e o limite do próprio provedor são o que mantém o gasto dentro do que você queria. A alternativa é pedir a cada visitante que use a própria IA.

Mudar o site com um pedido

Quando a sua chave paga, o site ganha uma aba Chat ao lado de Comentários e Versões. Peça uma mudança e o arquivo inteiro volta. Um botão o salva como uma versão nova.

Nada é salvo até você clicar nesse botão, e salvar uma versão não muda nada que alguém possa ver: o link continua mostrando o que mostrava antes, até você publicar. O fato de um modelo terminar não é motivo para o seu link mudar.

O chat gasta a mesma chave, o mesmo nível e o mesmo limite que o site, porque é a mesma chave. E só funciona num site de um arquivo só: uma pasta não tem uma coisa única para ir melhorando, e entregar a um modelo um arquivo entre quarenta é pior do que recusar.

O que mais não roda no momento da requisição.