Geliştirici rehberi

Hızlı başlangıç

API anahtarını tanımla, ücret teklifi al ve ilk üretimini başlat. cURL, Python ve JavaScript örnekleriyle sonucu takip et.

Güncellendi: 2 Ekim 2026

Üretime başlamak için önce ücret teklifi (quote) alır, ardından üretim isteğini (generation) gönderirsin. Ücret teklifi, göndereceğin girdiye göre ayrılacak kredi tutarını belirtir. Kullanıma göre ücretlendirilen modellerde bu tutar, ücretin üst sınırıdır. Üretim başladıktan sonra dönen üretim kaydından (job) durumu takip edebilirsin.

1. API anahtarını tanımla

Terminal

export RAYWAKE_API_KEY="your key from the API keys page"

Örnekteki anahtar değerini kendi API anahtarınla değiştir.

2. Örnek istekleri çalıştır

# 1. Göndereceğin girdi için ücret teklifi al; teklif en fazla 10 dakika geçerlidir.
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-pro",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light",
    "aspect_ratio": "1:1"
  }
}'

# 2. İlk adımdaki quote_id ile üretimi başlat.
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "nano-banana-pro", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light","aspect_ratio":"1:1"}}'

# 3. Üretimin durumunu sorgula; son duruma ulaşmadıysa bu sorguyu tekrarla.
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

cURL örneğinde istekleri sırayla gönder. QUOTE_ID ve JOB_ID alanlarını önceki yanıtlardan aldığın değerlerle değiştir. Python ve JavaScript örnekleri durum sorgulamasını bir döngüyle yapar. cURL örneğindeki son komut ise durumu bir kez sorgular; gerektiğinde bu sorguyu tekrarla.

3. Yanıtı incele

Tamamlanan bir üretimin kaydı aşağıdaki gibi görünür. outputs alanındaki bağlantılardan dosyaları indirebilirsin. Bu bağlantıların imzası 7 gün geçerlidir. Dosya hâlâ saklanıyorsa yeni bir bağlantı almak için üretim kaydını yeniden sorgula.

Örnek yanıt

{
  "job_id": "5b0e6c1e-9f5a-4a7e-8f3e-0c6f9d2a41b7",
  "status": "succeeded",
  "model": "nano-banana-pro",
  "prompt": "A red ceramic cup on a wooden table, soft morning light",
  "image_url": "https://…/media/outputs/…/0",
  "outputs": [
    { "type": "image", "url": "https://…/media/outputs/…/0", "mime_type": "image/png", "thumbnail_url": "https://…" }
  ],
  "error": null,
  "quote_id": "9c1d4b7e-2f6a-4e0b-8d3c-5a7f1e2b6c90",
  "credits": 24,
  "created_at": "2026-09-25T12:00:00Z",
  "completed_at": "2026-09-25T12:00:14Z"
}

Sonraki bölüm: Kimlik doğrulama →