AETHER · Dokümantasyon

Aether'i anlayın,doğru entegrasyona hazırlanın.

Temel kavramlardan üretim politikalarına kadar Aether Compress entegrasyonu için ihtiyaç duyacağınız teknik rehberlere ulaşın.

Quick Start API referansı

Doküman Haritası

İlk çağrıdan üretim optimizasyonuna.

Kavramları öğrenin, örnek bir entegrasyon kurun ve uygulamanıza uygun kalite-maliyet politikasını belirleyin.

Temel kavramlar

Context, sorgu, optimizasyon modu ve kullanım metriklerinin Aether içindeki anlamı.

Quick Start

API anahtarı, ilk Compress isteği ve optimize sonucu model çağrısında kullanma.

API referansı

Endpoint'ler, alan tipleri, yanıt şemaları, hata kodları ve limitler.

Üretim rehberi

Timeout, tekrar deneme, loglama, veri güvenliği ve kademeli trafik önerileri.

Canlı HTTP Sözleşmesi

Compress ve Generate entegrasyonu

Tüm istekler https://api.aether.tr adresine sunucu tarafından gönderilir. API anahtarını tarayıcı veya mobil uygulama koduna koymayın.

Authorization

Bearer <API_KEY> zorunludur.

Idempotency-Key

Her yeni işlem için benzersiz, 8-120 karakterlik değer gönderin.

Content-Type

application/json zorunludur.

POST /v1/compress

Yalnız bağlam optimizasyonu

context string veya en fazla 500 adet role/content mesajı olabilir. query isteğe bağlıdır. level ile mode aynı istekte birlikte gönderilmez.

curl -X POST "https://api.aether.tr/v1/compress" \
  -H "Authorization: Bearer $AETHER_API_KEY" \
  -H "Idempotency-Key: compress-$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "context": "Uzun LLM bağlamınız...",
    "query": "Yanıtlanacak güncel soru",
    "level": "auto"
  }'

{
  "success": true,
  "requestId": "request-uuid",
  "data": { "compressed": "Optimize edilmiş bağlam..." },
  "compression": { "status": "compressed" },
  "usage": {
    "request": {
      "inputTokens": 1240,
      "compressedTokens": 690,
      "savedTokens": 550,
      "reductionPct": 44.35
    },
    "monthly": {
      "limitTokens": 10000000,
      "usedTokens": 1240,
      "remainingTokens": 9998760,
      "resetsAt": "2026-10-01T00:00:00.000Z"
    }
  }
}

POST /v1/generate

Sıkıştırma ve model yanıtı

Önce müşteri panelindeki Entegrasyonlar bölümünde OpenAI, Anthropic veya Gemini anahtarınızı doğrulayın. provider değeri openai, claude veya gemini; model ise sağlayıcının kabul ettiği gerçek model kimliği olmalıdır.

curl -X POST "https://api.aether.tr/v1/generate" \
  -H "Authorization: Bearer $AETHER_API_KEY" \
  -H "Idempotency-Key: generate-$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "context": "Uzun LLM bağlamınız...",
    "query": "Nihai yanıtı oluştur.",
    "provider": "gemini",
    "model": "<GEMINI_MODEL_ID>",
    "level": "auto",
    "maxOutputTokens": 1024
  }'

{
  "success": true,
  "requestId": "request-uuid",
  "data": { "answer": "Sağlayıcının nihai yanıtı..." },
  "compression": { "status": "compressed" },
  "usage": {
    "request": {
      "inputTokens": 1240,
      "compressedTokens": 690,
      "savedTokens": 550,
      "reductionPct": 44.35
    },
    "provider": {
      "provider": "gemini",
      "model": "<GEMINI_MODEL_ID>",
      "inputTokens": 720,
      "outputTokens": 180,
      "totalTokens": 900
    }
  }
}

Alanlar ve limitler

level: low, standard, ultra, auto
mode: conservative, balanced, aggressive
Generate için query, provider ve model zorunludur.
maxOutputTokens: 1-32768; varsayılan 1024.
Her yanıttaki requestId değerini uygulama logunuza kaydedin.

Tekrar deneme ve hatalar

Timeout veya geçici 5xx hatasında aynı body ve aynı Idempotency-Key ile tekrar deneyin. 4xx hatasını düzeltmeden yeniden göndermeyin. Aynı anahtar farklı body ile kullanılırsa 409 döner.

{
  "success": false,
  "requestId": "request-uuid",
  "error": {
    "code": "MACHINE_READABLE_CODE",
    "message": "Güvenli hata mesajı"
  }
}

Daha küçük context. Daha kontrollü AI maliyeti.

Aether Compress'i mevcut LLM akışınıza eklemek için ekibimizle iletişime geçin.

İletişime geçin