Autenticação

Criar uma chave

Abra Settings, depois API keys. Dê à chave um nome que diga onde ela será usada e crie-a.

A chave é mostrada uma única vez. Copie-a na hora e guarde-a em um lugar seguro, como as variáveis de ambiente do seu servidor. O Setherion guarda apenas uma impressão digital dela, então ninguém pode mostrá-la a você de novo, nós inclusive. Se você a perder, revogue-a e crie uma nova.

Uma chave começa com sth_, seguido de 43 letras, dígitos, - e _ aleatórios, 47 caracteres no total. O nome pode ter até 60 caracteres; um nome mais longo é cortado.

Envie-a com cada solicitação

Coloque a chave no cabeçalho Authorization:

curl https://www.setherion.com/api/v1/projects \
  -H "Authorization: Bearer $SETHERION_API_KEY"

const res = await fetch('https://www.setherion.com/api/v1/projects', {
  headers: { Authorization: `Bearer ${process.env.SETHERION_API_KEY}` },
})
const data = await res.json()

Só o esquema Bearer é lido. Uma solicitação sem uma chave válida recebe 401:

{
  "ok": false,
  "error": "A valid API key is required. Make one on your Setherion account page and send it as \"Authorization: Bearer sth_...\"."
}

Um cabeçalho ausente, uma chave digitada errada, uma que não existe e uma que foi revogada recebem todas essa mesma resposta, então ela nunca diz qual delas foi.

O que uma chave pode fazer

Uma chave age como você. Ela pode fazer o que você pode fazer no Setherion:

• ver os apps do seu painel, os seus e os compartilhados com você;
• ler o guia das lojas de apps e as respostas de privacidade de qualquer app que você possa abrir;
• alterar os apps que você pode editar, gastando créditos do mesmo jeito que uma edição no editor;
• publicar os apps que você pode editar e escrever a página deles na loja.

Sua função em cada app decide o resto. Uma chamada que lê exige viewer ou mais; uma chamada que altera um app ou gasta créditos exige editor ou mais. Veja Introdução para saber qual chamada exige o quê.

Uma chave não pode alterar sua conta, seu plano nem sua cobrança, e não pode criar nem revogar chaves: isso só é possível quando você mesmo está conectado ao Setherion, então uma chave vazada nunca pode gerar outras.

Revogar uma chave

Em API keys, clique em Revoke ao lado da chave. Ela para de funcionar na hora. As chaves revogadas continuam na lista para você ver quando foram usadas pela última vez.

Você pode ter até 10 chaves ativas ao mesmo tempo. Pedir uma 11ª é recusado com You have 10 active keys. Revoke one you no longer use to make another. A lista mostra quando cada chave foi usada pela última vez, atualizado no máximo uma vez por minuto.

Entrar sem uma chave

Os assistentes de IA se conectam com uma página de login e um botão Allow, em vez de uma chave. Veja MCP: conectar um assistente de IA.

Os tokens que esse login produz funcionam somente no endereço do assistente (/api/mcp). Os endpoints desta referência aceitam uma chave de API e nada mais.