> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# API Keys & Billing
> Crie e gerencie chaves de API, adicione saldo à sua conta de API e entenda os preços por modelo para lançar integrações com o Krea com custos previsíveis.
## 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](https://www.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](/developers/tutorials/train-image-style#use-your-trained-style) 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:
```javascript Node.js theme={null}
// 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}`);
```
```bash cURL theme={null}
curl -X POST https://api.krea.ai/generate/image/bfl/flux-1-dev \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a serene mountain landscape at sunset",
"width": 1024,
"height": 576
}'
```
```python Python theme={null}
import requests
API_BASE = "https://api.krea.ai"
API_TOKEN = "your-api-token"
response = requests.post(
f"{API_BASE}/generate/image/bfl/flux-1-dev",
headers={
"Authorization": f"Bearer {API_TOKEN}",
"Content-Type": "application/json"
},
json={
"prompt": "a serene mountain landscape at sunset",
"width": 1024,
"height": 576
}
)
job = response.json()
print(f"Job ID: {job['job_id']}")
```
```go Go theme={null}
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
apiBase := "https://api.krea.ai"
apiToken := "your-api-token"
payload := map[string]interface{}{
"prompt": "a serene mountain landscape at sunset",
"width": 1024,
"height": 576,
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", apiBase+"/generate/image/bfl/flux-1-dev", bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer "+apiToken)
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
var job map[string]interface{}
json.NewDecoder(resp.Body).Decode(&job)
fmt.Printf("Job ID: %s\n", job["job_id"])
}
```
## Preços
Para preços por modelo, veja [krea.ai/features/api ↗](https://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 ↗](mailto: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**:
```json theme={null}
{
"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/](https://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/](https://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/](https://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 ↗](mailto:sales@krea.ai) para discutir cobrança enterprise.
## Próximos passos
Faça sua primeira requisição à API
Explore todos os endpoints disponíveis
Entenda os estados do job e o polling
Entenda os limites da API por nível de plano