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.
- Aceda a krea.ai/app/api/tokens
- Clique em Create Personal Token ou Create Service Token
- Atribua à chave um nome descritivo
- 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.
Utilizar chaves de API
Inclua o seu token no cabeçalhoAuthorization 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: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