OpenAI uyumlu API

Nedir

OpenAI uyumlu API, OpenAI'ın chat completions biçimini konuşan bir aracın ToRun'un sohbet modellerini kullanmasını sağlar; ücreti ToRun hesabınızdan ödenir. opencode gibi bir kodlama ajanı, ToRun'un MCP araçlarının yanında ToRun'u model sağlayıcısı olarak da kullanabilir.

Adres ve oturum açma

MCP sunucusu için kullandığınız geliştirici anahtarını kullanın: bkz. Geliştirici anahtarları. OpenAI uyumlu API eklenmeden önce oluşturulan bir anahtar 403 insufficient_scope yanıtını alır. Bir anahtarın izinleri hiçbir zaman değişmez, bu yüzden yeni bir anahtar oluşturun.

API'nin iki uç noktası vardır: GET /v1/models ve POST /v1/chat/completions. /v1 altındaki diğer her yol 404 not_found yanıtını verir.

Modeller

GET /v1/models önce torun/auto modelini, ardından planınızın kullanabildiği her metin modelini model kimliğiyle listeler. Her model şunları belirtir:

• ne kadar metin okuyabildiğini (context_length) ve ne uzunlukta bir yanıt yazabildiğini (max_completion_tokens),
• araç çağırıp çağıramadığını (supports_tools) ve görsel okuyup okuyamadığını (supports_vision),
• milyon token başına Runs cinsinden fiyatını (pricing: input ve output).

torun/auto, ToRun'un her istek için bir model seçmesini sağlar: istekte görsel varsa görsel okuyabilen, tools gönderiyorsa araç çağırabilen bir model.

Chat completions

POST /v1/chat/completions şunları kabul eder:

• system, developer (system olarak işlenir), user, assistant ve tool rolleriyle messages,
• tools ve tool_choice (auto, none, required ya da adı verilen tek bir fonksiyon): aracınızın kendi araçları ona araç çağrısı olarak geri döner ve ToRun onları hiçbir zaman çalıştırmaz,
• json_object ile response_format. json_schema kabul edilir ve JSON olarak yanıtlanır, ancak şemanın kendisi zorunlu tutulmaz,
• temperature (0 ile 2 arası), top_p (0 ile 1 arası), max_completion_tokens veya max_tokens, stop (en fazla 4 dizi), seed ve reasoning_effort,
• stream ve stream_options.include_usage.

1'den büyük n, logprobs, top_logprobs, ses ve metin dışındaki her çıktı yok sayılmak yerine 400 unsupported_parameter ile reddedilir.

Görseller

Bir görseli satır içi olarak, bir image_url parçasında data:image/...;base64,... biçiminde, istek başına en fazla 20 MB olarak gönderin. Bağlantı olarak gönderilen bir görsel 400 image_url_not_supported ile reddedilir: ToRun onu indirmez. Görseller, uygulamada olduğu gibi güvenlik denetiminden geçirilir.

Akış

"stream": true ile yanıt, chat.completion.chunk biçiminde sunucu tarafından gönderilen olaylar olarak gelir:

• İlk parça assistant rolünü taşır ve araç çağrıları index değerleriyle akar.
• Gönderilecek bir şey yokken her 15 saniyede bir : keepalive yorum satırı gelir; SSE ayrıştırıcıları bunu atlar.
• data: [DONE] başarılı bir akışı sonlandırır.
• stream_options.include_usage ile son parçanın choices alanı boştur ve usage taşır.
• Akış başladıktan sonraki bir hata tek bir data: {"error": ...} olayı olarak gelir ve [DONE] gelmez.

Akış kullanılmayan bir çağrı 110 saniye sonra 504 timeout ile durdurulur. Uzun istekleri "stream": true ile gönderin.

Kullanım

usage; prompt_tokens, completion_tokens, total_tokens, prompt_tokens_details.cached_tokens ve completion_tokens_details.reasoning_tokens alanlarını, ayrıca çağrının Runs cinsinden maliyeti olan torun_credits alanını taşır.

opencode'da kullanın

Geliştiriciler sayfasındaki opencode yapılandırması, ToRun'u MCP sunucusunun yanında model sağlayıcısı olarak ekler:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "torun": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ToRun",
      "options": { "baseURL": "https://mcp.torun.ai/v1", "apiKey": "{env:TORUN_API_KEY}" },
      "models": { "torun/auto": { "name": "ToRun Auto" } }
    }
  }
}

OpenAI sohbet API'sini konuşan diğer her araç da aynı şekilde çalışır. Sayfanın OpenAI API sekmesi şu çağrıyı gösterir:

curl https://mcp.torun.ai/v1/chat/completions \
  -H "Authorization: Bearer $TORUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "torun/auto", "messages": [{"role": "user", "content": "Hello"}]}'

Çağrılar nasıl ödenir

API çağrıları, uygulamadaki aynı kullanımla aynı miktarda Runs tutar. Bunları yalnızca ücretli kaynaklar öder: önce ücretli planınızın payı, anahtarda buna izin verdiyseniz ardından cüzdanınız. Ücretsiz pay API çağrılarını hiçbir zaman ödemez. Anahtarın aylık ve günlük sınırları geçerlidir ve yanıtlar sohbet yanıtları gibi güvenlik denetiminden geçirilir.

Sınırlar

Her anahtar bu API'ye dakikada 60 istek gönderebilir ve aynı anda 4 tamamlama çalıştırabilir. Bunun üstünde API, Retry-After başlığıyla 429 rate_limit_exceeded yanıtını verir.

Hatalar

Her hata {"error": {"message": ..., "type": ..., "param": ..., "code": ...}} biçimindedir. message, isteğin Accept-Language başlığının istediği dildedir.

Ödenemeyen bir istek 429 değil 402 yanıtını verir, böylece bir istemci onu yeniden denemeye devam etmez.