Documentation
Documentation
Authentification
Toutes les requĂȘtes API nĂ©cessitent une authentification Ă l'aide d'un jeton Bearer.
Utilisation de votre clé API
Incluez votre clĂ© API dans l'en-tĂȘte Authorization de chaque requĂȘte :
Authorization: Bearer ${RENDERFUL_API_KEY}Developer API keys typically start with sk_ (legacy keys may start with vega_). Agent keys start with rf_.
Exemple de RequĂȘte
curl -X POST https://api.renderful.ai/api/v1/generations \
-H "Authorization: Bearer ${RENDERFUL_API_KEY}" \
-H "Content-Type: application/json" \
-d '{"type":"text-to-image","model":"flux-dev","prompt":"A sunset"}'Bonnes Pratiques de Sécurité
- ⹠Ne jamais exposer votre clé API dans du code cÎté client
- ⹠Utiliser des variables d'environnement pour stocker votre clé
- ⹠Faire pivoter les clés périodiquement
- ⹠Utiliser des clés différentes pour le développement et la production
Balance endpoints by key type
Use the balance endpoint that matches the key prefix you are authenticating with.
| Key Type | Prefix | Balance Endpoint |
|---|---|---|
| Developer API key | sk_ / vega_ | GET /api/v1/account/balance |
| Agent API key | rf_ | GET /api/v1/agents/balance |
Query developer balance
curl -X GET https://api.renderful.ai/api/v1/account/balance \
-H "Authorization: Bearer sk_your_api_key"Format de Clé API
Les clés API Renderful suivent un format spécifique pour une identification facile :
| Préfixe | Description |
|---|---|
| sk_ | Developer API key for dashboard-created server-side integrations |
| vega_ | Legacy developer API key format still accepted for existing integrations |
| rf_ | Agent API key returned by POST /api/v1/agents/register |