Hızlı Başlangıç

Onysoft AI Gateway ile başlayın

Onysoft AI Gateway, yüzlerce AI modeline tek bir API üzerinden erişmenizi sağlayan birleşik bir platformdur. OpenAI SDK'larıyla uyumlu API'miz sayesinde mevcut uygulamalarınızı birkaç satır değişiklikle Onysoft altyapısına geçirebilirsiniz.

1. API Anahtarı Oluşturun

İlk olarak, ücretsiz hesap oluşturun ve Dashboard üzerinden bir API anahtarı oluşturun.

2. İlk API Çağrınızı Yapın

Aşağıdaki örnekler, tercih ettiğiniz programlama dili ile nasıl başlayacağınızı gösterir. Onysoft API, OpenAI SDK'larıyla uyumludur: base_url değerini ve API anahtarını değiştirmeniz yeterlidir.

from openai import OpenAI

client = OpenAI(
    api_key="sk-ony-your-api-key",
    base_url="https://api.onysoft.com/v1"
)

response = client.chat.completions.create(
    model="google/gemini-3.8-flash",
    messages=[
        {"role": "user", "content": "Merhaba, nasılsın?"}
    ]
)

print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: 'sk-ony-your-api-key',
    baseURL: 'https://api.onysoft.com/v1'
});

const response = await client.chat.completions.create({
    model: 'google/gemini-3.8-flash',
    messages: [
        { role: 'user', content: 'Merhaba, nasılsın?' }
    ]
});

console.log(response.choices[0].message.content);

$ch = curl_init('https://api.onysoft.com/v1/chat/completions');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk-ony-your-api-key',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'model' => 'google/gemini-3.8-flash',
        'messages' => [
            ['role' => 'user', 'content' => 'Merhaba, nasılsın?']
        ]
    ])
]);

$response = json_decode(curl_exec($ch), true);
echo $response['choices'][0]['message']['content'];

curl https://api.onysoft.com/v1/chat/completions \
  -H "Authorization: Bearer sk-ony-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.8-flash",
    "messages": [
      {"role": "user", "content": "Merhaba, nasılsın?"}
    ]
  }'

3. Yanıt Formatı

Başarılı bir istek sonucunda aşağıdaki formatta yanıt alırsınız:

{
  "id": "req_a1b2c3d4e5f6a1b2c3d4e5f6",
  "object": "chat.completion",
  "created": 1706000000,
  "model": "google/gemini-3.8-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Merhaba! Ben bir AI asistanıyım, size nasıl yardımcı olabilirim?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 24,
    "total_tokens": 36
  },
  "cost": {
    "amount": 0.000024,
    "currency": "USD"
  },
  "success": true,
  "data": { /* geriye uyum: yukarıdaki alanların aynısı (id, object, created, model, choices, usage, cost) */ }
}

Akışsız yanıtlarda OpenAI alanları (id, choices, usage …) üst seviyededir; resmî OpenAI SDK'ları ve LangChain gibi kütüphaneler response.choices[0].message.content ile doğrudan okur. Geriye uyum için yanıtta "success": true ve aynı içerik data altında da bulunur; data.choices okuyan mevcut entegrasyonlar değişmeden çalışır. Yeni entegrasyonlarda üst seviyedeki alanları kullanın. İsteğin ücreti cost.amount alanında (USD) yazar. Görsel ya da ses üreten akışsız yanıtlarda resmî SDK'lar dışındaki istemciler, yanıt boyutu iki katına çıkmasın diye yalnız "success": true + data biçimini alır.

Sonraki Adımlar

Artık API'yi kullanmaya hazırsınız! İşte öğrenmeye devam etmek için bazı kaynaklar: