Geliştirici dokümantasyonu

Araç bazlı kurulum

Nasıl kullanmak istiyorsunuz?

Kullandığınız aracı ve işletim sistemini seçin. Üretimde kanonik endpoint https://api.yapayzekaniz.com/v1, root-domain alias'ı https://yapayzekaniz.com/v1 olarak aynı gateway'e gider.

export OPENAI_BASE_URL="https://api.yapayzekaniz.com/v1"
export OPENAI_API_KEY="dev-package"$env:OPENAI_BASE_URL = "https://api.yapayzekaniz.com/v1"
$env:OPENAI_API_KEY = "dev-package"

# OpenAI uyumlu SDK'nızda base_url değerini kullanın.# Codex'i API key modu ve özel base URL ile başlatın.# Kimi/OpenAI uyumlu istemcide aynı iki değişkeni kullanın.# Claude Messages uyumluluğu henüz aktif değildir; OpenAI uyumlu istemci kullanın.

01 · Hızlı başlangıç

İlk API isteğinizi gönderin

Panelden bir anahtar oluşturun, ardından base URL ve anahtarınızı kullanarak chat completions ucuna istek gönderin.

curl https://api.yapayzekaniz.com/v1/chat/completions \
  -H "Authorization: Bearer wl_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gateway-default",
    "messages": [
      {"role": "user", "content": "Merhaba!"}
    ]
  }'

02 · Kimlik doğrulama

Bearer anahtarı kullanın

Tüm API çağrılarında anahtarınızı Authorization başlığında gönderin. Anahtar yalnızca oluşturulduğu anda tam gösterilir.

Modelleri listeleyin

Anahtarınızın erişebildiği güncel model kataloğunu döndürür. Yetkili olmayan modeller bu listede görünmez.

{
  "object": "list",
  "data": [
    { "id": "gateway-default", "object": "model" }
  ]
}

Chat completion oluşturun

Mesaj geçmişini ve model kimliğini göndererek yeni bir yanıt üretin.

Görsel üretimi

Görsel yeteneği bulunan bir modelle tek görsel üretin. prompt ve model zorunludur; desteklenen boyutlar 512x512, 1024x1024, 1024x1536 ve 1536x1024'tür.

curl https://api.yapayzekaniz.com/v1/images/generations \
  -H "Authorization: Bearer wl_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-generator",
    "prompt": "Minimal bir ürün illüstrasyonu",
    "size": "1024x1024"
  }'

Streaming

Yanıtları gerçek zamanlı akıtın

stream: true gönderildiğinde sunucu, içerik parçalarını Server-Sent Events üzerinden iletir. Akış [DONE] ile tamamlanır.

curl ... -d '{ "stream": true }'

const stream = await client.chat.completions.create({
  model: 'gateway-default', messages, stream: true
});

stream = client.chat.completions.create(
    model="gateway-default", messages=messages, stream=True
)

Bakiye ve kullanım

Anahtar moduna göre kalan paket hakkını veya PAYG cüzdan bakiyesini sorgulayın.

Panel uçları

Panel içi AI sohbeti ve görsel stüdyosu

/api/panel/ai/* uçları, giriş yapmış müşteri/bayi oturumuyla çalışır. Tarayıcı isteğinde Laravel oturum çerezini ve CSRF başlığını gönderin. Bu uçlar sizin adınıza etkin bir API anahtarı seçerek aynı paket ve kota kurallarını uygular.

Hata sözlüğü

Öngörülebilir hata yanıtları

Tüm hatalar aynı gövde biçimini kullanır. Her yanıtta destek ekibinin izleyebileceği bir X-Request-Id başlığı bulunur.

{
  "error": {
    "message": "Sağlayıcınızla iletişime geçin.",
    "type": "provider_unavailable",
    "code": "provider_unavailable"
  }
}

Paket ve rate limitleri

API anahtarı kalıcıdır; bir paketin süresi dolduğunda silinmez. Aynı anahtar, hesabınıza yeni paket tanımlandığında yeni paketin model kapsamı ve limitleriyle yeniden çalışır. Paket yokken veya kota doluyken çağrı 402 ile durdurulur.

Bayi rehberi

White-label alan adı kurulumu

Bayi panelinden bir alt alan adı ekleyin, gösterilen sunucu IP'sine A kaydı oluşturun ve doğrulamayı başlatın.

1. 1

   Alan adını ekleyin

   Örn. api.sizin-alaniniz.com. Küçük harfli bir alt alan adı önerilir.

2. 2

   DNS A kaydını oluşturun

   Panelde gösterilen IP adresini kullanın ve TTL değerini kısa tutun.

3. 3

   AAAA kaydını kaldırın

   IPv6 kaydı doğrulamayı engelleyebilir; varsa kaldırın.

4. 4

   Doğrulayın ve kullanın

   DNS kontrolü tamamlandığında alan adı aktif olur.