Console e equipes

O console, em spicyapi.ai/console, é onde você gerencia a sua conta pelo navegador: dinheiro, chaves de API, registros, colegas de equipe e configurações. Os seus próprios programas nunca usam o console. Eles chamam a API com uma chave de API.

É a sua primeira vez aqui? Siga antes Prepare sua conta: o guia mostra, em ordem, como criar a conta, adicionar saldo e criar uma chave. Esta página é a referência de todo o resto do console.

Como se localizar

No topo de todas as páginas: o seu saldo com o botão Recarregar, Modelos, Documentação, o sino de notificações e Buscar página (aperte ⌘K no macOS ou Ctrl + K no Windows e no Linux e digite o nome de uma página do console).

À esquerda, a barra lateral. Bem no topo fica o seletor de escopo, que decide qual conta ou equipe você está vendo (veja Escopo pessoal e equipes). Abaixo dele, as páginas ficam agrupadas:

No celular, abra a barra lateral pelo botão de menu.

As páginas do console num relance

Todos os endereços começam com https://spicyapi.ai. Os endereços do console não têm prefixo de idioma.

O que cada página faz

Visão geral

A primeira página depois que você entra na conta.

• Lista de Primeiros passos: Verificar seu e-mail, Adicionar fundos, Execute sua primeira tarefa, além de links para desenvolver com a API ou criar sem código. Esconda a lista com Ocultar primeiros passos quando terminar.
• Saldo disponível, com o valor retido para tarefas ainda em andamento e quanto você gastou nos últimos 7 dias.
• Requisições nos últimos 7 dias e Erros nos últimos 7 dias, com links para Ver uso e Ver logs.
• Modelos usados recentemente e Tarefas recentes.
• Um aviso quando o saldo está baixo ou zerado. Com o saldo zerado, novas tarefas são recusadas até você recarregar; as tarefas já aceitas terminam mesmo assim.

Faturamento

Faturamento tem três abas: Visão geral, Consumo e Faturas.

Faturamento → Visão geral (/console/billing)

• Adicionar saldo por cartão, cripto ou, quando disponível, transferência manual. O passo a passo, os prazos e o que fazer quando um pagamento não aparece estão em Prepare sua conta → Adicione saldo.
• Pedidos de recarga: todas as recargas, com o status de cada uma (Pendente, Pago, Cancelado, Reembolsado). Abra um pedido manual pendente com Concluir o pagamento para ver as instruções de pagamento, enviar a referência da sua transação ou usar Cancelar pedido pendente se você ainda não pagou.
• Recarga automática: salve um cartão e deixe que a recarga seja feita quando o saldo ficar baixo. As regras exatas, incluindo o que acontece quando uma cobrança falha, estão em Prepare sua conta → Recarga automática.
• Detalhes do saldo: só aparece se a sua conta tiver bônus promocional ou crédito aprovado. Lista cada lote de bônus promocional com a data de expiração.
• Histórico do saldo: toda movimentação de dinheiro, da mais recente para a mais antiga. Filtre por tipo e por período, ou use Exportar CSV. Os lançamentos mais comuns são Recarga, Bônus, Retido (valor separado quando uma tarefa é aceita), Cobrado (o preço final de uma tarefa bem-sucedida), Valor liberado (a parte não usada da reserva que voltou) e Devolvido (a reserva inteira devolvida depois de uma falha ou de um tempo limite estourado). Veja Cobrança para entender como as cobranças funcionam.

Faturamento → Consumo (/console/billing/usage)

Tarefas e gastos por dia, num gráfico, dos últimos 7, 30 ou 90 dias ou de um período personalizado de até 92 dias (dias em UTC). Abaixo dele, Por modelo: tarefas, falhas, gastos e participação de cada modelo, com Ver tarefas para pular direto para essas tarefas em Registros. Exportar CSV baixa os totais diários mostrados. O endpoint de consumo da API só informa a chave que o chama; esta página mostra o escopo inteiro selecionado na barra lateral.

