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

Canonical: https://raywake.si/tr/docs/quickstart
Last updated: 2026-10-25

Ü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 üretim ücretini 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

**Hızlı başlangıç**

cURL:

```bash
# 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"
```

Python:

```python
import json, os, time, uuid, requests

BASE = "https://api.raywake.com"
HEADERS = {"Authorization": f"Bearer {os.environ['RAYWAKE_API_KEY']}"}
payload = json.loads(r'''{
  "model": "nano-banana-pro",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light",
    "aspect_ratio": "1:1"
  }
}''')

# 1. Göndereceğin girdi için ücret teklifi al.
def read_response(response):
    response.raise_for_status()
    return response.json()

quote = read_response(requests.post(f"{BASE}/v1/quotes", json=payload, headers=HEADERS))
print("Price (USD):", quote["price_usd"])

# 2. Üretimi başlat; aynı isteği tekrarlarken Idempotency-Key değerini koru.
job = read_response(requests.post(
    f"{BASE}/v1/generate",
    json={**payload, "quote_id": quote["quote_id"]},
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
))

# 3. Üretim son durumuna ulaşana kadar durumunu sorgula.
# Held states (needs_review, submission_unknown, needs_reconciliation) can still change: check them again later.
while job["status"] not in ("succeeded", "failed", "needs_review", "submission_unknown", "needs_reconciliation"):
    time.sleep(2)
    job = read_response(requests.get(f"{BASE}/v1/jobs/{job['job_id']}", headers=HEADERS))

for output in job["outputs"]:
    print(output["type"], output["url"])
```

JavaScript:

```javascript
const BASE = "https://api.raywake.com";
const headers = {
  Authorization: `Bearer ${process.env.RAYWAKE_API_KEY}`,
  "Content-Type": "application/json",
};
const payload = { model: "nano-banana-pro", input: {
  "prompt": "A red ceramic cup on a wooden table, soft morning light",
  "aspect_ratio": "1:1"
} };

async function readResponse(response) {
  if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  return response.json();
}

// 1. Göndereceğin girdi için ücret teklifi al.
const quote = await fetch(`${BASE}/v1/quotes`, { method: "POST", headers, body: JSON.stringify(payload) })
  .then(readResponse);

// 2. Üretimi başlat; aynı isteği tekrarlarken Idempotency-Key değerini koru.
let job = await fetch(`${BASE}/v1/generate`, {
  method: "POST",
  headers: { ...headers, "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({ ...payload, quote_id: quote.quote_id }),
}).then(readResponse);

// 3. Üretim son durumuna ulaşana kadar durumunu sorgula.
// Held states (needs_review, submission_unknown, needs_reconciliation) can still change: check them again later.
const terminal = ["succeeded", "failed", "needs_review", "submission_unknown", "needs_reconciliation"];
while (!terminal.includes(job.status)) {
  await new Promise((resolve) => setTimeout(resolve, 2000));
  job = await fetch(`${BASE}/v1/jobs/${job.job_id}`, { headers }).then(readResponse);
}
console.log(job.outputs.map((output) => output.url));
```

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:

```json
{
  "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",
  "reserved_usd": "0.24",
  "charged_usd": "0.24",
  "created_at": "2026-09-25T12:00:00Z",
  "completed_at": "2026-09-25T12:00:14Z"
}
```

Bu akışın Python, JavaScript ve curl ile çalıştırılabilir hâli, model ve kullanım örnekleriyle birlikte [GitHub'daki raywake-examples](https://github.com/oguzhankayan/raywake-examples) reposunda. Scriptler `--generate` vermediğin sürece yalnızca ücretsiz teklif alır.

[Kimlik doğrulama](https://raywake.si/tr/docs/authentication)

## İlgili

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