Uygulamayı aç
Moonborn — Developers

OpenAI-uyumlu

Doğrudan takılabilir uyumlu bir chat/completions endpoint'i — base URL'i değiştir, API anahtarını takas et, model alanını bir persona ID yap. Streaming, tool calling ve function calling değişmeden geçer.

Doğrudan takılabilir uyumluluk

Halihazırda OpenAI SDK kullanıyorsan (ya da OpenAI şeklini konuşan bir wrapper), Moonborn yalnızca bir base-URL takasından ibaret. https://api.moonborn.co/v1/openai adresindeki endpoint OpenAI şeklindeki istekleri kabul eder ve OpenAI şeklindeki yanıtları döner — model alanı gpt-4 yerine bir persona ID taşır.

import OpenAI from 'openai';
 
const client = new OpenAI({
 apiKey: process.env.MOONBORN_API_KEY,
 baseURL: 'https://api.moonborn.co/v1/openai',
});
 
const response = await client.chat.completions.create({
 model: 'persona://persona_mert_abc123',
 messages: [{ role: 'user', content: 'What drives you?' }],
});

OpenAI Python SDK ile Python'da aynı çağrı şekli, curl ile de aynı çağrı şekli. Yeni bir client kütüphanesine gerek yok.

Desteklenenler

  • POST /v1/openai/chat/completions — streaming ve non-streaming.
  • GET /v1/openai/models — workspace personalarını model olarak listeler.
  • Tool calling ve function calling — persona-kapsamlı chat runtime'a geçer.

Bilinmesi gereken farklar

Şekil OpenAI-uyumlu; davranış Moonborn:

  • model, generic bir model değil, bir persona referansıdır (persona://<id>).
  • Yanıt metadata'sı — drift skoru, katman atfı, audit ID — x-moonborn-* yanıt header'larında gelir. OpenAI client'ları tarafından güvenle yok sayılır; istersen parse edebilirsin.
  • Rate-limit ve token-sayım header'ları OpenAI konvansiyonlarına uyar, ama alttaki limitler Moonborn workspace katmanından gelir (tiers sayfasına bak).
  • Personanın drift-detection kuralları geçerliliğini korur. Bir yanıt workspace eşiğini aşarsa, yanıt x-moonborn-drift-alert: true taşır ve (yapılandırılmışsa) gönderilmeden önce fallback toparlanmadan geçer.

Geçiş kontrol listesi

  1. OPENAI_API_KEY'i MOONBORN_API_KEY ile değiştir.
  2. Base URL'i https://api.moonborn.co/v1/openai yap.
  3. Model ID'lerini persona ID'leri ile değiştir (persona://<id>).
  4. sk_test_* anahtarlarıyla sandbox bir workspace'te test et.
  5. Production'a geç.

Uyumlu olmayanlar

  • Görsel üretimi.
  • Embedding'ler.
  • Ses (TTS / STT).

Bunlar Moonborn'un alanı değil. Bu endpoint'ler için OpenAI client'ını yan yana tut; persona-bağlı chat katmanı için Moonborn kullan.

Tier

Free ve üzeri. Endpoint, workspace planının sunduğu rate limit'i devralır — tiers sayfasına bak.

Sonraki