Faturamento → Faturas (/console/billing/invoices)

Informe os seus dados de faturamento, emita uma fatura de pagamento para uma recarga paga ou um extrato de uso para um mês encerrado, e gere Extratos mensais da conta (CSV). No que cada documento se diferencia, e como corrigir um deles, está em Prepare sua conta → Faturas e recibos.

Chaves de API

Crie, edite e revogue as chaves que os seus programas usam. A lista mostra, para cada chave, o valor mascarado, quanto já foi gasto, os limites, os modelos permitidos, a lista de IPs permitidos, a validade e quando ela foi usada pela última vez. Busque pelo nome ou pela chave mascarada, e filtre por Ativa, Expirada ou Revogada.

• Criar chave cria uma chave no escopo selecionado na barra lateral. A chave completa aparece uma única vez.
• Editar muda o nome, os limites de gasto (diário, mensal, acumulado), os modelos permitidos, a lista de IPs permitidos e a validade. Na edição, um limite em branco significa sem limite.
• Revogar desativa a chave na hora, e isso não pode ser desfeito. As tarefas já aceitas continuam rodando e são cobradas.

Cada campo é explicado em Prepare sua conta → Crie uma chave de API. Os códigos de erro que cada restrição gera estão em Autenticação.

Numa equipe: você só pode criar e gerenciar as chaves da equipe com a função Proprietário, Administrador ou Desenvolvedor. O consumo e os limites de uma chave da equipe contam para a equipe, e as tarefas dela são pagas pelo proprietário da equipe.

Webhooks

Um webhook é uma mensagem que a SpicyAPI envia para o seu próprio servidor quando uma tarefa termina, para que você não precise ficar perguntando. Você escolhe o endereço tarefa por tarefa, com callBackUrl. Esta página faz duas coisas.

Chave de assinatura de webhooks. Todo callback é assinado, para que o seu servidor possa conferir que ele veio mesmo da SpicyAPI. A sua conta tem uma chave de assinatura, compartilhada por todas as chaves de API dela, e o valor dessa chave aparece uma única vez, no momento em que é criada. Contas novas já têm uma chave que ninguém viu, então o cartão pode dizer Configurada sem que você tenha nada para copiar:

1. Escolha Gerar (se o cartão disser Não configurada) ou Trocar (se disser Configurada).
2. Copie a nova chave para as configurações do seu servidor, normalmente como SPICY_WEBHOOK_SECRET.
3. Escolha Já salvei.

Entregas de webhook. Todas as tentativas de callback da sua conta, das mais recentes para as mais antigas, filtráveis por Entregue, Tentando novamente e Falhou, com o número de tentativas e o horário da próxima. Reenviar envia de novo a mensagem assinada original; garanta que o seu servidor consegue receber a mesma mensagem duas vezes sem problema. Uma entrega cujo conteúdo armazenado já foi apagado pelas suas configurações de retenção não pode ser reenviada.

Integrações

Configurações prontas para copiar e colar, para ferramentas que funcionam com a SpicyAPI. Escolha uma ferramenta para ver a configuração dela e Abrir docs.

• Fundamentos da conexão: a URL base para clientes compatíveis com OpenAI e um atalho Criar chave. Dê à chave o nome da ferramenta que vai usá-la.
• Ferramentas oficiais: o SDK para TypeScript, a CLI, o servidor MCP e o Agent Skill.
• Clientes compatíveis com OpenAI: ferramentas que permitem trocar a URL base, para modelos de texto e vídeo. A geração de imagens não está nos endpoints compatíveis.
• Agentes de código: editores e agentes que adicionam o servidor MCP, que pede a sua confirmação antes de toda cobrança.

