Dokumentasi

Autentikasi

Semua permintaan API memerlukan autentikasi menggunakan token Bearer.

Menggunakan Kunci API Anda

Sertakan kunci API Anda di header Authorization pada setiap permintaan:

Authorization: Bearer ${RENDERFUL_API_KEY}

Developer API keys typically start with sk_ (legacy keys may start with vega_). Agent keys start with rf_.

Contoh Permintaan

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"}'

Praktik Keamanan Terbaik

• Jangan pernah mengekspos kunci API Anda di kode sisi klien
• Gunakan variabel lingkungan untuk menyimpan kunci Anda
• Rotasi kunci secara berkala
• Gunakan kunci yang berbeda untuk development dan 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 Kunci API

Kunci API Renderful mengikuti format tertentu untuk identifikasi yang mudah:

Prefix	Deskripsi
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`