AETHER · API Referansı

Açık sözleşmeler.Öngörülebilir entegrasyon.

Aether API'nin kimlik doğrulamasını, endpoint'lerini, zorunlu alanlarını, yanıtlarını ve hata modelini inceleyin.

Referans

İstekten yanıta gereken tüm alanlar.

Bu sözleşme canlı API ile uyumludur. API anahtarınızı sunucuda saklayın ve her işlemde benzersiz Idempotency-Key gönderin.

Kimlik doğrulama

API anahtarını Authorization başlığında Bearer token olarak gönderin.

POST /v1/compress

Context'i optimize eder; data.compressed ve ayrıntılı usage bilgisi döndürür.

POST /v1/generate

Context optimizasyonu ile seçilen model üzerinden üretimi tek çağrıda birleştirir.

Hata modeli

HTTP durum kodu, makine tarafından okunabilir hata kodu, mesaj ve requestId alanları.

Hızlı Başlangıç

Tek bir çağrıyla başlayın.

API anahtarınızı oluşturun, girdinizi gönderin ve optimize edilmiş context'i mevcut model sağlayıcınızla kullanın.

Kurulum adımlarını aç →

POST https://api.aether.tr/v1/compress
Authorization: Bearer <API_KEY>
Idempotency-Key: <UNIQUE_OPERATION_KEY>
Content-Type: application/json

{
  "context": [{ "role": "user", "content": "..." }],
  "query": "Current user query",
  "level": "auto"
}

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