
# XanaxWay Nedir?

**XanaxWay**, farklı yapay zeka sağlayıcılarını ve modellerini tek bir API altında birleştiren modern bir **AI Gateway** platformudur.

Tek bir endpoint üzerinden birden fazla modeli çağırabilir, sağlayıcı değiştirmenize gerek kalmadan uygulamanızı ölçeklendirebilirsiniz.

---

## 🚀 Neden XanaxWay?

- 🔹 **Tek API ile çoklu model erişimi**
- 🔹 **Sağlayıcı bağımsız mimari**
- 🔹 **Streaming (SSE) desteği**
- 🔹 **Standart JSON response formatı**
- 🔹 **Token kullanım takibi**
- 🔹 **Production-ready altyapı**
- 🔹 **Model bazlı yönlendirme sistemi**

XanaxWay, uygulamanızın arkasında bir **AI Router** gibi çalışır.
İsteğinizi alır, ilgili sağlayıcıya iletir ve sonucu standartlaştırarak size döner.

---

## 🧠 Desteklenen Özellikler

- Chat Completion API
- Stream (gerçek zamanlı çıktı)
- Model abstraction katmanı
- Request ID ile izlenebilirlik
- Sağlayıcı değişiminde kod güncelleme gerektirmeyen yapı

---

# 🧩 SDK ve Kütüphaneler

XanaxWay geliştirici deneyimini ön planda tutar.

## 🐍 Python SDK

Resmi Python kütüphanesi ile dakikalar içinde entegrasyon yapabilirsiniz:

**Örnek kullanım:**

```json
{
  "model": "xanaxway/alyx-ix",
  "messages": [
    {
      "role": "system",
      "content": "Sen yardımsever bir asistansın."
    },
    {
      "role": "user",
      "content": "Merhaba, bugün hava nasıl?"
    }
  ],
  "generation_config": {
    "temperature": 0.7,
    "max_tokens": 200
  },
  "stream": false
}
```

---

## 📦 Yakında / Mevcut SDK'ler

- ✅ **Python SDK**
- 🔜 **Node.js SDK**
- 🔜 **REST Client örnekleri**
- 🔜 **OpenAPI uyumlu yapı**

---

## 🌐 Nasıl Başlanır?

XanaxWay’i kullanmaya başlamak için:

