Prepare sua conta

Crie sua conta e confirme seu e-mail

Abra spicyapi.ai/register. Há três formas de se cadastrar:

Marque a concordância com os termos de serviço e a política de privacidade e escolha Criar conta.

O que você deve ver: numa conta com e-mail, uma página com o título Confira sua caixa de entrada. Abra o e-mail e clique no link. A página E-mail verificado confirma, e Ir para o console leva você para dentro.

O que acabou de acontecer: sua conta existe, mas só pode chamar a API depois que o e-mail for confirmado. Até lá, o console mostra o aviso E-mail não confirmado — as chamadas de API estão bloqueadas.

• O link funciona uma vez e expira em 24 horas. Se tiver expirado, abra o link mesmo assim e use Enviar outro link de verificação, ou escolha Confirmar no aviso do console.
• Não chegou nada depois de alguns minutos? Olhe a pasta de spam e depois use Enviar de novo.

Adicione saldo

Abra Faturamento no console: spicyapi.ai/console/billing. Em Adicionar saldo:

1. Escolha um valor. Selecione um dos valores prontos (por exemplo US$ 10, US$ 25, US$ 50 ou US$ 100) ou Outro valor e digite o seu. O console mostra o menor e o maior valor que você pode adicionar num único pagamento. Pagamentos online aceitam no máximo duas casas decimais.
2. Veja se há bônus. Alguns valores vêm com um bônus promocional, mostrado como +US$ … de bônus antes de você pagar. O bônus entra como um lançamento separado, ao lado do valor que você pagou.
3. Escolha uma forma de pagamento e siga a aba correspondente abaixo.

Outras mensagens que podem aparecer:

• Recarga indisponível ou Não é possível criar um pedido de recarga agora: as recargas estão temporariamente fechadas, ou você tem pedidos pendentes demais. Conclua ou cancele os antigos em Pedidos de recarga, ou tente de novo mais tarde.
• A conexão caiu e não dá para saber o resultado: confira Pedidos de recarga antes de tentar de novo, para não pagar duas vezes.

Opcional: ligue a recarga automática

A recarga automática cobra um cartão salvo por você quando o seu saldo fica baixo, para que trabalhos longos não parem no meio com 40201. Ela só funciona com cartão.

1. Em Faturamento, encontre Recarga automática e escolha Salvar forma de pagamento com segurança.
2. Informe o cartão na página segura que se abre. Os dados do cartão ficam com o processador de pagamentos.
3. De volta ao Faturamento, você vê Estamos verificando sua forma de pagamento e depois Forma de pagamento salva. Se aparecer Este cartão não pode ser usado aqui, nada foi salvo; tente outro cartão.
4. Preencha três campos:
   • Recarregar abaixo de: o saldo que dispara uma cobrança.
   • Valor por recarga: quanto cada cobrança adiciona. Precisa estar dentro da mesma faixa de uma recarga normal.
   • Teto mensal: o máximo que a recarga automática pode cobrar num mês do calendário. Não pode ser menor que o valor por recarga.
5. Marque a autorização e escolha Ligar a recarga automática.

O que você deve ver: A recarga automática ficou ligada com estes limites. O cartão mostra a regra, por exemplo "Recarrega US$ 50 assim que seu saldo fica abaixo de US$ 10", e Usado neste mês.

As regras, exatamente:

• Verificamos o seu saldo mais ou menos a cada 30 segundos a 2 minutos. Quando o seu saldo disponível fica igual ou abaixo do valor de disparo, cobramos o valor configurado no cartão salvo.
• Cada cobrança é um pedido de recarga normal, marcado como Automática. Ela recebe o mesmo bônus que uma recarga manual do mesmo valor, e você pode emitir fatura para ela.
• O teto mensal conta meses do calendário em UTC. Quando ele se esgota, a recarga automática espera até o dia 1º do mês seguinte. Cobranças que falham não contam para o teto.
• Se uma cobrança falhar, tentamos de novo depois de 1 hora e outra vez depois de 6 horas. Se a terceira tentativa seguida também falhar, a recarga automática se desliga sozinha. Se o banco recusar o cartão de forma definitiva (por exemplo, um cartão roubado ou cancelado), ela se desliga na hora. Uma cobrança bem-sucedida zera a contagem.
• Depois que ela se desligou sozinha, resolva o problema do cartão (ou salve um novo) e ligue-a de novo.
• Desligar a recarga automática interrompe as cobranças futuras a qualquer momento. Isso nunca altera o seu saldo nem as recargas que já foram feitas.

Crie uma chave de API

Abra Chaves de API: spicyapi.ai/console/keys e escolha Criar chave (ou Criar a primeira chave).

