Yapay zekâ özeti

Her hesaplama onlarca yorum metni döndürür. Yapay zekâ özeti, bunların en önemlilerini horoskopun o kişi için gerçekte ne anlama geldiğini anlatan birkaç cümleye dönüştürür — sinastri ve kompozit için ise iki kişinin birlikteliği hakkında.

Özetler hesaplama sırasında oluşturulmaz. Hesaplama sana imzalı bir bağlantı verir; modeli çalıştıran şey yalnızca o bağlantıyı açmandır.

Gerekli modül

ai:summary modülünü gerektirir; Premium ve Deluxe paketlerine dahildir. Ayrı olarak satılmaz.

Ayrıca özetlediğin horoskop türünün yorum metinlerine de ihtiyacın var (örneğin natal:texts) — metin yoksa özetlenecek bir şey de yoktur.

Nasıl çalışır

Her zamanki gibi bir hesaplama uç noktasını çağırırsın.
Yanıt, imzalı bir URL içeren bir summary nesnesi taşır.
Özeti istediğinde — ve istersen — o URL'yi açarsın.
ve 2. adımda hiçbir şey hesaplanmaz, saklanmaz veya ücretlendirilmez. Bu bilinçlidir: bir horoskop çağrısı, çağrıyı yapanların çoğunun hiç kullanmadığı bir özellik için ödeme yapmamalıdır.

Özet bağlantısı

json

{
    "data": {
        "points": { "...": "..." },
        "aspects": [],
        "chart": { "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..." },
        "summary": {
            "url": "https://api.astroapi.cloud/api/calc/natal/summary?t=eyJ0Ijoi...&expires=1793000000&sig=Ab3...",
            "method": "GET",
            "cost": 10,
            "expiresAt": "2026-08-30T10:00:00Z"
        }
    }
}

Alan	Açıklama
`url`	Özeti döndüren imzalı URL. Tüm isteği taşır, bu yüzden gövde gerekmez.
`method`	Her zaman `GET`.
`cost`	Özet üretildiğinde ücretlendirilen API isteği sayısı. Önbellekten gelen bir özet 1 sayılır.
`expiresAt`	Bağlantı 7 gün çalışır. Yenisi için hesaplamayı tekrar çalıştır.

summary nesnesi yalnızca aboneliğin modülü içeriyorsa bulunur. Yoksa paketini kontrol et.

Yalnızca haritayı değil, bağlantıyı da sakla

Bağlantı 7 gün sonra geçersiz olur ve tam olarak bir harita için imzalanmıştır. Düzenlenemez: URL'deki doğum verilerini, horoskop türünü veya organizasyonu değiştirmek imzayı geçersiz kılar.

Özeti alma

bash

curl "https://api.astroapi.cloud/api/calc/natal/summary?t=eyJ0Ijoi...&expires=1793000000&sig=Ab3..." \
  -H "X-Api-Key: your-api-key"

İmza sayesinde API anahtarı isteğe bağlıdır; bağlantı, başlık gönderemeyen bir tarayıcıdan veya gömülü bir bileşenden de çalışır. Anahtar gönderirsen, bağlantının verildiği organizasyona ait olmalıdır.

Bu biraz sürer

Özet üretmek hesaplamayı yeniden çalıştırır, metinleri getirir ve bir dil modelini çağırır. Birkaç saniye bekle. Daha önce üretilmiş bir özet anında döner.

Yanıt

json

{
    "data": {
        "horoscopeType": "natal",
        "language": "tr",
        "summary": "Sen temkinden değil görünürlükten başlıyorsun: onuncu evdeki Aslan burcu Güneşi, işini ve itibarını kendini anlama biçiminin merkezine yerleştiriyor…",
        "cached": false,
        "generatedAt": "2026-08-23T10:15:22Z",
        "model": "@cf/qwen/qwen3-30b-a3b-fp8",
        "highlights": [
            { "kind": "point", "label": "Sun in Leo in house 10" },
            { "kind": "point", "label": "Moon in Taurus in house 7" },
            { "kind": "aspect", "label": "Sun square Saturn (orb 0.4°)" }
        ]
    }
}

Alan	Açıklama
`summary`	Üretilen metin, 4 ila 6 cümle.
`cached`	Metin önbellekten geldiyse `true`. Önbellekten gelen özetler 10 yerine 1 istek sayılır.
`highlights`	Özetin dayandığı yerleşimler, en güçlüden başlayarak.
`model`	Metni yazan model.