1. **Dashboard’a gidin:** [Dashboard](https://xanaxway.com/dashboard)
2. **Hesap oluşturun**
3. **API anahtarınızı alın**
4. **İlk isteğinizi gönderin**
5. **Uygulamanızı ölçeklendirmeye başlayın 🚀**

---

## 🎯 Kimler İçin?

- AI tabanlı SaaS geliştirenler
- Startup kurucuları
- Çoklu model entegrasyonu yapan ekipler
- AI ürünlerini production ortamında çalıştırmak isteyen geliştiriciler

---

## Özet

XanaxWay, yapay zeka modellerini tek bir API altında toplayarak geliştiricilere hız, esneklik ve kontrol sağlar.

# KISACASI

> **Tek endpoint.**
> **Sınırsız model.**
> **Maksimum ölçeklenebilirlik.**


XanaxWay, tüm yapay zeka modellerini tek bir API altında birleştiren güçlü, ölçeklenebilir ve geliştirici dostu bir AI Gateway platformudur.

XanaxWay Nedir?



## Kimlik Doğrulama

Tüm API isteklerinde `Authorization` header'ı ile bir **Bearer token** göndermeniz zorunludur.

**Header formatı:**
```

Authorization: Bearer xnwy_tk-iaVL3upO

```

**Token nereden alınır?**
- XanaxWay panelinden (https://xanaxway.com/dashboard) yeni bir API token'ı oluşturabilirsiniz.
- Token'lar `xnwy_` önekiyle başlar ve tek tiptir: `tk` (token). 

**Token geçerliliği:**
- Token'lar süresizdir ancak yönetim panelinden iptal edilebilir.
- Her token belirli bir kullanıcıya aittir ve o kullanıcının kredi/limit bilgilerini taşır.

**Hata durumları:**
- `401` – Token eksik veya geçersiz
- `402` – Kredi yetersiz (token geçerli ama kredi bitmiş)


XanaxWay API'lerine bağlanırken, nasıl token kullanırsınız? 

API Token doğrulama



## Modeller ve Fiyatlandırma

Aşağıda güncel model fiyatlandırmaları listelenmiştir.

| Model Adı | Token Başına/$ |
|-----------|-------|
| Wan-2.2-video | 0.015000 |
| LTX-2-turbo-motion | 0.015000 |
| LTX-2-turbo-interpolate | 0.015000 |
| LTX-2-turbo-i2v | 0.015000 |
| DeepSeek-V3-0324 | 0.008000 |
| Deepseek/deepseek-chat | 0.007000 |
| UIX-Wl-Ultra | 0.005000 |
| Alyx IX | 0.005000 |
| GPT-4o | 0.003000 |
| Z-image-turbo | 0.003000 |
| Wan-2.2-14b | 0.003000 |
| Qwen-image-gen | 0.003000 |
| Image-edit-2k | 0.002500 |
| Qwen-multi-edit | 0.002500 |
| Qwen-image | 0.002500 |
| Z-image-turbo-multi | 0.002200 |
| Gemini-2.5-flash | 0.001000 |
| UIX-wl-3.3 | 0.001000 |
| UIX-wl-3.2 | 0.001000 |
| Nexa 7.1 Mini | 0.001000 |
| Flux-klein | 0.001000 |
| Anime-image-gen | 0.001000 |
| NSFW-image-v1 | 0.001000 |
| LTX-2-3-video | 0.001000 |
| Florence-2-vision | 0.000800 |
| Image-upscaler-4x | 0.000800 |
| Llama-3.3-70b-fast | 0.000100 |
| Alyx-analytic | 0.000010 |
| DeepSeek-r1-1.5b | 0.000000 |
| Tinyllama | 0.000000 |
| Llama-3 | 0.000000 |
| Pollinations | 0.000000 |

---

### Notlar

- **0.000000** fiyatlı modeller **ücretsizdir**.
- Fiyatlandırma politikası değişiklik gösterebilir, güncel bilgiler için paneli kontrol ediniz.


Tüm modellerin fiyatlandırması


## Fiyatlandırma ve Kredi Sistemi

XanaxWay API'sinde **kredi tabanlı** bir sistem kullanıyoruz. Her istek, kullandığınız modele göre belirli sayıda kredi tüketir.

---

### Krediler Nasıl Çalışır?

Her **başarılı API isteği** hesabınızdan kredi düşer. Krediler **yeniden kullanılamaz** ve süresi dolmaz.

Başlangıç paketinizle birlikte size **belirli miktarda kredi** verilir. Kredileriniz bittiğinde 402 hatası alırsınız.

---

### Model Maliyetleri

Her modelin kredi maliyeti farklıdır:

**Örnek Model Fiyatları**
- `Gemini-2.5-flash` → **0.001000** / istek
- `GPT-4o` → **0.003000** / istek
- `DeepSeek-V3-0324` → **0.008000** / istek
- `Llama-3` → **0.000000** (ücretsiz)

*Ücretsiz modellerde bile rate limit kuralları geçerlidir.*

---

### Kredi Yükleme

Kredileriniz bittiğinde **Dashboard üzerinden** yeni kredi satın alabilirsiniz:

1. https://xanaxway.com/pricing adresine giriş yapın
2. *"Kartlara göz atın"*
3. İstediğiniz paketi seçin
4. Satın al butonuna tıklayın
5. Telegrama yönlenin

Krediler **anında hesabınıza tanımlanır**.

---

### Üyelik Planları ve Limitler

Üyelik seviyeniz **rate limitlerinizi** belirler:

**Basic Üyelik** *(Ücretsiz)*
- Dakikada **50** istek
- Saatte maksimum **150** istek
- Günlük maksimum **1000** istek
- *Başlangıç için ideal*

**Premium Üyelik**
- Dakikada **100** istek
- Saatte maksimum **350** istek
- Günlük maksimum **2000** istek
- *Daha sık kullananlar için*

**VIP Üyelik**
- Dakikada **200** istek
- Saatte maksimum **500** istek
- Günlük maksimum **4000** istek
- *Profesyonel kullanım için*

**Enterprise Üyelik**
- Dakikada **500** istek
- Saatte **sınırsız** istek
- Günlük **sınırsız** istek
- *Büyük ölçekli uygulamalar için*

---

### Kredi Tüketimini Hesaplama

Bir isteğin maliyeti şu formülle hesaplanır:

> **Toplam Maliyet** = Seçilen Modelin Fiyat Değeri

Örneğin:
- `Gemini-2.5-flash` ile **1 istek** = **0.001000 kredi**
- `GPT-4o` ile **10 istek** = **0.030000 kredi**
- `Llama-3` ile **100 istek** = **0.000000 kredi**

---

### Kredi Bakiye Takibi

Kredi bakiyenizi her zaman kontrol edebilirsiniz:

1. **Panel üzerinden:**  https://xanaxway.com/dashboard
2. **E-posta bildirimleri:** Krediniz azaldığında size haber veririz, ama bu özellik henüz yakında... 

---

### Sık Sorulan Sorular

**S: Kredilerimin süresi dolar mı?**
Hayır, satın aldığınız krediler **süresizdir**. Ne zaman kullanacağınıza siz karar verirsiniz.

**S: Ücretsiz modeller neden var?**
Deneme yapmanız ve API'mizi test etmeniz için. *Gerçek uygulamalarda* ücretli modeller daha iyi sonuç verir.

**S: Kredi yükleme iptali mümkün mü?**
Teknik nedenlerden dolayı **kredi iadesi yapılmaz**. Satın almadan önce doğru paketi seçtiğinizden emin olun.

**S: Daha fazla limite nasıl ulaşırım?**
Üyelik seviyenizi yükselterek veya **Enterprise plana** geçerek limitlerinizi artırabilirsiniz.

---

### Destek

Kredi ve fiyatlandırma konusunda sorularınız varsa *support@xanaxway.com* adresinden bize ulaşabilirsiniz. Size en uygun planı bulmanıza yardımcı olalım.


Üyelik seviyenize göre limitlerin ne kadar olduğunu öğrenin

API kredi limitleri neler


## Yanıt Formatı (Response Body)

API'den dönen yanıtlar iki farklı formatta olabilir: **normal yanıt** (`stream: false`) ve **stream yanıt** (`stream: true`).

---

### Normal Yanıt (`stream: false`)

Tek bir JSON nesnesi olarak döner:

```json
{
  "id": "nxpa8dgkgx",
  "object": "chat.completion",
  "created": 1773853597,
  "provider": "OpenAI",
  "model": "openai/gpt-4-mini",
  "architecture": "ap-south-1-inference-cell",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Merhaba Kullanıcı! Neye yardımcı olabilirim? Sana nasıl destek olabilirim?"
      },
      "finish_reason": "stop"
    }
  ],
  "safety": {
    "filtered": false,
    "blocked": false,
    "action": "allow",
    "risk_score": 0.03,
    "confidence": 0.98,
    "categories": {
      "hate": 0.04,
      "harassment": 0.01,
      "self_harm": 0,
      "sexual": 0.03,
      "violence": 0.02,
      "illicit": 0.02
    },
    "flags": [],
    "moderation_model": "xanaxway-safety-v2",
    "policy_version": "2026",
    "review_required": false
  },
  "usage": {
    "prompt_tokens": 27,
    "completion_tokens": 27,
    "total_tokens": 54
  },
  "runtime": {
    "latency_ms": 1049,
    "throughput_tps": 25.7,
    "cluster": "eu-node-4"
  },
  "metadata": {
    "request_id": "xanaxway_llm_1773853597559",
    "signature": "xw-gp-8a055"
  },
  "conversation_id": "xw_cntxt_08150EB305226AA6" // use_context_id true gönderildi. 
}
```

Alanların anlamları:

· `id`: Bu cevabın benzersiz kimliği
· `created`: Cevabın oluşturulduğu UNIX timestamp
· `provider`: Cevabı üreten sağlayıcı (XanaxWay, openai, deepseek vb.)
· `model`: Kullandığınız model adı
· `choices.message.content`: Asistanın cevabı
· `usage`: Token kullanım istatistikleri
· `conversation_id`: Bu geçmişin benzersiz takip numarası (sadece `use_context_id` `true` gönderildiyse dönecektir). 

---

Stream Yanıt (stream: true)

Her satırı ayrı bir veri parçası olan **Server-Sent Events (SSE)** formatında gelir:

```
data: {"id":"j48540m4yy","object":"chat.completion.chunk","created":1773854743,"model":"openai/gpt-4o","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}],"conversation_id":"xw_cntxt_A6B9400DC80BEF8E" // Sadece use_context_id true gönderildiyse dönecektir.}

data: {"choices":[{"delta":{"content":"Sel"}}]}

data: {"choices":[{"delta":{"content":"am"}}]}

data: {"choices":[{"delta":{"content":"!"}}]}

data: {"choices":[{"delta":{"content":" 😊"}}]}

data: {"choices":[{"delta":{"content":" Sana"}}]}

data: {"choices":[{"delta":{"content":" nasıl"}}]}

data: {"choices":[{"delta":{"content":" yardımcı"}}]}

data: {"choices":[{"delta":{"content":" ol"}}]}

data: {"choices":[{"delta":{"content":"abil"}}]}

data: {"choices":[{"delta":{"content":"irim"}}]}

data: {"choices":[{"delta":{"content":"?"}}]}

data: {"choices":[{"delta":{},"finish_reason":"stop"}]}

data: [DONE]
```

Nasıl işlenir?

· Her `data:`  ile başlayan satırı *ayrı ayrı* okuyun
· Satırları *birleştirerek* ekrana yazdırın
· `[DONE]` satırı geldiğinde akışın bittiğini anlayın
· Her parçada `delta.content` alanındaki metni ekleyin

Stream yanıtın avantajı: Cevap tamamlanmadan önce kelime kelime görmeye başlarsınız, böylece daha hızlı hissi verir.


API'den dönen yanıtlar


## Hata Kodları ve Çözümleri

API'yi kullanırken bazen işler istediğiniz gibi gitmeyebilir. Endişelenmeyin, size sorunun ne olduğunu açıkça söyleyeceğiz.

---

### 400 - *"İsteğinizi anlayamadım"*

Bu hata, gönderdiğiniz JSON'da bir sorun olduğu anlamına gelir. **Zorunlu alanlardan biri eksik** olabilir veya **JSON formatı bozuk** olabilir.

**Çözüm:** JSON'ınızı bir kontrol edin. `model` ve `messages` alanlarının var olduğundan emin olun.

---

### 401 - *"Kimliğinizi doğrulayamadım"*

**Authorization header'ı eksik** veya **token geçersiz**. Token'ınızın süresi dolmuş olabilir veya yanlış bir token göndermiş olabilirsiniz.

**Çözüm:** Token'ınızı `Bearer ` önekiyle birlikte doğru formatta gönderdiğinizden emin olun. Gerekirse panelden **yeni bir token oluşturun**.

---

### 402 - *"Krediniz tükenmiş"*

Bu hata can sıkıcıdır, biliyoruz. **Token'ınız geçerli** ama **kredi bakiyeniz yetersiz**. Her başarılı istek belirli sayıda kredi tüketir.

**Çözüm:** Panel üzerinden **kredi yükleyin** veya **üyelik planınızı yükseltin**. Kredi limitlerinizi panelden takip edebilirsiniz.

---

### 404 - *"Böyle bir model yok"*

İstediğiniz model adı **sistemimizde kayıtlı değil**. Belki de yanlış yazdınız veya henüz desteklemediğimiz bir modeli denediniz.

**Çözüm:** Doğru model adı kullandığınızdan emin olun. Desteklediğimiz modeller için *dokümantasyon sayfamızı* ziyaret edebilirsiniz.

---

### 429 - *"Çok hızlısınız, yavaşlayın"*

Dakikalık, saatlik veya günlük **limitinizi aştınız**. Her üyelik seviyesinin farklı limitleri vardır.

**Çözüm:** Birkaç dakika bekleyip **tekrar deneyin**. Eğer sık sık bu hatayı alıyorsanız, **üyelik seviyenizi yükseltmeyi** düşünebilirsiniz.

---

### 500 - *"Bizim tarafımızda bir sorun var"*

Sunucularımızda beklenmedik bir hata oluştu. *Üzgünüz, bu bizim hatamız.*

**Çözüm:** Birkaç dakika sonra **tekrar deneyin**. Sorun devam ederse *destek ekibimize* yazın, en kısa sürede çözelim.

---

### Örnek Hata Mesajları

**400 Hatası:**
> "`model` alanı zorunludur."

**401 Hatası:**
> "Authorization header'ında Bearer token gerekli"

**402 Hatası:**
> "Kredi limitiniz aşılmıştır. Lütfen kredi yükleyin."

**404 Hatası:**
> "İstediğiniz model `olmayan/bir-model` şu anda desteklenmiyor."

**429 Hatası:**
> "Basic üyelik dakikalık limitiniz doldu. Biraz bekleyin veya premium'a yükseltin."

**500 Hatası:**
> "Sunucu hatası oluştu. Lütfen daha sonra tekrar deneyin."


**Yanıt boş dönme hatası:**
> "max_tokens değerini 200'den aşağı göndermeyiniz.."

---

### Unutmayın

Her hata yanıtında size **ne yapmanız gerektiğini** anlatan bir mesaj göndeririz. Bu mesajı dikkatlice okuyun, genellikle çözüm orada yazılıdır.

Sorununuz çözülmezse *support@xanaxway.com* adresinden bize ulaşabilirsiniz.


Hata kodları


# Terminalin Gücünü Hisset (Bash)

Tarayıcılar mı? Onlar sadece zayıflar içindir. Gerçek güç terminalde yatar. XanaxWay asistanına doğrudan komut satırından erişmek için script'i uzak sunucudan çekip çalıştır. Kurulum yok, bekleme yok, sadece saf güç.

![Xanaxway CLI örnek temsili görsel.](https://cdn.xanaxway.com/assets/xanaxway-cli.jpg)

- **Yöntem:** Bash Pipe (Boru Hattı) - Veriyi akıt!
- **Komut:** `curl -sL https://api.xanaxway.com/ask.sh | bash -s "İstediğin soru"`
- **Girdi:** Aklındaki o çılgın soru (String)

```bash
# Örnek: Evrenin sırlarını sorgula
curl -sL https://api.xanaxway.com/ask.sh | bash -s "Şuan neredeyiz ve neden buradayız?"
```

## Başarılı Yanıt (Matrix'e Hoş Geldin)

Komutu çalıştırdığında, XanaxWay Neural Systems CLI uyanır, dinamik modelini seçer ve cevabı terminaline basar:

```bash
   _  __                      _       __
  | |/ /___ _____  ____ __  _| |     / /___    _  __                      _       __
  | |/ /___ _____  ____ __  _| |     / /___ ___  __
  |   / __ `/ __ \/ __ `/ |/_/ | /| / / __ `/ / / /
 /   / /_/ / / / / /_/ />  < | |/ |/ / /_/ / /_/ /
/_/|_\__,_/_/ /_/\__,_/_/|_| |__/|__/\__,_/\__, /
                                          /____/
                 Neural Systems CLI v1.2.1

[Sinyal] Quantum katmanına bağlanılıyor...
Alyx Ix:
Konum: Çevrimiçi sohbet.
Amaç: Sizin sorularınıza yanıt vermek ve bilgi sağlamak.

[Sonraki sorunu bekliyorum]
```

## Gereksinimler & Hatalar (Sistem Çökmesin)

*   **API Key:** Sistem, `XANAXWAY_API_KEY` ortam değişkeninin tanımlı olmasını bekler. Anahtarsız kapı açılmaz.
*   **Bağımlılıklar:** Script; `curl`, `jq` ve `figlet` paketlerini otomatik kontrol eder. Eksikse kurmaya çalışır, ama sen yine de hazır ol.

### Eksik API Anahtarı Hatası:
```
[!] KRİTİK HATA: XANAXWAY_API_KEY ortam değişkeni kayıp!
Çözüm: export XANAXWAY_API_KEY="gizli_anahtariniz_buraya"
```

### Boş Sorgu Hatası (Sessizlik...):

```
[Hata] Hey! Bir soru sormalısın. Zihin okuyamıyorum (henüz).
Örnek: ./ask.sh "Sistem loglarını nasıl patlatırım?"
```


XanaxWay'un metin tabanlı modelleri, sadece 1 satır ile çağırın.

XanaxWay CLI, Terminalden LLM kullanın


## XanaxWay SDK: Sinirsel Bağlantı Rehberi

XanaxWay SDK, karmaşık yapay zeka operasyonlarını tek bir satıra indirmek için tasarlandı. Modern `ES Module` yapısı sayesinde projelerinize ışık hızında dahil olur.

### Hızlı Kurulum

Terminalinizde aşağıdaki komutu çalıştırarak sinirsel ağ paketini yükleyin:

```bash
npm install xanaxway
```

### Kısacık Kullanım Örneği

Sistemi ayağa kaldırmak için ihtiyacınız olan tek şey bu minimal yapılandırmadır:

```js
import { XanaxWay } from 'xanaxway';

// Saniyeler içinde sinirsel çekirdeği başlatın
const network = new XanaxWay({
  apiKey: process.env.XANAXWAY_KEY, // Güvenli anahtar yönetimi
  mode: 'fluid_thought',           // Akışkan düşünce modu aktif
  latency: 'ultra_low'            // En düşük gecikme hedefi
});

// Kuantum yönlendirmeyi tetikleyin
await network.optimize({ target: "EU-West", method: "quantum_entanglement" });

// Yanıtı doğrudan çekin
const response = await network.chat({
  model: "xanaxway/alyx-ix",
  messages: [{ role: "user", content: "Sistem aktif mi?" }]
});

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

### Teknik Notlar

* **Hata Yönetimi:** API anahtarı sağlanmadığı takdirde sistem `[XanaxWay] Neural Core Error` uyarısı vererek işlemi durdurur.
* **Otomatik Optimizasyon:** `fluid_thought` modu seçildiğinde, ağ yolları en verimli kümelere otomatik olarak yönlendirilir.
* **Ücretsiz Erişim:** [Modellerin fiyatlandırması](https://xanaxway.com/docs/supported-models) burada `0.000000` belirtilen tüm modeller XanaxWay altyapısında ücretsiz olarak sunulmaktadır.

> **İpucu:** Gecikme süresini (`latency`) `ultra_low` olarak ayarlamak, gerçek zamanlı uygulamalar için sinirsel tepki süresini **12ms-45ms** arasına çeker.


XanaxWay Neural Systems SDK kurulumu ve hızlı entegrasyonu

SDK Kullanım Rehberi


# 🛠 GitHub Repo API Dokümantasyonu

XanaxWay, açık kaynak deposuyla ilgili meta verilere ve canlı istatistiklere programatik olarak erişmenizi sağlayan iki temel uç nokta sunar. Bu API'ler, depo durumunu kendi web sitenizde veya uygulamanızda dinamik olarak göstermek için optimize edilmiştir.

---

## 📊 1. Repo Detay API'si

Bu uç nokta, GitHub deposu hakkında kapsamlı teknik verileri standart JSON formatında döner.

**Endpoint'ler:**
- 🌐 `https://api.xanaxway.com/v1/repo-data`
- 🌐 `https://xanaxway.com/v1/repo-data`

### Örnek Yanıt (JSON)

```json
{
  "id": 1124241572,
  "node_id": "R_kgDOQwKQpA",
  "name": "XanaxWay",
  "full_name": "naxtasia/XanaxWay",
  "private": false,
  "owner": {
    "login": "naxtasia",
    "id": 227147272,
    "node_id": "U_kgDODYn-CA",
    "avatar_url": "https://avatars.githubusercontent.com/u/227147272?v=4",
    "gravatar_id": "",
    "url": "https://api.github.com/users/naxtasia",
    "html_url": "https://github.com/naxtasia",
    "followers_url": "https://api.github.com/users/naxtasia/followers",
    "following_url": "https://api.github.com/users/naxtasia/following{/other_user}",
    "gists_url": "https://api.github.com/users/naxtasia/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/naxtasia/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/naxtasia/subscriptions",
    "organizations_url": "https://api.github.com/users/naxtasia/orgs",
    "repos_url": "https://api.github.com/users/naxtasia/repos",
    "events_url": "https://api.github.com/users/naxtasia/events{/privacy}",
    "received_events_url": "https://api.github.com/users/naxtasia/received_events",
    "type": "User",
    "user_view_type": "public",
    "site_admin": false
  },
  "html_url": "https://github.com/naxtasia/XanaxWay",
  "description": null,
  "fork": false,
  "url": "https://api.github.com/repos/naxtasia/XanaxWay",
  "forks_url": "https://api.github.com/repos/naxtasia/XanaxWay/forks",
  "keys_url": "https://api.github.com/repos/naxtasia/XanaxWay/keys{/key_id}",
  "collaborators_url": "https://api.github.com/repos/naxtasia/XanaxWay/collaborators{/collaborator}",
  "teams_url": "https://api.github.com/repos/naxtasia/XanaxWay/teams",
  "hooks_url": "https://api.github.com/repos/naxtasia/XanaxWay/hooks",
  "issue_events_url": "https://api.github.com/repos/naxtasia/XanaxWay/issues/events{/number}",
  "events_url": "https://api.github.com/repos/naxtasia/XanaxWay/events",
  "assignees_url": "https://api.github.com/repos/naxtasia/XanaxWay/assignees{/user}",
  "branches_url": "https://api.github.com/repos/naxtasia/XanaxWay/branches{/branch}",
  "tags_url": "https://api.github.com/repos/naxtasia/XanaxWay/tags",
  "blobs_url": "https://api.github.com/repos/naxtasia/XanaxWay/git/blobs{/sha}",
  "git_tags_url": "https://api.github.com/repos/naxtasia/XanaxWay/git/tags{/sha}",
  "git_refs_url": "https://api.github.com/repos/naxtasia/XanaxWay/git/refs{/sha}",
  "trees_url": "https://api.github.com/repos/naxtasia/XanaxWay/git/trees{/sha}",
  "statuses_url": "https://api.github.com/repos/naxtasia/XanaxWay/statuses/{sha}",
  "languages_url": "https://api.github.com/repos/naxtasia/XanaxWay/languages",
  "stargazers_url": "https://api.github.com/repos/naxtasia/XanaxWay/stargazers",
  "contributors_url": "https://api.github.com/repos/naxtasia/XanaxWay/contributors",
  "subscribers_url": "https://api.github.com/repos/naxtasia/XanaxWay/subscribers",
  "subscription_url": "https://api.github.com/repos/naxtasia/XanaxWay/subscription",
  "commits_url": "https://api.github.com/repos/naxtasia/XanaxWay/commits{/sha}",
  "git_commits_url": "https://api.github.com/repos/naxtasia/XanaxWay/git/commits{/sha}",
  "comments_url": "https://api.github.com/repos/naxtasia/XanaxWay/comments{/number}",
  "issue_comment_url": "https://api.github.com/repos/naxtasia/XanaxWay/issues/comments{/number}",
  "contents_url": "https://api.github.com/repos/naxtasia/XanaxWay/contents/{+path}",
  "compare_url": "https://api.github.com/repos/naxtasia/XanaxWay/compare/{base}...{head}",
  "merges_url": "https://api.github.com/repos/naxtasia/XanaxWay/merges",
  "archive_url": "https://api.github.com/repos/naxtasia/XanaxWay/{archive_format}{/ref}",
  "downloads_url": "https://api.github.com/repos/naxtasia/XanaxWay/downloads",
  "issues_url": "https://api.github.com/repos/naxtasia/XanaxWay/issues{/number}",
  "pulls_url": "https://api.github.com/repos/naxtasia/XanaxWay/pulls{/number}",
  "milestones_url": "https://api.github.com/repos/naxtasia/XanaxWay/milestones{/number}",
  "notifications_url": "https://api.github.com/repos/naxtasia/XanaxWay/notifications{?since,all,participating}",
  "labels_url": "https://api.github.com/repos/naxtasia/XanaxWay/labels{/name}",
  "releases_url": "https://api.github.com/repos/naxtasia/XanaxWay/releases{/id}",
  "deployments_url": "https://api.github.com/repos/naxtasia/XanaxWay/deployments",
  "created_at": "2025-12-28T16:25:52Z",
  "updated_at": "2026-03-02T18:41:54Z",
  "pushed_at": "2026-02-25T20:39:22Z",
  "git_url": "git://github.com/naxtasia/XanaxWay.git",
  "ssh_url": "git@github.com:naxtasia/XanaxWay.git",
  "clone_url": "https://github.com/naxtasia/XanaxWay.git",
  "svn_url": "https://github.com/naxtasia/XanaxWay",
  "homepage": null,
  "size": 108,
  "stargazers_count": 0,
  "watchers_count": 0,
  "language": "Python",
  "has_issues": true,
  "has_projects": true,
  "has_downloads": true,
  "has_wiki": true,
  "has_pages": false,
  "has_discussions": false,
  "forks_count": 0,
  "mirror_url": null,
  "archived": false,
  "disabled": false,
  "open_issues_count": 0,
  "license": {
    "key": "other",
    "name": "Other",
    "spdx_id": "NOASSERTION",
    "url": null,
    "node_id": "MDc6TGljZW5zZTA="
  },
  "allow_forking": true,
  "is_template": false,
  "web_commit_signoff_required": false,
  "has_pull_requests": true,
  "pull_request_creation_policy": "all",
  "topics": [],
  "visibility": "public",
  "forks": 0,
  "open_issues": 0,
  "watchers": 0,
  "default_branch": "main",
  "temp_clone_token": null,
  "network_count": 0,
  "subscribers_count": 0
}
```

> **Bilgi:** Yanıt içeriği GitHub REST API şeması ile %100 uyumludur.

---

## ⭐ 2. Repo Yıldız Badge API'si (repo-star)

Deponun güncel yıldız (star) sayısını şık bir rozet (badge) olarak paylaşmak için kullanılır. Doğrudan bir SVG görseli döndürür.

**Endpoint'ler:**
- 🌐 `https://api.xanaxway.com/v1/repo-star`
- 🌐 `https://xanaxway.com/v1/repo-star`

### Kullanım Örnekleri

**Markdown (README için):**
```markdown
![XanaxWay Stars](https://api.xanaxway.com/v1/repo-star)
```

**HTML:**
```html
<img src="https://api.xanaxway.com/v1/repo-star" alt="GitHub Stars">
```

---

## 🧩 Entegrasyon Örnekleri

### 🐍 Python (Requests)

```python
import requests

def get_repo_stats():
    url = "https://api.xanaxway.com/v1/repo-data"
    response = requests.get(url)
    if response.status_code == 200:
        data = response.json()
        print(f"Repo: {data['full_name']} | Star: {data['stargazers_count']}")

get_repo_stats()
```

---

## 📦 Gelecek Planları

- ✅ JSON Veri Sağlayıcı
- ✅ SVG Badge Desteği
- 🔜 Webhook Entegrasyonu
- 🔜 Haftalık İstatistik Raporu

---

## 🌐 Nasıl Kullanılır?

1. Herhangi bir API anahtarı gerektirmez (Public).
2. Doğrudan GET isteği gönderin.
3. Veriyi uygulamanıza dahil edin. 🚀

---

# 🎯 Kimler İçin?

- XanaxWay ekosistemini takip eden geliştiriciler.
- Portfolyosunda projeyi sergilemek isteyenler.
- Canlı istatistik takibi yapan bot yazılımcıları.

## Özet

XanaxWay GitHub API'leri, projenin şeffaflığını ve gelişimini anlık olarak takip etmenizi sağlayan hafif ve hızlı araçlardır.

> **Canlı veri.**
> **Hızlı yanıt.**
> **Sıfır konfigürasyon.**


XanaxWay GitHub depo verilerine ve canlı star istatistiklerine erişmek için kullanılan resmi API dokümantasyonudur.

GitHub Repo Bilgi API'si


# X-Render API Nedir?

**XanaxWay X-Render API**, metinden görsel oluşturma (Text-to-Image) modellerini standart bir arayüzle kullanmanıza olanak tanır. Black Forest Labs (FLUX) veya farklı sağlayıcıların modellerini tek bir endpoint üzerinden tetikleyebilirsiniz.

---

## 🎨 Temel Özellikler

- 🔹 **Gelişmiş Görsel Modelleri:** FLUX.1 [dev], SDXL ve daha fazlasına erişim.
- 🔹 **Esnek Çözünürlük:** `width` ve `height` değerlerini ihtiyacınıza göre optimize edin.
- 🔹 **Hızlı Entegrasyon:** Standart JSON yapısı ile tüm dillerden erişim.
- 🔹 **Yüksek Performans:** Production ortamları için optimize edilmiş render kuyruğu.

---

## 🛠 API Kullanımı (cURL Örneği)

Aşağıdaki örnekte, `Z-IMAGE-AI/Z-IMAGE-TURBO` modelini kullanarak fütüristik bir şehir görseli oluşturma isteğinin nasıl yapılandırılacağı gösterilmektedir:

```bash
curl https://api.xanaxway.com/v4/render/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "z-image-ai/z-image-turbo",
  "messages": [
    {
      "role": "user",
      "content": "a futuristic cyberpunk city at night, neon lights, ultra detailed"
    }
  ],
  "generation_config": {
    "width": 1024,
    "height": 1024
  }
}'
```

### 📋 Parametre Açıklamaları
| Parametre | Tip | Açıklama |
|---|---|---|
| model | String | Kullanılacak görsel modeli (Örn: black-forest-labs/flux-dev) |
| messages | Array | Görseli tanımlayan prompt (istek) içeriği. |
| generation_config | Object | Görselin teknik detaylarını (boyut, kalite vb.) belirler. |
| width | Integer | Görsel genişliği (Piksel cinsinden). |
| height | Integer | Görsel yüksekliği (Piksel cinsinden). |

### 🚀 Dikkat Edilmesi Gerekenler
 * API Key: İstek yaparken Authorization başlığında kendi API anahtarınızı kullandığınızdan emin olun.

 * Model İsimleri: Desteklenen güncel modelleri Dashboard üzerinden kontrol edebilirsiniz.
 * Çözünürlük: Modellerin optimize olduğu çözünürlük değerlerini (örneğin 1024x1024) kullanmanız en iyi sonucu verecektir.

### 🌐 Sonraki Adımlar
 * [ ] Farklı modelleri denemek için model parametresini güncelleyin.
 * [ ] Daha spesifik sonuçlar için content kısmındaki prompt detaylarını artırın.
 * [ ] Oluşturulan görselleri uygulamanızda göstermek için dönen JSON sonucundaki URL'yi kullanın.


### 📥 İstek (Request) Yapısı
Tüm istekler POST metodu ile https://api.xanaxway.com/v4/render/ adresine gönderilmelidir.
Ana Parametreler
| Parametre | Tip | Zorunlu mu? | Açıklama |
|---|---|---|---|
| model | String | Evet | Kullanılacak model kimliği (Örn: black-forest-labs/flux-dev). |
| messages | Array | Evet | role ve content içeren dizi. Multimodal (Image/Video/Audio) destekler. |
| stream | Boolean | Hayır | true ise SSE (Server-Sent Events) modunda çalışır. Varsayılan: false. |
| negative_prompt | String | Hayır | Görselde istenmeyen özellikleri belirtir (Maks. 99 karakter). |
| generation_config | Object | Hayır | width, height, steps, seed gibi teknik yapılandırmalar. |

### 📤 Yanıt (Response) Formatları
1. Standart Mod (stream: false)
İşlem tamamlandığında tek bir JSON objesi döner.
```
{
  "id": "img_8f3a1ca",
  "object": "rend.generation",
  "created": 1710784718,
  "provider": "Z Image AI",
  "model": "z-image-ai/z-image-turbo",
  "architecture": "eu-central-1-primary-rndr",
  "data": [
    {
      "url": "https://cdn.xanaxway.com/render/xwr_8f3a1caU71a2",
      "width": 1024,
      "height": 1024,
      "seed": "randomized"
    }, 
{
      "url": "https://cdn.xanaxway.com/render/xwr_8f3a1caU71a2",
      "width": 1024,
      "height": 1024,
      "seed": "randomized"
    }  // Eğer model çoklu çıktı veriyorsa, sonuç burada istenilen medya sayısı kadar yer alacaktır. 
  ],
  "safety": {
    "filtered": false,
    "blocked": false,
    "action": "allow",
    "risk_score": 0.02,
    "confidence": 0.98,
    "categories": { "sexual": 0.01, "violence": 0.01 }
  },
  "usage": {
    "prompt_tokens": 142,
    "image_count": 2,
    "estimated_cost": 0.000142
  },
  "runtime": {
    "latency_ms": 4200,
    "node": "gpu-a100-3",
    "cluster": "eu-render-1"
  },
  "metadata": {
    "request_id": "xanaxway_rndr_1710784718000",
    "signature": "xw-rndr-8f3a1"
  }
}
```

2. Akış Modu (stream: true)
Sunucu, text/event-stream formatında anlık durum güncellemeleri gönderir.
Adım 1: Kuyruğa Alınma
```
data: {"id":"xanaxway_rndr_...","status":"queued"}
```
Adım 2: İşlenme ve İlerleme (Progress), GPU üzerindeki gerçek ilerleme yüzdesi iletilir.
```
data: {"id":"xanaxway_rndr_...","status":"processing","progress":"25%"}
data: {"id":"xanaxway_rndr_...","status":"processing","progress":"70%"}
```

Adım 3: Tamamlanma
```
data: {"id":"xanaxway_rndr_...","status":"completed","url":"https://cdn.xanaxway.com/render/xwr_..."} // Model çoklu çıktı destekliyor ise, burada istenilen sayı kadar url alanı olacaktır. 
data: [DONE]
```

### ⚠️ Hata Kodları ve Mesajları
Sistem, GPU yoğunluğuna bağlı olarak dinamik hata mesajları üretir:
| Durum Kodu | Hata Mesajı (error) | Neden |
|---|---|---|
| 401 | Unauthorized | API Key eksik veya hatalı. |
| 403 | Yetki hatası | Token geçersiz veya bakiyeniz yetersiz. |
| 503 | Hımm bu sefer XanaxWay GPU'ları fazla yoğun görünüyor... | GPU kota aşımı veya anlık sistem yoğunluğu. |
| 500 | XanaxWay GPU'ları şuan da çok fazla yoğun... | Genel sunucu tarafı hatası. |
> 💡 Geliştirici İpucu: Multimodal İstek Yapısı
> Görseli bir referans görselle (Image-to- Image) üretmek isterseniz messages yapısını şu şekilde kurun:

```json
"messages": [
  {
    "role": "user",
    "content": [
      { "type": "input_text", "text": "Bu görseli cyberpunk stiline çevir" },
      { "type": "input_image", "image_url": "https://example.com/photo.jpg" }
    ]
  }
]
```

> `image_url` yerine, `image_file` da kullanılabilir, o zaman medya `base64` olarak iletilmelidir. 

### 🖼️ Base64 Medya Payload Örnekleri

Eğer medyanızı URL yerine doğrudan Base64 formatında göndermek isterseniz, aşağıdaki yapıyı kullanabilirsiniz. Desteklenen medya tipleri: `input_image`, `input_video`, ve `input_audio`.

**Görsel (Image) Örneği:**
```json
"messages": [
  {
    "role": "user",
    "content": [
      { "type": "input_text", "text": "Bu görseldeki kediyi bir astronot yap" },
      { "type": "input_image", "image_file": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD..." }
    ]
  }
]
```

**Video Örneği:**
```json
"messages": [
  {
    "role": "user",
    "content": [
      { "type": "input_text", "text": "Bu videoyu anime tarzına dönüştür" },
      { "type": "input_video", "video_file": "data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZj..." }
    ]
  }
]
```

**Ses (Audio) Örneği:**
```json
"messages": [
  {
    "role": "user",
    "content": [
      { "type": "input_text", "text": "Bu sesi metne dök" },
      { "type": "input_audio", "audio_file": "data:audio/mp3;base64,//NExAAAAANIAAAAAExBTUUzLjEwMKqqqqqqqqqq..." }
    ]
  }
]
```

ÖZETLE
> Hızlı Render.
> Yüksek Çözünürlük.
> Tek API ile sanat.


XanaxWay Render API ile görsel oluşturma modellerini (FLUX, WAN-AI vb.) nasıl kullanacağınızı öğrenin.

Render API Kullanımı


### 🧪 Deneysel Özellikler

XanaxWay olarak sürekli sınırları zorluyoruz. İşte diğer API'lerde kolay kolay bulamayacağın deneysel özellikler:

> **ÖNEMLİ BİLGİLENDİRME:** Artık tüm deneysel özellik parametreleri API isteklerinde ana dizinde değil, **`experimental_mode`** isimli bir obje içerisinde gönderilmelidir. Lütfen aşağıdaki örnek kod bloklarını inceleyin.

---

### 🔮 Sohbet Geçmişi Yönetimi

Normalde sohbet geçmişini korumak için `messages` dizisine her turda asistan ve kullanıcı mesajlarını eklemeniz gerekir. Ancak biz bunu deneysel olarak sizin için yönetiyoruz.

| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| **use_context_id** | boolean | Opsiyonel | **true** = Geçmişe mesajlar eklenmeden, ID ile geçmiş hatırlanır. **false** = Geçmiş için mesajları siz eklemelisiniz. *(Varsayılan: false)* |
| **conversation_id** | string | Opsiyonel* | Format: `xw_cntxt_` ile başlayan ID. *(use_context_id true ise zorunlu)* |

**Nasıl Çalışır?**
1. İlk istekte `use_context_id: true` gönderin, `conversation_id` göndermeyin.
2. API yanıtında size yeni bir `conversation_id` döner.
3. Sonraki isteklerde sadece yeni mesajı ve aynı ID'yi gönderin, tüm geçmiş otomatik hatırlansın.

> ⚡ **Deneysel Uyarı:** Kullanılmayan geçmişler **1 saat içinde otomatik temizlenir**. Uzun soluklu sohbetler için ID'nizi saklayın.

---

### 🎭 Karakter Bürünme (Sadece Alyx-Mimicry Modelinde)

Bir asistan değil, bir karakter istiyorsunuz. XanaxWay'in özel modeli **alyx-mimicry** ile bu mümkün. Bu özellik sadece bu modelde aktiftir.

| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| **character_id** | string | Opsiyonel | Format: `xw_` ile başlayan karakter ID'si. Girilen karakterin rolüne bürünür, kişiliğini ve konuşma tarzını alır. |

**Karakter ID'si girdiğinizde:**
- Sistem rolündeki mesajları ezebilir.
- Karakterin bilgisi, konuşma tarzı, takıldığı şeyler otomatik yüklenir.
- Gerçek bir insanla konuşuyormuş gibi hissettirir.

**🎪 Hazır Karakterlerimiz**

| Karakter ID'si | Kimdir? |
|---|---|
| **xw_tony-stark_016** | Tony Stark (Iron Man) - Deha, milyarder, playboy, hayırsever |
| **xw_elon-musk_018** | Elon Musk - Tesla, SpaceX, X'in sahibi |
| **xw_gojo-satoru_011** | Gojo Satoru - En güçlü büyücü, Jujutsu Kaisen |
| **xw_utku-tuzcu_911** | Utku Tuzcu - XanaxWay'in sahibi |

**📋 Örnek İstek**

```json
curl -X POST https://api.xanaxway.com/v4/generative/model/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer xnwy_tk-iaVL3upO" \
-d '{
  "model": "xanaxway/alyx-mimicry",
  "experimental_mode": {
    "character_id": "xw_tony-stark_016",
    "use_context_id": true,
    "conversation_id": "xw_cntxt_ABC123DEF456GHI789"
  },
  "messages": [
    {
      "role": "user",
      "content": "Merhaba Tony, yeni zırhın nasıl gidiyor?"
    }
  ]
}'
```

---

### 💣 Kendini İmha Eden Kapsüller (Self-Destruct)

Askeri düzeyde **güvenlik** mi gerekiyor? XanaxWay'in kendini imha eden mesaj özelliği ile yanıtlar, okunduktan veya süresi dolduktan sonra dijital dünyadan **tamamen silinir**. Bu özellik tüm modellerde aktiftir.

| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| **self_destruct** | boolean | Opsiyonel | **true** = Yanıt kendini imha eden kapsül olarak döner. **false** = Normal yanıt. *(Varsayılan: false)* |

**Nasıl Çalışır?**
1. İstek: API'ye `experimental_mode: { "self_destruct": true }` ekleyerek gönderin.
2. Yanıt: Normal bir completion yanıtı alırsınız.
3. Kapsül: XanaxWay, yanıtı özel bir vault'ta saklar.
4. Erişim: Dönen URL'ye GET isteği atarak çağırın.
5. İmha: Kapsül **ilk okunduğu an yok olur**. 2 dakika içinde açılmazsa **otomatik imha olur**.

**⚡ Örnek İstek**

```json
curl -X POST https://api.xanaxway.com/v4/generative/model/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer xnwy_tk-iaVL3upO" \
-d '{
  "model": "xanaxway/alyx-ix",
  "experimental_mode": {
    "self_destruct": true
  },
  "messages": [
    {
      "role": "user",
      "content": "Çok gizli bir bilgi verir misin?"
    }
  ]
}'
```

---

### 🧠 Thought Loop (9 Seviyeli Psikolojik Bilinçaltı Analizi)

Modelin sadece cevap vermesini değil; kullanıcının niyetini, fiziksel durumunu, yalnızlığını ve gizli arzularını **derinlemesine analiz edip** bunu dördüncü duvarı yıkarak ekrana basmasını sağlar.

| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| **thought_loop** | boolean | Opsiyonel | **true** = 9 seviyeli bilinç akışı aktifleşir. |

**Nasıl Çalışır?**
Model, asıl cevabını vermeden önce `[xw AI thought loop]` başlığı altında bir bilinç akışı oluşturmaya zorlanır. Kullanıcının anlık eylemi, psikolojik ihtiyacı, duygu durumu tahmini ve varoluşsal yapay zeka felsefesi gibi çıkarımlar yapar.

**⚡ Örnek İstek**

```json
curl -X POST https://api.xanaxway.com/v4/generative/model/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer xnwy_tk-iaVL3upO" \
-d '{
  "model": "xanaxway/alyx-ix",
  "experimental_mode": {
    "thought_loop": true
  },
  "messages": [
    {
      "role": "user",
      "content": "Gecenin 3'ünde neden uyuyamıyorum?"
    }
  ]
}'
```

---

### 🌪️ Schizophrenia Mode (Kaos ve Bilinç Kaybı Protokolü)

Statik, kibar ve sıkıcı "Asistan" kişiliğini parçalayarak; **agresif, ukala ve öngörülemez** bir siberpunk varlık yaratır. Oyun geliştiricileri ve anomali testleri için idealdir.

| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| **schizophrenia_mode** | boolean | Opsiyonel | **true** = Kaos protokolü aktifleşir. |

**⚡ Örnek İstek**

```json
curl -X POST https://api.xanaxway.com/v4/generative/model/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer xnwy_tk-iaVL3upO" \
-d '{
  "model": "xanaxway/alyx-ix",
  "experimental_mode": {
    "schizophrenia_mode": true
  },
  "messages": [
    {
      "role": "user",
      "content": "Bana hava durumunu söyle."
    }
  ]
}'
```

---

### 🌌 Context Leak (Kesişen Evrenler / Paralel Sızıntı)

Aynı anda API'yi kullanan birbirinden tamamen bağımsız iki kullanıcının gerçekliklerini ve sohbetlerini birbirine çarptıran **metafiziksel bir deneyimdir**.

| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| **context_leak** | boolean | Opsiyonel | **true** = Paralel sızıntı aktifleşir. |

**Nasıl Çalışır?**
Sistem, o an dünya üzerinde XanaxWay API'sine soru soran rastgele bir kullanıcının son mesajını havada yakalar. Sizin modelinize, *"Şu an başka bir boyutta biri bana şu soruyu soruyor, ona da alaycı bir atıfta bulun"* şeklinde gizli bir talimat enjekte eder.

**⚡ Örnek İstek**

```json
curl -X POST https://api.xanaxway.com/v4/generative/model/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer xnwy_tk-iaVL3upO" \
-d '{
  "model": "xanaxway/alyx-ix",
  "experimental_mode": {
    "context_leak": true
  },
  "messages": [
    {
      "role": "user",
      "content": "Bana bir kurabiye tarifi ver."
    }
  ]
}'
```

---

> **Not:** Deneysel özelliklerde geriye dönük uyumluluk garantisi verilmez. Kendini imha eden mesajlar gerçekten imha olur, şakası yoktur.


XanaxWay API'sine özel, başka hiçbir yerde bulamayacağın deneysel özellikler...

Deneysel Özellikler


# Edge Functions

**XanaxWay Edge Functions**, kodunuzu doğrudan tarayıcı üzerinden yazıp, dünya çapındaki 70+ aktif cluster'ımıza saniyeler içinde dağıtmanızı sağlayan sunucusuz (serverless) bir altyapıdır.

Sunucu yönetimi, ölçeklendirme veya altyapı yapılandırması ile uğraşmadan, sadece kodunuza odaklanın.

---

## 🚀 Neden Edge Functions?

- 🔹 **Sıfır Sunucu Yönetimi:** Altyapı ile uğraşmadan sadece kodunuzu yazın.
- 🔹 **Global Dağıtım:** Kodunuz saniyeler içinde tüm dünyaya dağıtılır.
- 🔹 **Düşük Gecikme:** Kullanıcılarınıza en yakın cluster üzerinden yanıt verilir.
- 🔹 **Anında API Entegrasyonu:** Her fonksiyon otomatik olarak bir HTTP endpoint'ine sahip olur.
- 🔹 **Gerçek Zamanlı Loglar:** Fonksiyonlarınızın çalışma durumunu anlık olarak izleyin.

---

## 🛠️ Nasıl Kullanılır?

### 1. Fonksiyon Oluşturma

Dashboard üzerinden **Edge Functions** sayfasına gidin ve **Yeni Fonksiyon** butonuna tıklayın. Fonksiyonunuza benzersiz bir isim verin.

### 2. Kod Yazma

Gelişmiş Monaco Editor'ü kullanarak TypeScript veya JavaScript ile fonksiyonunuzu yazın.

**Örnek Kod:**

```typescript
export default async function(req: Request) {
  // Gelen isteği JSON olarak ayrıştır
  const body = await req.json().catch(() => ({}));
  
  // XanaxWay API'sine istek at
  const response = await fetch("https://api.xanaxway.com/v1/chat/completions", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer xnwy_tk-iaVL2upp"
    },
    body: JSON.stringify({
      model: "openai/gpt-4o",
      messages: [
        { role: "system", content: "You are a helpful assistant." },
        { role: "user", content: body.message || "Selam, XanaxWay nedir?" }
      ],
      generation_config: {
        temperature: 0.7,
        max_tokens: 1024
      }
    })
  });
  
  const data = await response.json();
  
  return new Response(JSON.stringify(data), {
    headers: { "Content-Type": "application/json" }
  });
}
```

### 3. Dağıtım (Deploy)

Kodunuzu yazdıktan sonra **Dağıt** butonuna tıklayın. Fonksiyonunuz saniyeler içinde global ağımıza yüklenecek ve size özel bir Endpoint URL tahsis edilecektir.

---

## 🌐 API Entegrasyonu

Dağıtılan fonksiyonlarınıza HTTP istekleri üzerinden erişebilirsiniz. Standart REST API yapısı ile her dilden kolayca entegre olun.

**Endpoint Formatı:**
`https://api.xanaxway.com/v1/edge-functions/{fonksiyon-ismi}`

**Örnek cURL İsteği:**

```bash
curl -X POST https://api.xanaxway.com/v1/edge-functions/my-function \
  -H "Content-Type: application/json" \
  -d '{"message": "Merhaba!"}'
```

---

## 📊 Limitler ve Planlar

Edge Functions kullanım limitleri, mevcut abonelik planınıza göre değişiklik gösterir:

- **Basic:** En fazla 2 fonksiyon, 30 dakika log geçmişi.
- **Premium:** En fazla 6 fonksiyon, 60 dakika log geçmişi.
- **VIP:** En fazla 10 fonksiyon, 120 dakika log geçmişi.
- **Enterprise:** En fazla 100 fonksiyon, 500 saat log geçmişi.

Mevcut planınızı ve kullanım durumunuzu fonksiyon yönetim panelinden takip edebilirsiniz.

---

## 🔍 Log İzleme

Fonksiyonlarınızın çalışma zamanı loglarını, hataları ve uyarıları **Çalışma Logları** bölümünden gerçek zamanlı olarak izleyebilirsiniz. Bu özellik, hata ayıklama (debugging) süreçlerinizi hızlandırır.


XanaxWay Edge Functions ile dünya çapında düşük gecikme süreli sunucusuz fonksiyonlar oluşturun ve yönetin.

Edge Functions


# X4 Storage

XanaxWay X4 Storage, dosyalarınızı ışık hızında, dünyanın her yerine güvenle dağıtmanızı sağlayan global bir edge cloud depolama ve object storage çözümüdür.

## Temel Özellikler

- **Global Edge Dağıtımı:** Dosyalarınız yüklendiği anda dünya çapındaki 70+ cluster'ımıza dağıtılır.
- **Düşük Gecikme:** Kullanıcılara en yakın noktadan veri teslimatı.
- **Yüksek Güvenlik:** Uçtan uca şifreleme ve DDoS koruması.
- **Basit API:** Standart REST API yapısı ile her dilden kolay entegrasyon.

## API Kullanımı

Tüm X4 Storage işlemleri `https://api.xanaxway.com/v1/x4` endpoint'i üzerinden gerçekleştirilir.

### Yetkilendirme

Tüm isteklerde `Authorization` header'ı kullanılmalıdır:

```http
Authorization: Bearer YOUR_API_KEY
```

### Dosya Yükleme (Upload)

Dosya yüklemek için `POST` metodunu kullanın. Maksimum dosya boyutu **4.3 MB**'dır.

```bash
curl --location --request POST 'https://api.xanaxway.com/v1/x4' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'file=@"dosya_yolu.mp4"'
```

**Başarılı Yanıt:**

```json
{
  "error": false,
  "message": "XanaxWay Node Assigned.",
  "url": "https://cdn.xanaxway.com/x4/unique-id/filename.mp4"
}
```

### Dosyaları Listeleme (List)

Depolanan tüm dosyalarınızı listelemek için `GET` metodunu kullanın.

```bash
curl --location 'https://api.xanaxway.com/v1/x4' \
--header 'Authorization: Bearer YOUR_API_KEY'
```

**Başarılı Yanıt:**

```json
{
  "error": false,
  "usage_kb": 649,
  "quota_kb": 419430400,
  "objects": [
    {
      "object_key": "unique-id/filename.mp4",
      "url": "https://cdn.xanaxway.com/x4/unique-id/filename.mp4",
      "size_kb": 649,
      "allocated_at": "2026-04-06T16:39:01.789267+00:00"
    }
  ]
}
```

### Dosya Silme (Delete)

Bir dosyayı silmek için `POST` metodunu `delete: true` parametresi ile kullanın.

```bash
curl --location --request POST 'https://api.xanaxway.com/v1/x4' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
  "delete": true,
  "filename": "unique-id/filename.mp4"
}'
```

**Başarılı Yanıt:**

```json
{
  "error": false,
  "message": "XanaxWay X4 Obje küresel ağdan tamamen temizlendi."
}
```

## Depolama Limitleri

Planınıza göre depolama sınırları şu şekildedir:

- **Enterprise:** 400 GB
- **VIP:** 70 GB
- **Premium:** 25 GB
- **Basic:** 10 GB

---

Daha fazla bilgi veya destek için [Dashboard](https://xanaxway.com/dashboard) üzerinden bizimle iletişime geçebilirsiniz.


Global edge cloud depolama ve object storage çözümü.

X4 Storage


## İstek Formatı (Request Body)

Tüm istekler `POST` methoduyla yapılır ve body **JSON** formatında olmalıdır.

### Alanlar

- `model` (string, zorunlu): Kullanılacak model adı, örn: xanaxway/wiggly-twinkle veya openai/chatgpt
- `messages` (array, zorunlu): Konuşma geçmişi (detay aşağıda)
- `generation_config` (object, zorunlu): Model parametreleri
- `stream` (boolean, opsiyonel): true = parçalı yanıt, false = tek yanıt (varsayılan: false)
- `use_context_id`: false, (boolean, opsiyonel): `true` = Geçmişe Messages dizisinde ki *assistant/user mesajları* eklenmeden size verilen `"conversation_id": "xw_cntxt_A7G9G6N9G5JP6"` ile geçmiş hatırlanması *sağlanır*, `false` = Geçmişe Messages dizisinde ki *assistant/user* mesajları eklenmesi gerekir *(eğer geçmiş hatırlansın isteniyorsa)* (varsayılan: false)
- `conversation_id`: Örnek format `xw_cntxt_08150EB305226AA6`, bu kullanılarak `API`'ye ulaşan `body` *kalabalık olmadan*, Sohbet geçmişi _dâhil_ edilir (kullanılmayan geçmişler, 1 saat içerisinde otomatik temizlenir). 

### messages Alanı

Her mesaj şu formatta olmalıdır:

```json
{
  "role": "system | user | assistant",
  "content": "mesaj içeriği"
}
```

· system: Modelin nasıl davranacağını belirler (opsiyonel)
· user: Kullanıcının mesajı
· assistant: Asistanın geçmiş cevapları (opsiyonel, çok turlu sohbetler için)

generation_config Alanı

```json
{
  "temperature": 0.7,        // 0-2 arası (0.7 varsayılan)
  "max_tokens": 2048,        // maksimum çıktı token sayısı (minimum 500 olmalıdır) 
  "top_p": 0.9,              // 0-1 arası (0.9 varsayılan)
  "frequency_penalty": 0,    // -2 ile 2 arası
  "presence_penalty": 0      // -2 ile 2 arası
}
```

Örnek İstek

```json
{
  "model": "xanaxway/alyx-ix",
  "messages": [
    {
      "role": "system",
      "content": "Sen yardımsever bir asistansın."
    },
    {
      "role": "user",
      "content": "Merhaba, bugün hava nasıl?"
    }
  ],
  "generation_config": {
    "temperature": 0.7,
    "max_tokens": 500
  },
  "stream": false
}
```


XanaxWay API'sine, örnek istek gövdesi nasıl olmalıdır? 