Os trechos usam o marcador MODEL_ID_FROM_CATALOG: troque-o por um ID de modelo exato do catálogo atual (GET /api/v1/models, spicyapi models list ou listModels()). Veja Catálogo de modelos e schemas.

Registros

Todas as tarefas, das mais recentes para as mais antigas, inclusive as que falharam. Cada linha mostra a tarefa, o modelo, o estado, a latência e o custo.

• Filtros: estado, modelo e período. A caixa de busca aceita um ID exato da tarefa ou da requisição, que é o jeito mais rápido de achar a tarefa por trás de um relato de erro. Até 500 linhas são carregadas na página; restrinja os filtros para ver mais.
• Exportar CSV exporta todas as tarefas que correspondem aos filtros: por padrão, os últimos 30 dias, com no máximo 92 dias ou 10.000 linhas.
• Abrir os detalhes de uma tarefa mostra o estado, o custo, o horário de início e de término, a chave usada, o ID da tarefa e o ID da requisição, o código de erro e o Motivo da falha, os parâmetros da requisição, a resposta e os links de download (Obter link; cada link expira, e você pode gerar outro).

O quadro de custo mostra o valor reservado durante a execução e a cobrança real após a liquidação. Uma tarefa que falhou pode ser cobrada por uma recusa de conteúdo explicitamente informada na página do modelo. Consulte a liquidação em vez de deduzir um reembolso pelo estado.

Três ações aparecem nos detalhes da tarefa:

Nenhuma delas cancela uma tarefa em andamento: tarefas aceitas não podem ser canceladas. Veja Retenção e destruição para saber o que a exclusão mantém e o que remove.

Numa equipe: todos os membros veem as tarefas da equipe, com estado e custo. Só Proprietário, Administrador e Desenvolvedor veem prompts, resultados e links de download. As três ações acima só estão disponíveis para a conta que pagou pela tarefa.

Equipe

Crie equipes, convide pessoas, mude funções, defina limites de gasto da equipe e saia de uma equipe ou passe-a adiante. Trabalha sozinho? Você não precisa de equipe: as suas chaves, o seu saldo e o seu consumo já funcionam por conta própria. Tudo sobre equipes está em Equipes, mais abaixo.

Configurações

Uma única página, dividida em grupos.

Conta

• E-mail, marcado como Confirmado ou Não confirmado. Troque o e-mail de login com Alterar e-mail de acesso: enviamos um link de confirmação para o novo endereço (válido por 20 minutos) e avisamos o antigo. Você precisa da sua senha atual.
• Nome de exibição, ID da conta (informe-o quando falar com o suporte) e Membro desde.

Segurança

• Senha. Trocá-la desconecta todos os dispositivos. Uma conta criada com Google ou GitHub não tem senha até você escolher Enviar link e definir uma; você precisa de senha para encerrar a conta ou transferir uma equipe.
• Dispositivos conectados. Use Desconectar em qualquer dispositivo que você não reconheça, ou Encerrar todas as sessões (inclusive neste dispositivo) se achar que outra pessoa tem acesso. Troque a sua senha logo em seguida.
• Autenticação em dois fatores. Escolha Configurar 2FA, digite a sua senha atual, adicione a conta a um aplicativo autenticador e digite o código de seis dígitos dele. A partir daí, todo login pede um código. Você também recebe dez códigos de recuperação de uso único: guarde-os em outro lugar que não seja o seu celular, porque sem o celular eles são a única forma de voltar a entrar, e eles não podem ser mostrados de novo. Novos códigos de recuperação substitui todos eles; Desativar 2FA remove a autenticação em dois fatores. As duas opções pedem antes que você confirme que é você mesmo.
• Atividade de segurança: logins recentes, dispositivos novos e alterações de credenciais.

Preferências

• Idioma dos erros da API: o idioma do msg nas respostas de erro e do errorMessage das tarefas (nas consultas de estado e nos webhooks) para as requisições feitas com as suas chaves de API. O padrão é inglês. O cabeçalho Accept-Language da própria requisição tem prioridade, e os códigos em que o seu código deve se basear (code, errorCode) nunca mudam. Veja Erros.

