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.
- Acesse krea.ai/app/api/tokens
- Clique em Create Personal Token ou Create Service Token
- Dê à sua chave um nome descritivo
- 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.
Usando chaves de API
Inclua seu token no headerAuthorization 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: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