Dokumentasi API

Panggil model gambar lewat REST API atau MCP, memakai saldo Rupiah yang sama dengan dashboard. Autentikasi cukup dengan satu API key.

Job lewat API dan MCP 10% lebih murah dari harga di dashboard.

Base URL

https://renderly-studio.app

Autentikasi

Buat API key di halaman API Keys (kunci hanya ditampilkan sekali, simpan baik-baik). Sertakan di setiap request lewat header Authorization:

Authorization: Bearer rsk_live_...

Daftar model

Ambil semua model aktif beserta status dan rentang harga. Endpoint ini publik.

GET/v1/models

curl

curl https://renderly-studio.app/v1/models

Buat gambar

Membuat job baru. Harga dihitung dan saldo ditahan saat itu juga, lalu ditangkap saat job berhasil. Parameter: model, prompt (wajib), resolution (1K/2K/4K, default 2K), aspect (default 1:1), n (default 1), reference_urls (opsional).

POST/v1/images

text-to-image (t2i)

curl -X POST https://renderly-studio.app/v1/images \
  -H "Authorization: Bearer rsk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "kopi senja di meja kayu",
    "resolution": "2K",
    "aspect": "1:1",
    "n": 1
  }'

image-to-image (i2i)

curl -X POST https://renderly-studio.app/v1/images \
  -H "Authorization: Bearer rsk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "ganti latar jadi studio putih bersih",
    "resolution": "2K",
    "reference_urls": ["https://cdn.contoh.com/foto-produk.jpg"]
  }'

reference_urls mengaktifkan mode i2i (edit dari gambar). Hanya untuk model yang menerima referensi - cek field MaxRefImages di GET /v1/models (di tool MCP, field yang sama muncul sebagai max_ref_images). Keduanya balas 202:

respons 202

{
  "job_id": "job_9f3a...",
  "price_idr": 200,
  "status": "queued"
}

Cek status job

Pantau job dengan job_id dari langkah sebelumnya. Status berpindah dari queued ke running lalu succeeded atau failed. Hasil muncul di results saat selesai.

GET/v1/jobs/{job_id}

curl

curl https://renderly-studio.app/v1/jobs/job_9f3a... \
  -H "Authorization: Bearer rsk_live_..."

respons

{
  "job_id": "job_9f3a...",
  "status": "succeeded",
  "results": ["https://cdn.../hasil.jpg"]
}

Cek saldo

Menampilkan profil dan saldo Rupiah kamu saat ini.

GET/me

curl

curl https://renderly-studio.app/me \
  -H "Authorization: Bearer rsk_live_..."

respons

{
  "user_id": 12,
  "email": "kamu@contoh.com",
  "balance_idr": 48250
}

Harga dan penagihan

Harga per job dikembalikan dalam Rupiah di field price_idr saat kamu membuat gambar.
Saldo ditahan saat job dibuat, ditangkap saat berhasil, dan dikembalikan kalau job gagal permanen.
Kombinasi model dan resolusi yang belum punya harga aktif akan ditolak, bukan ditagih dengan harga lain.

Format error

Error selalu berupa JSON {"error": "..."} dengan pesan berbahasa Indonesia.

Status	Kapan terjadi
400	Body tidak valid atau field wajib kosong (model, prompt).
401	API key tidak ada atau tidak valid.
402	Saldo tidak cukup untuk harga job ini.
404	Model tidak tersedia atau job tidak ditemukan.
422	Kombinasi model/resolusi belum berharga, atau referensi melebihi batas.

MCP server

Renderly Studio juga jalan sebagai MCP server, jadi bisa dipakai langsung dari klien seperti Claude atau Cursor. Tambahkan konfigurasi berikut dengan API key kamu:

konfigurasi MCP

{
  "mcpServers": {
    "renderly": {
      "url": "https://renderly-studio.app/mcp",
      "headers": {
        "Authorization": "Bearer rsk_live_..."
      }
    }
  }
}

Tools yang tersedia

list_models

Daftar model beserta status dan rentang harga IDR.

generate_image

Buat gambar. Menahan saldo dan mengantre job.

get_job

Cek status dan hasil salah satu job kamu.

get_balance

Lihat saldo IDR kamu saat ini.