Pular para o conteúdo principal

​
Criando chaves de API

Apenas proprietários e administradores do workspace podem criar tokens de API. Se você não vê a opção de criar um token, entre em contato com o proprietário do workspace para solicitar acesso ou uma função elevada. Para criar uma chave de API:
  1. Acesse krea.ai/settings/api-tokens
  2. Verifique se você está no workspace correto (usando o seletor de workspace no canto superior esquerdo)
  3. Clique em “New Token”
  4. Dê ao seu token um nome descritivo
  5. Salve o token com segurança—você só o verá uma vez!
A API opera como sua própria identidade de usuário dentro do seu workspace. Estilos treinados no app não estarão acessíveis via API, e estilos treinados via API 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: 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.image("bfl/flux-1-dev", {
  prompt: "a serene mountain landscape at sunset",
  width: 1024,
  height: 576
});

console.log(`Job ID: ${job.job_id}`);

​
Preços

Para preços por modelo, veja krea.ai/features/api ↗. 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 ↗.
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: 
{
  "message": "Your API balance is separate from your workspace compute balance. Please top up your API balance to continue using the API."
}
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.

​
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

O gasto recente é exibido no card de saldo de API em krea.ai/app/api/ sob “API cost in the last 7 days.”

​
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