OpenAI uyumlu bir API mevcut bir araca nasıl bağlanır?

Kısaca: Araca üç değer yazarsın: taban adres (base URL), API anahtarı ve model adı. Wiozen API için adres https://api.wiozen.com/v1, anahtar panelden aldığın sk-gw-… anahtarı, model adı da Modeller sayfasındaki adlardan biri, örneğin wiozen-anthropic. Araç OpenAI SDK'sını ya da "OpenAI Compatible" seçeneğini kullanıyorsa kodunda başka bir şeyi değiştirmen gerekmez.

OpenAI uyumlu ne demek?

OpenAI'nin API'si sohbet istekleri için /v1/chat/completions yolunu, messages dizisi taşıyan bir istek gövdesini ve choices alanlı bir yanıtı kullanır. Bu biçim zamanla ortak dil oldu: kod editörü eklentileri, terminal ajanları, sohbet arayüzleri ve SDK'lar çoğunlukla bu biçimi konuşur. Bir hizmet "OpenAI uyumlu" diyorsa aynı yolları ve aynı gövdeyi kabul eder. Senin tarafında değişen yalnızca adres, anahtar ve model adı olur.

Wiozen API'de OpenAI biçimi için /v1/chat/completions, /v1/responses ve /v1/models uçları var. Aynı anahtar Anthropic biçimini de (/v1/messages) kabul eder. Akış (stream) ve araç çağrısı (tools) iki biçimde de çalışır.

Bağlantı için gereken üç değer

Adresin sonundaki /v1'i atlama. Araçların çoğu bu adresin arkasına /chat/completions ekleyerek isteği kurar. Anthropic biçimini kullanan araçlar ise adresi /v1 olmadan, https://api.wiozen.com olarak ister; Claude Code bunlardan biri.

Anahtarı API panelindeki Anahtarlar sayfasından oluşturursun. Her araca ayrı anahtar açarsan hangi aracın ne harcadığını ayrı görürsün ve gerekirse tek bir anahtarı kapatırsın.

Önce curl ile dene

Bir araca girmeden önce adresle anahtarı terminalde denemek hatanın nerede olduğunu bulmayı kolaylaştırır. Anahtarını API_KEY ortam değişkenine koy ve şunu çalıştır:

curl https://api.wiozen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "wiozen-anthropic", "messages": [{"role": "user", "content": "Merhaba"}]}'

Yanıtta choices[0].message.content doluysa adres, anahtar ve model adı doğru. Kullanabileceğin model adlarını görmek için:

curl https://api.wiozen.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Python'da OpenAI SDK ile

Resmi openai paketini pip install openai ile kur. İstemciyi oluştururken base_url ve api_key vermen yeterli; geri kalan kod OpenAI'ye bağlanırken yazdığın kodla aynı.

from openai import OpenAI

client = OpenAI(base_url="https://api.wiozen.com/v1", api_key="sk-gw-...")

response = client.chat.completions.create(
    model="wiozen-anthropic",
    messages=[{"role": "user", "content": "Merhaba!"}],
    max_tokens=16000,
)
print(response.choices[0].message.content)

max_tokens değerini küçük tutma. Modeller zor sorularda önce düşünür ve bu düşünme aynı bütçeden düşer; bütçe yetmezse yanıt boş kapanabilir. API dokümanı 16.000 ve üzerini öneriyor.

JavaScript ve Node.js'te

npm install openai ile paketi kur. Burada alan adları baseURL ve apiKey.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.wiozen.com/v1", apiKey: "sk-gw-..." });

const res = await client.chat.completions.create({
  model: "wiozen-anthropic",
  messages: [{ role: "user", content: "Merhaba!" }],
  max_tokens: 16000,
});
console.log(res.choices[0].message.content);

Akış istiyorsan isteğe stream: true ekle; yanıt Server-Sent Events olarak parça parça gelir ve SDK bunu senin için okur.

Hazır bir araca bağlamak: Hermes Agent örneği

Kod yazmıyorsan da aynı üç değer geçerli; yalnızca nereye yazıldıkları araçtan araca değişir. Hermes Agent, Wiozen API'nin OpenAI uyumlu ucuyla çalışıyor. Bağlamak için:

1. Sohbet oturumunun dışında, terminalde hermes model komutunu çalıştır.
2. Listeden Custom endpoint (self-hosted / VLLM / etc.) seçeneğini seç.
3. Adres olarak https://api.wiozen.com/v1, anahtar olarak Wiozen anahtarını, model olarak Modeller sayfasındaki bir adı gir.

Hermes bu ayarı ~/.hermes/config.yaml dosyasına yazar. Dosyayı elle düzenlemek istersen blok şöyle görünür:

model:
  default: deepseek-v4.1-flash
  provider: custom
  base_url: https://api.wiozen.com/v1
  api_key: sk-gw-...

Başka araçlarda da adımlar benzer. Cline, Roo Code ve Kilo Code'da sağlayıcı olarak "OpenAI Compatible" seçip aynı üç değeri girersin; Cursor, Continue, OpenCode, Aider, Qwen Code, Open WebUI ve LibreChat için ayarın nereye yazıldığı kurulum rehberlerinde araç araç anlatılıyor. Hermes'in ayrıntılı sayfası burada.

Sık görülen hatalar

Araç model listesini boş gösteriyorsa çoğu zaman adres yanlış yazılmıştır: /v1 eksiktir ya da sonda fazladan bir yol vardır. Adresi yukarıdaki biçimde yazıp aracın model listesini yenile.

Sık sorulan sorular

Henüz anahtarın yoksa hesabını aç. E-postanı doğruladığında $0,15 deneme bakiyesi tanımlanır; bu yazıdaki curl komutunu kendi anahtarınla hemen deneyebilirsin.

Hesabını aç

Diğer rehberler: Türkiye'den kredi kartı olmadan yapay zekâ API'si nasıl kullanılır? · Yapay zekâ API maliyeti nasıl hesaplanır? · WordPress'te yapay zekâyla otomatik makale nasıl yazdırılır? · Blog için RSS ve Google Trends'ten konu nasıl bulunur? · Yapay zekâyla yazılan içerik Google'da ve yapay zekâ yanıtlarında görünür mü?