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.
| Alan | Tür | Açıklama |
|---|---|---|
Idempotency-Keyzorunlu | string | Yeni bir üretim için UUID gibi benzersiz bir değer. Aynı üretime ait isteği tekrarlarken aynı değeri kullan. |
| Alan | Tür | Açıklama |
|---|---|---|
modelzorunlu | string | Ücret teklifinin alındığı modelin kimliği. |
inputzorunlu | object | Ücret teklifi alırken gönderdiğin girdinin aynısı. |
quote_idzorunlu | string | Bu model ve girdi için alınmış, süresi dolmamış ücret teklifinin kimliği. |
webhook_url | string | 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. |
| Alan | Tür | Açıklama |
|---|---|---|
wait | boolean | 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. |
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.
# 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"]