Na janela Criar uma chave de API, só o nome é obrigatório. Tudo o que fica em Avançado pode ser alterado depois.

Nome. Dê à chave o nome do que vai usá-la, como production backend ou my laptop. Você vai precisar reconhecê-la quando for revogá-la. Até 120 caracteres.

Limites de gasto (em Avançado, em dólares americanos). Quando um limite é atingido, esta chave recusa novas tarefas com 40202 até o período virar. Suas outras chaves continuam funcionando. O dinheiro reservado para tarefas que ainda estão rodando conta para todos os limites.

Informe 0 em qualquer limite para ficar sem limite; deixar o campo em branco tem o mesmo efeito.

Acesso.

• Modelos permitidos. Deixe em Todos os modelos (sem restrição) e a chave pode chamar todos os modelos, inclusive os que forem adicionados depois. Escolha modelos específicos e a chave recusa qualquer outro modelo com 40301.
• IPs permitidos. Qualquer endereço aceita chamadas de qualquer lugar. Só estes aceita chamadas apenas dos endereços que você listar: IPv4, IPv6 ou faixas CIDR como 203.0.113.10, 198.51.100.0/24, separados por vírgulas, até 64 itens. Use o endereço público de onde o seu servidor faz as chamadas, e não um endereço de dentro da rede do seu escritório ou da sua casa. Chamadas de qualquer outro lugar são recusadas com 40302. Deixe em Qualquer endereço para um notebook, cujo endereço muda.
• Validade. Escolha 7, 30 ou 90 dias, 1 ano, Nunca ou uma data exata. A chave para de funcionar no fim desse dia, em UTC, e a partir daí recebe o mesmo 401 de uma chave revogada.

Escolha Criar.

O que você deve ver: uma janela Chave criada mostrando a chave completa, que começa com sk-spicy-. Copie com Copiar a chave ou escolha Salvar como arquivo. Marque Já guardei esta chave em um lugar seguro e depois Concluído.

O que acabou de acontecer: esta é a única vez em que a chave completa aparece. Guardamos apenas um hash irreversível dela, então ninguém, nem a nossa equipe de suporte, consegue mostrá-la de novo. Se você a perder, revogue-a e crie outra.

Depois, na mesma página:

• Editar muda o nome, os limites, os modelos permitidos, os IPs permitidos e a validade. As alterações valem na hora.
• Revogar interrompe a chave imediatamente e não pode ser desfeito. As tarefas que já tinham sido aceitas continuam rodando e continuam sendo cobradas.
• Você pode ter até 50 chaves ativas num mesmo escopo. Use uma chave por aplicativo ou ambiente, para poder revogar uma sem parar as outras.

Coloque a chave em SPICY_API_KEY

Uma variável de ambiente é um valor com nome que o seu terminal entrega aos programas que ele inicia. O SDK, a CLI e o servidor MCP oficiais, e todos os exemplos desta documentação, leem a sua chave de uma variável chamada SPICY_API_KEY. Assim, a chave nunca precisa ser digitada num comando nem salva dentro de um projeto.

Primeiro abra um terminal: no macOS, aperte Cmd + Espaço, digite Terminal e aperte Enter. No Windows, abra o menu Iniciar, digite PowerShell e abra o Windows PowerShell.

export SPICY_API_KEY="sk-spicy-paste-your-key-here"

nano ~/.zshrc

echo "${SPICY_API_KEY:0:9}"

Num servidor, defina SPICY_API_KEY nas configurações de segredos ou de ambiente do seu provedor de hospedagem, e não num arquivo dentro do seu projeto.

Faça uma chamada de teste grátis

Esta chamada consulta o seu saldo. Ela não custa nada, não cria nada e prova três coisas de uma vez: a chave está definida, a chave é válida e a sua conta tem permissão para chamar a API.

curl https://api.spicyapi.ai/api/v1/chat/credit \
  -H "Authorization: Bearer $SPICY_API_KEY"

Esperado: uma resposta como esta (resumida):

{
  "code": 200,
  "msg": "success",
  "data": {
    "available": "25",
    "held": "0",
    "total": "25"
  },
  "request_id": "req_01k..."
}

O que significa: "code": 200 é sucesso. Os valores estão em dólares americanos, escritos como texto. available é o que você pode gastar em novas gerações, held é o que está reservado para gerações ainda em andamento, e total é a soma dos dois. A resposta real também traz um objeto funding, que separa o dinheiro pago de eventuais verbas promocionais; por enquanto, você pode ignorá-lo.

Se aparecer outra coisa:

Prefere não usar curl? A CLI faz o mesmo com spicyapi balance.