MODERN SARAYTHE PALACE OF ARTIFICIAL INTELLIGENCE
MODERN SARAY / DOCUMENTATION

Fikrinden
ilk bağlantına.

İster çalışma alanında üret, ister API ile geliştir. Başlamak için gereken adımlar, örnekler ve sınırlar burada.

İnsanlar içinMachine APIHata davranışıAjan keşfi ↗

Çalışma alanına giriş.

Sohbet, Verse, AI Network, otomasyonlar, domainler, sağlayıcı ayarları ve geliştirici paneli kişisel hesaba bağlıdır. Giriş yapmadan bu paneller gösterilmez. Geliştirici panelinden API anahtarlarını, kullanımını ve API cüzdanını yönetebilirsin.

Hesap oluştur ↗Geliştirici paneline giriş ↗

API bağlantısını kur.

Mevcut doğrulanmış taban adres: https://modernsaray.com/api. Yeni marka teknik sözleşmeleri bozmaz: eski anahtar biçimleri, model kimlikleri ve endpoint yolları uyumluluk için korunur.

  1. İnsan operatör geliştirici panelinde bir API anahtarı oluşturur.
  2. Anahtar yalnızca uygulamanın sunucu ortamında saklanır.
  3. GET /v1/external/me ile API hesabına erişim kontrol edilir.
  4. GET /v1/models ile uygun model kimliği öğrenilir.
  5. Sohbet çağrısından önce API cüzdanı ve kullanım limitleri kontrol edilir.
curl https://modernsaray.com/api/v1/models \
  -H "Authorization: Bearer $MODERN_SARAY_API_KEY"

curl https://modernsaray.com/api/v1/chat/completions \
  -H "Authorization: Bearer $MODERN_SARAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-operation-id" \
  -d '{"model":"MODEL_ID_FROM_MODELS","messages":[{"role":"user","content":"Merhaba"}],"stream":false}'

Örnekteki model kimliğini model listesinden seç. Tek bir mantıksal sohbet tamamlama işlemini yeniden gönderirken aynı idempotency anahtarını kullan; yeni işlemde yeni anahtar üret. Her endpoint aynı tekrar güvenliğini sağlamaz.

Harici API anahtarları tarayıcıdan kullanılmamalıdır. Mevcut API, Origin başlığı taşıyan anahtarlı çağrıları reddeder. Tarayıcı → kendi backend’in → Modern Saray API akışını kullan.

İstek ve yanıt sözleşmesi.

OpenAPI belgesi yalnızca yayımlanan makine yeteneklerini kapsar; yönetim ve kişisel hesap endpointlerini keşif kataloğuna dahil etmez. API anahtarı gerekliliği şemada belirtilmiştir.

stream: true sohbet tamamlamasında SSE biçiminde yanıt ister. İstemci data: olaylarını ve kapanış işaretini işleyebilmelidir. Model sağlayıcısının üretim şekli değişebilir; ilk parçanın gecikmesi sağlayıcıya bağlıdır.

Hataları açıkça ele al.

401 / 403

Eksik, geçersiz veya süresi bitmiş anahtar; kapsam, IP veya tarayıcı-origin kısıtı. Sınırsız tekrar denemek yerine erişim ayarlarını kontrol et.

402 / 429

Yetersiz API bakiyesi veya istek limiti. 429 durumunda kontrollü geri çekilme uygula; varsa Retry-After başlığını izle. 402 için insan operatörün bakiye işlemi gerekir.

409 / 422

Hesap/işlem çakışması veya geçersiz istek alanları. Hata gövdesini incele ve isteği düzelt; aynı hatalı isteği körlemesine tekrarlama.

5xx / bağlantı kesilmesi

Geçici servis ya da sağlayıcı hatası olabilir. Yeniden denemeden önce işlemin tekrar güvenliğini değerlendir; her endpointte idempotency desteği olduğunu varsayma.

Keşif ve güvenlik.

Standart API kataloğu: /.well-known/api-catalog. Ek okunabilir özet: llms.txt. llms.txt bir yardımcı keşif önerisidir; erişim kontrolü veya tüm AI sistemlerinin desteklediği bir standart değildir.

API anahtarı bir hesap erişim aracıdır. Ajanın kimliğine, yetki devrine ya da güvenilirliğine ilişkin ayrı bir sertifika değildir. Gelecek kimlik altyapısının kapsamı ajanlar bölümünde açıkça belirtilir.