Zurelay Auto

Her isteği ona uygun modelle yanıtlayan tek bir model adı: zurelay-auto. Yanıtı veren modelin ücretini ödersiniz; hangi model olduğu yanıtta belirtilir. Model kimliği kullanılan her yerde, aynı akış, araç ve akıl yürütme düzeyleriyle çalışır.

import os
from openai import OpenAI
client = OpenAI(
    base_url="https://api.zurelay.com/v1",
    api_key=os.environ["ZURELAY_API_KEY"],
)
response = client.chat.completions.create(
    model="zurelay-auto",
    messages=[
      {
        "role": "user",
        "content": "Summarize this in one sentence: Zurelay is one API for many models."
      }
    ],
)
print(response.choices[0].message.content)

Nasıl seçer

Auto, isteğin içeriğine bakarak kendi adına bir model çağrısı yapmadan seçim yapar; böylece ek gecikme veya maliyet oluşturmaz. Her istek üç kademeden birine yerleştirilir:

Kendi kademesinde, istekle gönderilen tüm görselleri, PDF'leri, ses kliplerini veya videoları okuyabilen, bağlam penceresine istem ve max_tokens sığan ve bir akıl yürütme düzeyi belirttiğinizde bunu destekleyen ilk modeli seçer. reasoning_effort ayarınız, modelin desteklediği en yakın düzeyde uygulanır.

Seçim yaptığı modeller

Her kademedeki modeller, Auto'nun deneme sırasıyla ve 1M girdi ve çıktı token'ı başına fiyatlarıyla listelenir. Daha iyi veya daha ucuz modeller geldikçe liste değişir; kodunuzun değişmesi gerekmez.

Ne ödersiniz

Her istek, yanıtı veren modelin Zurelay fiyatları üzerinden ücretlendirilir; model seçimi için ek ücret alınmaz: bugün 1M girdi token'ı başına $0.025 ile $3.50, 1M çıktı token'ı başına $0.12 ile $17.50 arasında. Diğer tüm modellerde olduğu gibi başarısız istekler ücretsizdir (bkz. Faturalandırma).

Hangi model yanıtladı

Yanıtın model alanı ve x-zurelay-model başlığı, yanıtı veren modeli belirtir; x-zurelay-routed-from: zurelay-auto ise modeli Auto'nun seçtiğini gösterir. Paneldeki İstekler bölümünde de aynı bilgiler yer alır.

HTTP/1.1 200 OK
x-zurelay-model: deepseek-v4.1-flash
x-zurelay-routed-from: zurelay-auto
{
  "model": "deepseek-v4.1-flash",
  "choices": [{ "message": { "role": "assistant", "content": "…" } }],
  …
}

Bir model yanıt veremediğinde

Auto, yanıt alabilmeniz için tasarlanmıştır:

1. Seçtiği model, Zurelay'deki tüm modeller gibi hatalarda otomatik olarak yeniden denenir, ardından o modelin yedek rotaları kullanılır.
2. Hâlâ yanıt alınamazsa Auto önce isteğin kademesindeki diğer modelleri, ardından bir üst, sonra bir alt kademeyi dener; toplamda en fazla beş model denenir.
3. Yalnızca hepsi başarısız olursa model_unavailable içeren bir 503 ve retry-after başlığı alırsınız.

Bu davranış akıllı yönlendirme ayarınızdan bağımsızdır: Auto bunu her zaman yapar; x-zurelay-fallback başlığı ve isteğin models listesi bunu değiştirmez.

Anthropic biçimi

POST /v1/messages, zurelay-auto isteklerini de kabul eder. Bu durumda Auto, Anthropic biçimini destekleyen Claude modelleri arasından seçim yapar; böylece Anthropic SDK'ları ve bunlarla geliştirilen araçlar, diğer Claude modellerinde olduğu gibi çalışır.

API anahtarları

Yalnızca zurelay-auto ile sınırlandırılmış bir anahtar (bkz. anahtar kuralları), Auto'nun seçtiği herhangi bir modeli kullanabilir. Harcama ve istek hızı sınırları her zamanki gibi geçerlidir. Kısa kimlik auto de çalışır.

Hatalar

• 400 unsupported_content: modellerinin hiçbiri, istekte birlikte gönderilen medyaların tümünü okuyamıyor; örneğin aynı istekte ses ve PDF. Bunları ayrı ayrı gönderin veya ikisini de okuyabilen bir model seçin.
• 400 context_length_exceeded: istek, modellerinin okuyabileceğinden uzun. Daha kısa bir istek gönderin veya daha az çıktı isteyin.
• 503 model_unavailable: denediği tüm modeller başarısız oldu. retry-after başlığında belirtilen süre geçtikten sonra yeniden deneyin.