Cobrança e dados

• Atalhos para Dados de cobrança e extratos (em Faturamento → Faturas) e para Dados e privacidade (a página Proteção de dados).

Zona de risco: Encerrar conta

Encerrar a conta desconecta todos os dispositivos, revoga permanentemente todas as chaves de API e apaga a mídia gerada e o conteúdo das tarefas que estava guardado. Os registros de cobrança, auditoria e reconciliação são mantidos, como descreve a Política de Privacidade. Os pedidos de recarga abandonados que você nunca pagou são cancelados para você. O encerramento só fica em espera enquanto:

• houver tarefas na fila ou em execução, ou tarefas terminadas que ainda estão sendo liquidadas (em geral, em até um minuto);
• um pagamento de recarga ainda estiver sendo processado (isso se resolve sozinho quando o provedor de pagamento confirma ou libera o pagamento, em geral em alguns minutos; fale com o suporte se ele ainda estiver lá depois de uma hora);
• a conta tiver dívida (crédito aprovado em uso ou saldo negativo), que você quita fazendo uma recarga;
• uma equipe de que você é proprietário ainda precisar ser transferida para outro membro ou ficar sem nenhum outro membro.

O console lista tudo o que ainda estiver no caminho. Você confirma com a sua senha atual ou, se se cadastrou com o Google ou outro provedor de login e não tem senha, com um código de 6 dígitos que enviamos por e-mail (válido por 15 minutos).

Notificações

• Alerta de saldo baixo. Ligue o alerta e escolha um limite ($5, $10, $25, $50 ou $100). Quando o seu saldo disponível cair abaixo dele, você recebe um alerta no sino de notificações, e também um e-mail se a sua conta tiver endereço de e-mail. Você só é alertado de novo depois que o saldo voltar a ficar igual ou acima do limite e cair abaixo dele outra vez. O saldo é verificado a cada 10 minutos, mais ou menos.
• Novidades dos modelos que você segue. Siga um modelo a partir da página dele em spicyapi.ai; Gerenciar abre a lista de modelos seguidos e as novidades do produto.
• Entrega. Os alertas dentro do app estão sempre ligados. Os e-mails de Novidades do produto e de Ofertas e comunicados podem ser ligados ou desligados. Avisos de segurança, de cobrança e críticos para o serviço são sempre enviados.

Proteção de dados

• Retenção: três relógios separados, para Resultados gerados, Texto dos prompts e Arquivos enviados. Você só pode deixá-los mais curtos que os máximos da plataforma (14 dias para resultados, 30 dias para o texto dos prompts, 24 horas para uploads). Encurtar um relógio pode apagar conteúdo de tarefas que você já rodou na próxima limpeza, que acontece em até um minuto; o console conta o que será afetado antes de você confirmar, e o conteúdo apagado não pode ser restaurado. Baixe antes tudo o que quiser guardar.
• Retenção do conteúdo das tarefas: um cartão mais antigo, com duas configurações. Reter conteúdo das tarefas mostra, em dias, por quanto tempo o conteúdo das tarefas é guardado; o prazo é definido pelos três relógios acima. Apagar logo após a conclusão apaga o conteúdo de uma tarefa terminada cerca de uma hora depois que os resultados dela foram armazenados e o webhook foi entregue.
• Para onde vão seus dados: um resumo do que a Política de Privacidade já garante, incluindo que as suas entradas e os seus resultados não são usados para treinar modelos.
• Baixar meus dados: um arquivo JSON com o seu perfil, as suas funções em equipes, os detalhes das suas chaves de API (nunca as chaves em si), os dados de tarefas ainda guardados e os registros de cobrança. Os arquivos de mídia não vêm incluídos, então baixe os resultados separadamente.

