# Ü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.

Canonical: https://raywake.si/tr/docs/reference/generate
Last updated: 2026-10-31

`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ı**

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `Idempotency-Key` | string | Yeni bir üretim için UUID gibi benzersiz bir değer. Aynı üretime ait isteği tekrarlarken aynı değeri kullan. Zorunlu. |

**İstek gövdesi**

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `model` | string | Ücret teklifinin alındığı modelin kimliği. Zorunlu. |
| `input` | object | Ücret teklifi alırken gönderdiğin girdinin aynısı. Zorunlu. |
| `quote_id` | string | Bu model ve girdi için alınmış, süresi dolmamış ücret teklifinin kimliği. Zorunlu. |
| `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. |

**Sorgu parametreleri**

| 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. Varsayılan: `false`. |

**Example**

cURL:

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

Python:

```python
import json, os, requests

response = requests.post(
    "https://api.raywake.com/v1/generate",
    headers={"Authorization": f"Bearer {os.environ['RAYWAKE_API_KEY']}", "Idempotency-Key": "YOUR-UUID"},
    json=json.loads(r'''{
        "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"
    }'''),
)
print(response.json())
```

JavaScript:

```javascript
const response = await fetch("https://api.raywake.com/v1/generate", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.RAYWAKE_API_KEY}`, "Content-Type": "application/json", "Idempotency-Key": "YOUR-UUID" },
  body: JSON.stringify({
    "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"
  }),
});
console.log(await response.json());
```

Yanıt olarak bir üretim kaydı döner. Yanıttaki alanlar için [Üretim kayıtları](https://raywake.si/tr/docs/reference/jobs) 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ı](https://raywake.si/api-keys) 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"]
```

## İlgili

- [API dokümantasyonu](https://raywake.si/tr/docs)
