Saltar para o conteúdo principal

Criar chaves de API

Existem dois tipos de tokens de API:
  • Os tokens de API pessoais atuam como o utilizador: os pedidos são executados na sua própria conta Krea, com a sua função na workspace e acesso aos seus estilos. Qualquer membro da workspace pode criar um, e um token pessoal deixa de funcionar se sair da workspace.
  • Os tokens de API de serviço atuam como um utilizador de serviço separado na sua workspace, e não como a pessoa que os criou. Apenas os proprietários e administradores da workspace os podem criar. Os tokens de serviço continuam a funcionar se o seu criador sair da workspace. Os proprietários e administradores da workspace podem ver todos os tokens da workspace, com os gastos dos últimos 30 dias registados por token de serviço.
Para criar uma chave de API:
  1. Aceda a krea.ai/app/api/tokens
  2. Clique em Create Personal Token ou Create Service Token
  3. Atribua à chave um nome descritivo
  4. Guarde o token em segurança — só o verá uma vez!
Os tokens de API pessoais funcionam como a sua própria conta Krea, pelo que os estilos que treinou na aplicação ficam diretamente disponíveis para eles. Os tokens de API de serviço funcionam como uma identidade de utilizador separada dentro da sua workspace: os estilos treinados na aplicação não estarão acessíveis através de um token de serviço, e os estilos treinados através de um token de serviço não aparecerão na aplicação, a menos que sejam partilhados com a workspace. Consulte Treinar um estilo personalizado para mais detalhes.
Diretrizes de segurança
  • Armazene os tokens em variáveis de ambiente, nunca no código
  • Utilize tokens diferentes para desenvolvimento e produção
  • Revogue tokens imediatamente caso sejam comprometidos
  • Nunca faça commit de tokens para o controlo de versões
  • Nunca partilhe tokens publicamente

Utilizar chaves de API

Inclua o seu token no cabeçalho Authorization de todos os pedidos:

Preços

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

Como funciona a faturação da API

As chamadas diretas à API e as ligações MCP que utilizam um token de API são deduzidas a um saldo separado em USD na sua workspace — independente das unidades de computação utilizadas pela aplicação web do Krea. As ligações MCP que utilizam OAuth são faturadas à conta Krea em sessão, usando unidades de computação. O acesso à API tem de estar ativado na sua workspace antes de poder utilizar chaves de API; caso contrário, contacte support@krea.ai ↗.
A Agent API e as ferramentas do agente são uma exceção: os turnos do agente utilizam o saldo de unidades de computação da workspace, incluindo quando a autenticação é feita com uma chave de API. Não utilizam o saldo de API.
Os trabalhos falhados e cancelados não são faturados. Paga apenas pelos trabalhos concluídos.

Quando o saldo se esgota

Os trabalhos em curso terminam normalmente. Os novos pedidos à API são rejeitados com HTTP 402 Payment Required:
Carregue saldo em krea.ai/app/api/ para retomar. Não existe um endpoint público para consultar o seu saldo de forma programática — monitorize-o na aplicação. Esse corpo corresponde ao 402 de saldo de API. As respostas 402 de Zero Data Retention e as restantes estão listadas em Erros e depuração.

Adicionar saldo de API

Adicione fundos em krea.ai/app/api/. Apenas os proprietários da workspace podem adicionar saldo de API.
  • Montantes predefinidos: $10, $25, $50, $100
  • Montante personalizado: $5 mínimo, $10,000 máximo
  • Pago através do Stripe Checkout; o saldo é aplicado imediatamente após o sucesso

Acompanhar a utilização

Consulte a página API Usage em krea.ai/app/api/usage para ver as tarefas de API concluídas e os custos estimados num intervalo de datas à sua escolha. Os gestores da workspace veem a utilização de toda a workspace; os restantes membros veem a utilização dos seus próprios tokens. O cartão de saldo de API em krea.ai/app/api/ também apresenta o custo estimado de API dos últimos 7 dias.

Enterprise

Os clientes com maior volume podem ser faturados mensalmente em condições Net 30, em vez de pagar antecipadamente. Contacte sales@krea.ai ↗ para discutir a faturação enterprise.

Próximos passos

Playground interativo

Faça o seu primeiro pedido à API

APIs dos modelos

Explore todos os endpoints disponíveis

Ciclo de vida do trabalho

Compreenda os estados dos trabalhos e o polling

Limites de taxa

Compreenda os limites da API por nível de plano