As regras completas, incluindo a substituição por requisição e o que a exclusão mantém, estão em Retenção e destruição.

Suporte

Abra uma conversa privada que só você e o suporte da SpicyAPI podem ler. Escolha Nova conversa, um título, um assunto (Conta, Faturamento, Integração de API, Tarefa ou resultado, Privacidade, Empresas ou Outro assunto) e descreva o que aconteceu. As respostas aparecem na conversa (com status Aguardando suporte, Aguardando sua resposta, Resolvida ou Encerrada) e no sino de notificações.

Ajude a gente a ajudar você rápido: inclua o ID da tarefa, o request_id de uma resposta de erro ou o ID do pedido de recarga, e mais ou menos quando aconteceu (em UTC). Nunca cole uma chave de API, uma senha ou dados de cartão. Você também pode escrever para support@spicyapi.ai.

Equipes

Escopo pessoal e equipes

Toda conta tem um escopo Pessoal. Ninguém mais faz parte dele e, trabalhando sozinho, ele é tudo de que você precisa: as suas chaves pessoais, o seu saldo e o seu consumo funcionam sem equipe.

Uma equipe permite que colegas compartilhem chaves de API, vejam o mesmo histórico de tarefas e trabalhem sob limites de gasto compartilhados. Cada equipe tem os próprios membros, as próprias chaves e os próprios limites.

O seletor de escopo, no topo da barra lateral, decide o que o console mostra:

• Pessoal: só o seu próprio escopo.
• O nome de uma equipe: só as chaves, as tarefas, o consumo e a atividade dessa equipe.
• Todos os escopos: tudo a que você tem acesso, junto.
• Nova equipe: um atalho para criar uma.

Ele também decide para onde vai uma nova chave de API: uma chave criada enquanto uma equipe está selecionada pertence a essa equipe.

Quem paga por uma equipe

Toda tarefa enviada com uma chave de API da equipe é paga com o saldo do proprietário da equipe. Essa é, de longe, a regra mais importante das equipes.

• Os membros nunca recarregam uma equipe e nunca veem o saldo, as recargas, os dados de pagamento ou as faturas do proprietário.
• Se você é membro e uma chave da equipe começa a retornar 40201, é o proprietário quem precisa adicionar saldo.
• As suas chaves pessoais, o seu saldo e o seu consumo nunca são compartilhados com uma equipe em que você entra, e sair de uma equipe não mexe neles.
• Um proprietário, administrador ou desenvolvedor pode criar chaves da equipe que gastam o saldo do proprietário. Proprietários: definam limites de gasto da equipe e deem às chaves os próprios limites delas.

Criar uma equipe

1. Abra Equipe e escolha Criar uma equipe (ou Nova equipe no seletor de escopo).
2. Digite um nome para a equipe (até 120 caracteres) e escolha Criar equipe.

Você passa a ser o Proprietário da equipe. Uma conta pode ser proprietária de até 10 workspaces, e o seu escopo Pessoal conta como um deles, então você pode criar até nove equipes. Não há limite para quantas equipes de outras pessoas você pode entrar.

Convidar pessoas

Só um Proprietário ou Administrador pode convidar.

Regras dos convites:

• Um convite só pode ser aceito por uma conta cujo e-mail seja igual ao endereço convidado. Um e-mail diferente recebe Please sign in with the invited email address to accept this invite.
• Contas privadas de autocustódia não podem entrar em equipes, porque não têm endereço de e-mail.
• Um convite pendente por e-mail em cada equipe. Quem já é membro não pode ser convidado de novo.
• Uma equipe pode ter até 100 membros, contando o proprietário.
• Revogar cancela um convite pendente a qualquer momento; você pode convidar a mesma pessoa de novo depois.
• Um convite expirado não pode ser aceito. Envie um novo.

Funções e permissões

No console, as funções aparecem com estes nomes. A API e as exportações usam os nomes em minúsculas entre parênteses.

