Pular para o conteúdo principal

Criando chaves de API

Existem dois tipos de tokens de API:
  • Tokens de API pessoais atuam como você: as requisições são executadas na sua própria conta Krea, com a sua função no workspace e acesso aos seus estilos. Qualquer membro do workspace pode criar um, e um token pessoal deixa de funcionar se você sair do workspace.
  • Tokens de API de serviço atuam como um usuário de serviço separado no seu workspace, e não como a pessoa que os criou. Apenas proprietários e administradores do workspace podem criá-los. Tokens de serviço continuam funcionando se o criador sair do workspace. Proprietários e administradores do workspace podem ver todos os tokens do workspace, com o gasto dos últimos 30 dias acompanhado por token de serviço.
Para criar uma chave de API:
  1. Acesse krea.ai/app/api/tokens
  2. Clique em Create Personal Token ou Create Service Token
  3. Dê à sua chave um nome descritivo
  4. Salve o token com segurança—você só o verá uma vez!
Tokens de API pessoais operam como sua própria conta Krea, então os estilos que você treinou no app ficam disponíveis diretamente para eles. Tokens de API de serviço operam como uma identidade de usuário separada dentro do seu workspace: estilos treinados no app não estarão acessíveis via token de serviço, e estilos treinados via token de serviço não aparecerão no app, a menos que sejam compartilhados com o workspace. Veja Treinar um estilo personalizado para detalhes.
Diretrizes de segurança
  • Armazene tokens em variáveis de ambiente, nunca no código
  • Use tokens diferentes para desenvolvimento e produção
  • Revogue tokens imediatamente se forem comprometidos
  • Nunca faça commit de tokens em controle de versão
  • Nunca compartilhe tokens publicamente

Usando chaves de API

Inclua seu token no header Authorization de todas as requisições:

Preços

Para preços por modelo, veja krea.ai/app/api/pricing ↗. Cada modelo tem um preço fixo por geração determinado pelos parâmetros da sua requisição (resolução, qualidade, áudio, duração, referências de estilo, etc.).

Como funciona a cobrança da API

Chamadas diretas à API e conexões MCP que usam um token de API são debitadas de um saldo separado em USD no seu workspace — independente das unidades de computação usadas pelo app web do Krea. Conexões MCP que usam OAuth são cobradas da conta Krea conectada usando unidades de computação. O acesso à API precisa estar habilitado no seu workspace antes que você possa usar chaves de API; se não estiver, entre em contato com support@krea.ai ↗.
A Agent API e as ferramentas do Agent são uma exceção: os turnos do Agent usam o saldo de unidades de computação do workspace, inclusive quando autenticados com uma chave de API. Eles não usam o saldo de API.
Jobs que falham ou são cancelados não são cobrados. Você só paga por jobs concluídos.

Quando seu saldo acaba

Jobs em andamento são finalizados normalmente. Novas requisições à API são rejeitadas com HTTP 402 Payment Required:
Adicione saldo em krea.ai/app/api/ para retomar. Não há um endpoint público para verificar seu saldo programaticamente — monitore-o no app. Esse corpo é o 402 de saldo de API. O 402 de Zero Data Retention e as demais respostas 402 estão listados em Erros e depuração.

Adicionando saldo de API

Adicione fundos em krea.ai/app/api/. Apenas proprietários do workspace podem adicionar saldo de API.
  • Valores predefinidos: $10, $25, $50, $100
  • Valor personalizado: mínimo de $5, máximo de $10.000
  • Pago via Stripe Checkout; o saldo é aplicado imediatamente após a confirmação

Acompanhando o uso

Veja a página API Usage em krea.ai/app/api/usage para conferir jobs de API concluídos e custos estimados em um intervalo de datas selecionável. Gestores do workspace veem o uso de todo o workspace; os demais membros veem o uso dos seus próprios tokens. O card de saldo de API em krea.ai/app/api/ também mostra o custo estimado de API dos últimos 7 dias.

Enterprise

Clientes de maior volume podem ser faturados mensalmente em condições Net 30 em vez de pré-pagar. Entre em contato com sales@krea.ai ↗ para discutir cobrança enterprise.

Próximos passos

Playground interativo

Faça sua primeira requisição à API

APIs de modelos

Explore todos os endpoints disponíveis

Ciclo de vida do job

Entenda os estados do job e o polling

Limites de taxa

Entenda os limites da API por nível de plano