Desteklenen horoskop türleri

Tür	Uç nokta	Özetin konusu
`natal`	`/api/calc/natal/summary`	Bu kişinin kim olduğu
`synastry`	`/api/calc/synastry/summary`	Bu iki kişinin birbirine ne yaptığı
`composite`	`/api/calc/composite/summary`	Birlikte kurdukları ilişki
`transit`	`/api/calc/transit/summary`	Yaklaşan dönem
`solar`	`/api/calc/solar-return/summary`	Gelecek yıl
`lunar`	`/api/calc/lunar-return/summary`	Gelecek ay
`progressions`	`/api/calc/progressions/summary`	Bu kişinin içinde bulunduğu yaşam evresi

Özete ne girer

Tam bir doğum haritası 40'tan fazla yorum metni üretir. Hepsini bir modele vermek okuma değil liste üretir — ve çok daha pahalıya mal olur. Bunun yerine yerleşimler puanlanır ve yalnızca en güçlüleri kalır:

Yerleşimler — ışıklar ve Yükselen en ağır basar, ardından haritanın yöneticisi, kişisel gezegenler ve köşe evlerdeki her şey.
Açılar — kesinliğe (orbun o açının azamisine göre ne kadar dar olduğuna), açının ne kadar majör olduğuna ve iki ucun ne kadar kişisel olduğuna göre puanlanır. Kesin bir Güneş–Satürn karesi, geniş bir Neptün–Plüton sekstiline açık ara fark atar.
Sinastri yalnızca çapraz açıları tutar, her iki yönde de, kimin gezegeninin kimin haritasına etki ettiği belirtilerek.
Transitler ayrıca transit gezegenlerin geçtiği evleri de içerir.

Puanlama belirlenimlidir: aynı harita her zaman aynı seçimi üretir, ve sonucu önbelleğe alınabilir kılan da tam olarak budur.

Model yalnızca kendisine verilen metinleri kullanabilir. Yerleşim, tarih veya tavsiye uydurmaz — dolayısıyla bir özet, Content Editor ile kendi düzenlediklerin dahil, senin kendi yorum metinlerini yansıtır.

Dil

Özet, hesaplamanın dilinde yazılır. Hesaplama isteğinde language gönder; bağlantı bunu taşır:

bash

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": { "longitude": 4.89, "latitude": 52.37, "timezone": "Europe/Amsterdam" },
    "language": "tr",
    "includeText": true
  }'

Yorum metinleri zaten yerelleştirilmiştir ve modele aynı dilde yazması talimatı verilir.

Maliyeti

Durum	API isteği
Yanıtında özet bağlantısı bulunan hesaplama	1 (değişmedi)
Bağlantı açıldı, özet üretildi	10
Bağlantı açıldı, özet zaten önbellekte	1
İstek başarısız oldu (403, 422, süresi dolmuş bağlantı)	0

Üretilen özetler harita, dil ve prompt sürümü başına 30 gün önbellekte tutulur; aynı bağlantıyı tekrar tekrar açmak ucuzdur.

X-Quota-Limit, X-Quota-Remaining ve X-Quota-Reset yanıt başlıkları ağırlıklı maliyeti yansıtır; kontrol panelindeki kullanım raporu da öyle.

Hatalar

Durum	Anlamı
`400`	Bağlantı bozuk ya da token bu horoskop türüne ait değil.
`401`	İmza geçersiz veya bağlantının süresi dolmuş.
`403`	Aboneliğinde `ai:summary` ya da bu türün yorum metinleri yok, veya bağlantı başka bir organizasyona ait.
`409`	Bu harita için zaten bir özet üretiliyor. Birkaç saniye sonra tekrar dene — böylece aynı metin için iki kez ödeme yapmazsın.
`422`	Bu harita için yorum metni bulunmuyor, dolayısıyla özetlenecek bir şey yok.

Sonraki adımlar

İçerik ve yorumlar — bir özetin dayandığı metinler
Modüller — paketinin neleri içerdiği
Hız sınırları — kotalar ve ağırlıklı istekler

Yapay zekâ özeti ​

Nasıl çalışır ​

Özet bağlantısı ​

Özeti alma ​

Yanıt ​

Desteklenen horoskop türleri ​

Özete ne girer ​

Dil ​

Maliyeti ​

Hatalar ​

Sonraki adımlar ​