Além disso:

• Ninguém pode mudar a própria função. A função do proprietário só muda por meio de uma transferência.
• Repetir, destruir ou remover uma tarefa só é possível para a conta que pagou por ela, qualquer que seja a função.
• Um membro com uma função que não pode ler conteúdo vê Sua função permite ver o status e o consumo das tarefas, mas não ler prompts nem resultados.
• Ninguém além do proprietário vê o saldo pessoal, as recargas, os dados de pagamento ou as faturas do proprietário. Atividade da equipe só lista movimentações de dinheiro causadas pelas tarefas da equipe.

Limites de gasto da equipe

Toda equipe (e também o seu escopo Pessoal) tem um limite diário e um mensal, em dólares americanos, em Equipe → sua equipe → Limites de gasto. Proprietários, administradores e gestores de orçamento podem alterá-los com Editar e depois Salvar limites.

• Eles cobrem, somadas, todas as tarefas enviadas com as chaves desse escopo.
• Contam tanto o dinheiro já cobrado quanto o dinheiro retido para tarefas ainda em andamento.
• O limite diário recomeça às 00:00 UTC; o mensal, no dia 1º de cada mês, às 00:00 UTC.
• O padrão é Sem limite. Digite 0 para não ter limite. Deixar um campo em branco mantém o valor atual.
• Uma tarefa que ultrapassaria um limite é recusada com 40202 e a mensagem Workspace daily budget has been reached ou Workspace monthly budget has been reached. Nada é criado e nada é retido.

Os limites da equipe valem além dos limites diário, mensal e acumulado de cada chave e do saldo do proprietário. O que se esgotar primeiro barra a tarefa. Veja Cobrança para todos os limites de gasto.

Mudar funções e remover membros

Abra a equipe. Em Membros, escolha uma nova função para um membro e confirme em Alterar função; a mudança vale na hora. Remover tira o membro da equipe imediatamente: ele perde o acesso à equipe, às chaves dela e à atividade dela. O proprietário não pode ser removido.

Remover um membro não revoga as chaves que ele criou ou usou. As chaves da equipe pertencem à equipe, então revogue em Chaves de API qualquer chave que essa pessoa ainda tenha.

Sair de uma equipe

Qualquer membro, menos o proprietário, pode sair: abra a equipe, escolha Sair da equipe e confirme. O acesso termina na hora, e só um novo convite traz você de volta.

Nada é apagado. As chaves, as tarefas e o consumo da equipe continuam com a equipe e continuam sendo cobrados do proprietário dela. Se você ainda tiver uma das chaves da equipe, peça a um administrador que a revogue. O seu escopo pessoal não é afetado.

O proprietário não pode simplesmente sair, porque as chaves da equipe continuariam gastando o dinheiro dele sem ninguém que pudesse gerenciá-las. Transfira a propriedade antes. Se você for o único membro, convide alguém e passe a equipe para essa pessoa.

Transferir a propriedade

Só o proprietário pode transferir, e só para alguém que já é membro.

1. Abra a equipe e vá até Zona de risco → Transferir propriedade.
2. Escolha o Novo proprietário e digite a sua Senha atual. (Uma conta criada com Google ou GitHub precisa antes definir uma senha em Configurações.)
3. Revise e escolha Transferir equipe.

A partir desse momento:

• o saldo do novo proprietário paga todas as tarefas enviadas com as chaves da equipe, e todas as chaves da equipe passam para a conta do novo proprietário;
• você passa a ser Administrador;
• as tarefas aceitas antes da transferência mantêm a cobrança original e não são canceladas.

Excluir uma equipe

Uma equipe não pode ser excluída. Uma equipe sem uso não custa nada e nunca aparece numa cobrança. Remova os membros e deixe-a parada, ou renomeie-a e reaproveite-a em vez de criar outra.

Limites das equipes num relance