Geliştirici Dokümantasyonu

Wiozen API — Hızlı Başlangıç & Referans

OpenAI, Anthropic ve OpenAI Responses biçimlerini tek bir yüksek hızlı ağ geçidi (api.wiozen.com) üzerinden destekler. Claude Code, Cursor, Python veya Node.js ortamlarında yalnızca adres ve anahtarınızı tanımlayarak kullanmaya başlayabilirsiniz.

⚡ Tarayıcıdan Canlı Test Edin

Kod yazmadan önce modellerin hızını ve yanıtlarını Web Playground üzerinde test edin.

Playground'u Aç →

API Taban Adresi

https://api.wiozen.com

Desteklenen Model

claude

Kimlik Doğrulama

Bearer sk-gw-...

Uç Noktalar (Endpoints)

Aşağıdaki tüm uç noktalar https://api.wiozen.com taban adresi altında çalışır.

Metot	Uç Nokta	Format	Açıklama
POST	/v1/messages	Anthropic	Claude Code, Cursor ve Anthropic SDK mesaj akışı
POST	/v1/messages/count_tokens	Anthropic	İstek token sayımı (Ücretsiz / Kotadan Düşmez)
POST	/v1/chat/completions	OpenAI	OpenAI SDK, Cursor ve OpenAI uyumlu araçlar
POST	/v1/responses	OpenAI Responses	Yeni nesil Codex ve OpenAI Responses API istemcileri
GET	/v1/models	OpenAI	Kullanılabilir nötr modelleri JSON olarak listeler

İstemci Kurulumu & Entegrasyon

Kullandığınız aracı veya programlama dilini seçerek hazır kodu kopyalayabilirsiniz:

Claude Code Kurulumu (Terminal) • Önerilen

# 1. Claude Code CLI yüklü değilse:
npm install -g @anthropic-ai/claude-code

# 2. Ortam değişkenlerini tanımlayıp başlatın:
export ANTHROPIC_BASE_URL="https://api.wiozen.com"
export ANTHROPIC_AUTH_TOKEN="sk-gw-..."   # panelden oluşturduğunuz anahtar
claude

Cursor Ayarları (Settings > Models)

// Cursor > Settings > Models > OpenAI API Key:
sk-gw-... (Panelden aldığınız API anahtarı)

// Override OpenAI Base URL kutusunu aktif edip girin:
Base URL: https://api.wiozen.com/v1
Model Adı: claude

python_example.py

# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://api.wiozen.com/v1",
    api_key="sk-gw-...",  # panelden aldığınız anahtar
)

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

index.mjs

// npm install openai
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: "claude",
  messages: [{ role: "user", content: "Merhaba!" }],
});
console.log(res.choices[0].message.content);

cURL (Anthropic Format /v1/messages)

curl https://api.wiozen.com/v1/messages \
  -H "x-api-key: $API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Merhaba!"}]
  }'

cURL (OpenAI Format /v1/chat/completions)

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

Örnek API Yanıtı

Standard JSON Yanıtı (200 OK):

response.json

{
  "id": "msg_01XyZ987654321",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Merhaba! Size nasıl yardımcı olabilirim?"
    }
  ],
  "model": "claude",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 14,
    "output_tokens": 11
  }
}

Akış (SSE Stream: "stream": true):

stream.sse

event: message_start
data: {"type":"message_start","message":{"id":"msg_01X...","role":"assistant"}}

event: content_block_delta
data: {"type":"content_block_delta","delta":{"type":"text_delta","text":"Merhaba"}}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":11}}

data: [DONE]

Parametre Rehberi

Parametre	Tip	Zorunlu	Açıklama
model	string	Evet	İstekte kullanılacak nötr model adı (ör. claude)
messages	array	Evet	İleti nesneleri dizisi: [{"role": "user", "content": "..."}]
max_tokens	integer	Hayır	Modelin üretebileceği maksimum token sayısı (varsayılan: 4096)
stream	boolean	Hayır	True verildiğinde yanıt Server-Sent Events (SSE) olarak milisaniyeler içinde akar
temperature	number	Hayır	0.0 ile 1.0 arasında yanıt çeşitliliği / yaratıcılık katsayısı

Kota & Harcama Kuralları

Her istek, kullandığı giriş + çıkış token'ı kadar kotanızdan düşer.
/v1/messages/count_tokens uç noktası tamamen ücretsizdir, kotadan düşmez.
Sunucu veya sağlayıcı hatası alan başarısız çağrılar kotanızdan düşmez.
Kalan bakiyenizi, toplam tüketiminizi ve harcama dökümünüzü Kullanım Analitiği sayfasından anlık izleyebilirsiniz.

Hata Kodları

Durum	Anlamı	Açıklama & Çözüm
401	Anahtar Eksik veya Geçersiz	Authorization başlığındaki sk-gw-... anahtarını kontrol edin.
403	Hesap Askıya Alındı	Hesap durumunuz için yönetici ile iletişime geçin.
400	Geçersiz İstek	Model adı veya JSON gövde formatını kontrol edin.
429	Kota Bitti / Limit	Token kotanız tükenmiştir; panelden bakiye durumunu kontrol edin.
502/504	Sağlayıcı Hatası	Model sağlayıcı yanıt veremedi; sistem otomatik yedek yönlendirme dener.