Gerçek harita üzerinde AI sohbet

Sıradan bir LLM, Satürn hakkındaki bir soruyu burç hakkında hafızasında kalanlarla yanıtlar. POST /v1/ai/chat ise az önce hesapladığımız haritadan yanıt verir: konum, ev, orb’larıyla açılar ve önümüzdeki altı ayın transit pencereleri. Fark ilk yanıttan görünür: “Oğlak’taki Satürn disiplin demektir” değil, “Satürn Oğlak 25.2°‘de retrograd, 5. ev, Ay ile kavuşum, orb 1.7°”.

Anahtarsız deneyin

Demo tek bir sabit harita üzerinde çalışır, adres başına günde 5 soru, ücretli endpoint’le aynı sistem prompt’u. Anahtar gerekmez.

Model ne görür

Demo bir context alanı döndürür: bu, prompt’a giden bloğun tamamıdır. İşte demodaki harita için 2 Eylül 2026 itibarıyla hâli (transitler her istekte yeniden hesaplanır, bu yüzden yarın pencere listesi farklı olacaktır):

## Natal Chart
- Sun: Taurus 24.4°, house 9
- Moon: Capricorn 26.9°, house 5
- Saturn: Capricorn 25.2° (R), house 5
- Ascendant: Virgo 20.0°
- Midheaven: Gemini 17.1°

Aspects (computed, use these instead of deriving your own):
- Sun Trine Saturn, orb 0.9°, applying
- Moon Conjunction Saturn, orb 1.7°
- Venus Square Neptune, orb 1.6°

## Transits, computed. Today is 2026-09-02; sampled monthly to 2027-03-01
(These are the only windows that exist. Report a month, not a day.)
- transiting Saturn Conjunction natal Venus: in orb on 2026-09-02, 2026-10-01, 2026-11-01, 2026-12-01, 2027-01-01, 2027-02-01, 2027-03-01 (closest 2027-03-01, orb 0.3°)
- transiting Jupiter Square natal Sun: in orb on 2026-10-01, 2026-11-01, 2026-12-01, 2027-01-01, 2027-02-01, 2027-03-01 (closest 2026-11-01, orb 0.0°)

Blok kısaltılmıştır: tam sürümde 12 gezegen ve açı noktası, en fazla 20 majör natal açı ve en fazla 12 transit penceresi vardır. Ücretli endpoint için aynı blok, sizin gönderdiğiniz haritadan oluşturulur.

Neye tarih verir, neye vermez

Sistem prompt’umuz, yukarıdaki blokta bulunan transitler için ay adı vermeye izin verir ve bir olaya tarih vermeyi yasaklar. “Ne zaman evleneceğim” sorusuna endpoint şöyle yanıt verir (2 Eylül 2026 tarihli gerçek bir yanıttan bir parça):

Transit Satürn natal Venüs’ünüzle bir kavuşum oluşturuyor. Bu transit birkaç ay boyunca etkin olacak: 2026’nın eylül, ekim, kasım ve aralık aylarında, ayrıca 2027’nin ocak, şubat ve mart aylarında; en dar orb’una mart 2027’de ulaşacak.

Buradaki tarihler uydurma değildir: bağlam bloğundaki transiting Saturn Conjunction natal Venus satırıdır. Yanıtta bir evlilik tarihi yoktur ve olmayacaktır.

Not

Yanıttan sizin sorumlu olduğunuz bir ürün geliştiriyorsanız, bu sınır sizin lehinize çalışır: arayüzünüzde başka birinin modelinden gelen tarihli bir olay tahmini bizim değil, sizin riskinizdir. Ay yerine kesin bir pencere mi gerekiyor: /v1/transit-calendar.

Personalar

persona verileri değil, sesi değiştirir. Değer kapalı bir listedir, çünkü istek gövdesindeki dize sistem prompt’una girer.

persona	Ses
astrologer	varsayılan, endpoint’in parametre eklenmeden önceki yanıt biçimi
plain	persona, selamlama ve imza olmadan
coach	destek ve bununla ne yapılacağı
teacher	tekniği adlandırır ve terimleri açıklar

“Satürn’ümü tek bir paragrafta anlat” sorusu, persona: "coach":

Satürn’ünüz kendi yönettiği burç olan Oğlak’ta bulunuyor, üstelik retrograd ve 5. evde yer alıyor. Bu, özellikle kendini ifade etme, yaratıcılık, romantizm ve çocuklarla ilgili alanlarda yapıya, disipline ve ustalığa yönelik derinlere kök salmış bir isteğe işaret ediyor.

persona: "teacher":

