API belgeleri

Geliştirici rehberi

Üretim başlatma

Modeli, girdiyi ve geçerli ücret teklifini göndererek üretimi başlat. İstek başlıklarını ve yanıt bekleme seçeneğini incele.

Güncellendi:

POST/v1/generate

Geçerli ücret teklifindeki tutarı bakiye bakiyenden ayırır ve üretimi başlatır. generate izni gerekir.

İstek başlıkları
AlanTürAçıklama
Idempotency-Keyzorunlustring
Yeni bir üretim için UUID gibi benzersiz bir değer. Aynı üretime ait isteği tekrarlarken aynı değeri kullan.
İstek gövdesi
AlanTürAçıklama
modelzorunlustring
Ücret teklifinin alındığı modelin kimliği.
inputzorunluobject
Ücret teklifi alırken gönderdiğin girdinin aynısı.
quote_idzorunlustring
Bu model ve girdi için alınmış, süresi dolmamış ücret teklifinin kimliği.
webhook_urlstring
Herkese açık bir https adresi (443 numaralı port). Üretim bitince bu adrese imzalı bir bildirim gönderilir; aşağıdaki Webhook bölümüne bak.
Sorgu parametreleri
AlanTürAçıklama
waitboolean
true olduğunda üretim son durumuna ulaşana veya yaklaşık üç dakika dolana kadar yanıtı bekletir. Hangisi önce gerçekleşirse yanıt o zaman döner.

Varsayılan: false

curl -s -X POST https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Idempotency-Key: YOUR-UUID" \
  -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"},"quote_id":"QUOTE_ID"}'

Yanıt olarak bir üretim kaydı döner. Yanıttaki alanlar için Üretim kayıtları bölümünü incele.

Webhook

webhook_url gönderirsen sonucu sorgulamana gerek kalmaz; üretim bitince sana bildirilir. Gövde {"type": "job.succeeded" | "job.failed", "timestamp", "data"} biçimindedir. data, GET /v1/jobs/{job_id} yanıtının aynısıdır ve çıktı bağlantıları hazırdır.

Her istekte webhook-id, webhook-timestamp ve webhook-signature başlıkları bulunur (Standard Webhooks). İmza, API anahtarları sayfasındaki hesabına özel anahtarla atılır. 10 saniye içinde 2xx durum koduyla yanıt ver. Aksi halde 1 ve 5 dakika, ardından 30 dakika, 2, 6 ve 12 saat sonra yeniden deneriz. Aynı bildirimi iki kez işlememek için webhook-id değerini kullan.

Adres 443 numaralı portta https olmalı ve yalnızca herkese açık IP adreslerine çözülmelidir. Yönlendirmeler izlenmez.

Doğrulama (Python)
# pip install standardwebhooks
from standardwebhooks.webhooks import Webhook

# The signing secret from the API keys page (whsec_...)
event = Webhook(RAYWAKE_WEBHOOK_SECRET).verify(raw_body, request_headers)
if event["type"] == "job.succeeded":
    outputs = event["data"]["outputs"]