REST API · v1

Geliştirici dokümantasyonu

Yapay zekâ modellerini ürününüze tek bir OpenAI-uyumlu arayüzle bağlayın. Bu rehber ilk çağrıdan streaming yanıtlarına kadar gereken her şeyi içerir.

Üretim endpointi: https://api.yapayzekaniz.com/v1Sürüm: v1

Uyumlu arayüz

Mevcut SDK'larla kolay entegrasyon.

SSE streaming

Yanıtları beklemeden akıtın.

Güvenli anahtarlar

Kapsam ve iptal kontrolü.

OpenAPI şeması

openapi.yaml, bu API’nin makine tarafından okunabilen sözleşmesidir.

Swagger, Redoc veya Postman ile endpointleri, parametreleri ve hata yanıtlarını içe aktarabilirsiniz.

YAML indir

Araç bazlı kurulum

Nasıl kullanmak istiyorsunuz?

Kullandığınız aracı ve işletim sistemini seçin. macOS ve Linux kabuk komutları aynı POSIX akışını kullanır; Windows PowerShell için ayrı komut gösterilir. Üretimde tüm istemciler için endpoint https://api.yapayzekaniz.com/v1 adresidir.

“OpenAI uyumlu” ve “Yapay Zekanız API” ayrı servisler değildir; ikisi de aynı https://api.yapayzekaniz.com/v1 endpointini, farklı kurulum anlatımıyla gösterir.

Codex CLICodex masaüstüKullanıcı anahtarıyla doğrulama

Sistem

export OPENAI_BASE_URL="https://api.yapayzekaniz.com/v1"
export OPENAI_API_KEY="your_api_key"$env:OPENAI_BASE_URL = "https://api.yapayzekaniz.com/v1"
$env:OPENAI_API_KEY = "your_api_key"

# OpenAI uyumlu SDK'nızda base_url değerini kullanın.# Yapay Zekanız API anahtarınızı ve üretim endpointinizi kullanın.# Bu araçta OpenAI uyumlu base URL ve panelinizden oluşturduğunuz panel anahtarını kullanın.

1
Anahtar üretin
Panelde yalnızca bir kez tam gösterilir.
2
Değişkenleri yazın
Endpoint ve anahtarı aracınıza tanıtın.
3
Bağlantıyı sınayın
/models çağrısında HTTP 200 bekleyin.

Hazır kurulum dosyaları

Dosyalar anahtarı içine gömmez; kurulum sırasında sizden panel anahtarınız anahtarınızı ister ve /models ile doğrular.

macOS Linux Windows PowerShell AI talimatı Kaldırma · macOS/Linux Kaldırma · Windows

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 your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-flash",
    "messages": [
      {"role": "user", "content": "Merhaba!"}
    ]
  }'

Üretim base URL adresi https://api.yapayzekaniz.com/v1 şeklindedir. İstemcinizde bu adresi doğrudan kullanın.

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.

AuthorizationBearer your_api_key

Yapın

Anahtarı sunucu ortam değişkeninde saklayın ve düzenli olarak yenileyin.

Yapmayın

Anahtarı tarayıcı koduna, mobil uygulamaya veya herkese açık depoya eklemeyin.

GET/v1/models

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.

200 · application/json

{
  "object": "list",
  "data": [
    { "id": "gemini-3-flash", "object": "model" }
  ]
}

POST/v1/chat/completions

Chat completion oluşturun

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

AlanTipAçıklama

modelstringZorunlu. Kullanılacak model kimliği.

messagesarrayZorunlu. Konuşma mesajları.

temperaturenumberİsteğe bağlı. Üretim çeşitliliği, 0–2.

streambooleanİsteğe bağlı. SSE akışını etkinleştirir.

POST/v1/images/generations

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 · 200 application/json

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

model

Görsel modeli kimliği.

prompt

3–4.000 karakterlik üretim açıklaması.

size

Boyut; varsayılan 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: 'gemini-3-flash', messages, stream: true
});

stream = client.chat.completions.create(
    model="gemini-3-flash", messages=messages, stream=True
)

Bakiye ve kullanım

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

GET/v1/balance

Bakiye, para birimi ve PAYG durumunu döndürür.

GET/v1/usage

Dönemsel token, maliyet ve model kullanımını verir.

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.

POST/api/panel/ai/chat

messages, model ve isteğe bağlı temperature/max_tokens.

POST/api/panel/ai/image

prompt, görsel model, size ve isteğe bağlı api_key_id.

Oturumda etkin paket veya anahtar yoksa panel uçları 422 döndürür. Paket kotası, günlük limit veya PAYG bakiyesi tükendiğinde 402 gelir ve kullanım satırı yazılmaz.

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": "Yapay Zekanız destek ekibiyle iletişime geçin.",
    "type": "provider_unavailable",
    "code": "provider_unavailable"
  }
}

HTTPKodAnlam

401invalid_api_keyAnahtar eksik, geçersiz veya iptal edilmiş.

402package_requiredEtkin paket veya PAYG bakiyesi yok; kullanım yazılmaz.

402package_expiredAnahtar korunur ancak bağlı paketin süresi dolmuştur.

402package_quota_exceededPaketin toplam istek hakkı doldu; kullanım yazılmaz.

402daily_quota_exceededStandart paketin günlük istek hakkı doldu.

402carryover_quota_exceededDevreden paketin birikmiş hakkı o gün için doldu.

402insufficient_balancePAYG bakiyesi tahmini veya kesin ücret için yetersiz.

402payg_pricing_unavailableModelin PAYG fiyatı yapılandırılmamış.

403model_not_in_packageSeçilen model aktif paketin kapsamında değil.

429too_many_requestsAPI veya panel hız sınırı aşıldı.

503provider_unavailableModel servisine geçici olarak erişilemiyor.

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; anahtar ayarlarında PAYG geçişine izin verdiyseniz cüzdan bakiyesinden devam eder.

Günlük limit

Takvim günü içindeki izin verilen istek sayısı; dolduğunda günlük sıfırlanmayı bekler.

Toplam limit

Paket ömrü boyunca kullanılabilecek toplam istek; devreden pakette günlük kalan hak korunur.

PAYG

Hesabınızda kullanılabilir olduğunda paket dışı kullanım bakiyenizden ücretlenir; kullanılabilir değilse aktif paket gerekir.

402 işlemsellik garantisi

Aktif paket bulunamazsa, toplam/günlük hak tükenirse veya PAYG bakiyesi yetersizse model servisine çağrı yapılmaz; bakiye düşülmez ve kullanım kaydı oluşturulmaz.

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
Alan adını ekleyin
Örn. api.sizin-alaniniz.com. Küçük harfli bir alt alan adı önerilir.
2
DNS A kaydını oluşturun
Panelde gösterilen IP adresini kullanın ve TTL değerini kısa tutun.
3
AAAA kaydını kaldırın
IPv6 kaydı doğrulamayı engelleyebilir; varsa kaldırın.
4
Doğrulayın ve kullanın
DNS kontrolü tamamlandığında alan adı aktif olur.