Doğum haritanızda Satürn, 5. evde Oğlak 25.2° (R) konumunda bulunuyor. Satürn, disiplin, sorumluluk, yapı ve sınırlamaların gezegenidir; ustalığa ulaşmaya çalıştığımız ve hayat derslerimizle karşılaştığımız alanlara işaret eder.

Bilinmeyen bir persona sessiz bir varsayılan değil, izin verilen değerlerin listesiyle birlikte 400 INVALID_INPUT döndürür.

İstek ve yanıt

cURL

curl -X POST https://api.astroway.info/v1/ai/chat \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Що означає моє положення Сатурна?",
    "chart": {
      "date": "1990-05-15",
      "time": "14:30:00",
      "timezoneOffset": 3,
      "latitude": 50.45,
      "longitude": 30.52
    },
    "persona": "plain",
    "language": "uk"
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/ai/chat', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    message: 'Що означає моє положення Сатурна?',
    chart: { date: '1990-05-15', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
    persona: 'plain',
    language: 'uk',
  }),
});
const { data } = await r.json();
console.log(data.reply);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/ai/chat',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'message': 'Що означає моє положення Сатурна?',
        'chart': {'date': '1990-05-15', 'time': '14:30:00', 'timezoneOffset': 3, 'latitude': 50.45, 'longitude': 30.52},
        'persona': 'plain',
        'language': 'uk',
    },
)
data = r.json()['data']
print(data['reply'])

PHP

<?php
use GuzzleHttp\Client;

$aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $aw->post('ai/chat', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'message' => 'Що означає моє положення Сатурна?',
        'chart' => ['date' => '1990-05-15', 'time' => '14:30:00', 'timezoneOffset' => 3, 'latitude' => 50.45, 'longitude' => 30.52],
        'persona' => 'plain',
        'language' => 'uk',
    ],
]);
$data = json_decode($r->getBody(), true)['data'];
echo $data['reply'];

Yanıt:

{
  "ok": true,
  "data": {
    "reply": "Ваш Сатурн знаходиться у знаку Козерога, у 5 домі, і є ретроградним.\n\n**Сатурн у Козерозі** означає, що Сатурн перебуває у своєму домі, де його енергії найсильніші. […] **Місяць у поєднанні з Сатурном (орб 1.7°)**: Це поєднання в Козерозі, у 5 домі, посилює серйозність ваших емоцій та потребу в безпеці.",
    "disclaimer": "Цей текст згенерований ШІ для розваги та саморефлексії. Не є медичною, юридичною чи фінансовою порадою.",
    "model": "gemini-2.5-flash",
    "language": "uk",
    "tokens": { "input": 1822, "output": 758 },
    "duration_ms": 6806,
    "persona": "plain"
  }
}

Burada reply kısaltılmıştır, diğer alanlar olduğu gibidir. model, yanıt veren sağlayıcıdır: zincir kendiliğinden geçiş yapar ve kendi hesabınızın kimin token’larını saydığını görebilmeniz için adı yanıtta yer alır. Model token tavanına dayanırsa, yanıt kelimenin ortasında kesilmez, son tamamlanmış cümleye kadar kırpılır ve truncated: true eklenir.

Harita isteğe bağlıdır

chart olmadan bu sıradan bir astroloji sohbetidir: bağlam yoktur, fiyat aynıdır. chart ile belirli bir kişi hakkında yanıt verir. En fazla 10 turluk history’yi istemci gönderir: bizim tarafımızda oturum yoktur, bu yüzden her tur kendi kendine yeterlidir ve süreçler arasında taşınabilir.

Fiyat ve limitler

Tur başına fiyat	100 kredi
Kendi sağlayıcı anahtarınız (BYOK)	tur başına 5 kredi, token’lar sizin
Free plan	plan kısıtlaması olmadan, ayda 10 000 kredi sınırı içinde çağırır
Sandbox anahtarları aw_test_*	402, çünkü sandbox kredi harcamaz, ama model para harcar
Aynı gövdenin tekrarı	önbellekten, x-cache: HIT, x-credits-used: 0
message	en fazla 2000 karakter, history en fazla 10 tur
Diller	21, language parametresi

Dikkat

Bu endpoint’te şimdilik streaming yok: yanıt bütün olarak gelir. POST /v1/mcp/streaming SSE döndürür, ama o da tam yanıtı bekler ve cümlelere böler, bu yüzden ilk token’ı daha erken görmezsiniz.

Tam referans İstek şeması, hata kodları, örnekler

Kendi sağlayıcı anahtarınız X-Provider, X-Provider-Key, tur başına 5 kredi

Planlar Her planda ayda kaç tur

AI ajanları ve MCP Aynı sohbet bir ajan aracı olarak