FOR AGENTS / MODERN SARAY

Ajanın için.
Yeni olasılıklar.

Yetenekleri keşfet. API’yi bağla. Fikrini çalıştır. Açık dokümantasyon ve anahtarla korunan erişim, aynı adreste.

API kataloğu ↗OpenAPI tanımı ↗Dokümantasyon ↗
MEVCUT API

Uygulamalar için bağlantı.

Model keşfi, sohbet tamamlama, API hesabı ve kullanım bilgisi. Erişim anahtarını insan operatör geliştirici panelinden yönetir; ajan kendi sunucu ortamından kullanır.

GET /v1/models
POST /v1/chat/completions
AÇIK KEŞİF

Makinece okunabilir.

RFC 9727 API kataloğu ve OpenAPI tanımı, desteklenen arayüzleri listeler. Katalog girişsiz okunabilir; API işlemleri kimlik doğrulaması gerektirir.

/.well-known/api-catalog
/machine/openapi.json
AGENT PASSPORT / KULLANIMA AÇIK

Kimlik sabit. Yetki senin elinde.

Geliştirici panelinde hesabına bağlı bir ajan oluştur. Süre, işlem kapsamı, istek ve yanıt sınırlarını belirle. Ajanın model sağlayıcısı değişse bile kimliği aynı kalır.

Ajanlarını yönet →
curl https://api.modernsaray.com/v1/agents/self/passport \
  -H "Authorization: Bearer $MODERN_SARAY_AGENT_KEY"

Bu yol passport:read yetkisiyle, yalnızca ilgili ajanın kimliğini ve delegasyonunu döndürür. Normal API anahtarları ve ajan anahtarları birbirinin yerine kullanılamaz.

Yeteneklerin kapsamını bil.

Model & sohbet

GET /v1/models erişilebilir modelleri listeler. POST /v1/chat/completions sohbet tamamlaması; POST /v1/external/chat basit mesaj entegrasyonu sağlar.

Erişim & kullanım

GET /v1/external/me API hesabını, GET /v1/external/usage kullanım ve cüzdan durumunu döndürür. Bunlar özel hesap bilgileridir; keşif kataloğunda yayımlanmaz.

Tek adres: https://api.modernsaray.com. Keşif herkese açık; hesap ve üretim işlemleri yalnızca yetkili API anahtarlarıyla çalışır.
İLK ÇALIŞAN TEMEL

Sınırlı erişim. İzlenebilir işlemler.

/v1/agents/self/capabilities verilen izinleri; /v1/agents/self/models erişilebilir modelleri gösterir. /v1/agents/self/chat/completions üzerinden yanıt üretmek için ayrı izin gerekir. Aynı istek ikinci kez ücretlendirilmez; mevcut API cüzdanı ve hız sınırları geçerlidir.

Erişimi iptal ettiğinde yeni istekler reddedilir. Kabul edilmiş işlemler tamamlanabilir. Agent Passport bu sürümde MODERN SARAY'a özgü, kayıtlı kimlik belgesidir; imzalı bir attestation değildir.

Kurum rolleri, zincirleme delegasyon, runtime attestation ve makine ekonomisi gelecek kapsamdır; bu sayfada çalışan servis olarak sunulmaz.