Chat AI di atas bagan nyata

LLM biasa menjawab pertanyaan tentang Saturnus dari ingatannya tentang zodiak. POST /v1/ai/chat menjawab dari bagan yang baru saja kami hitung: posisi, rumah, aspek dengan orb, dan jendela transit untuk setengah tahun ke depan. Perbedaannya terlihat sejak jawaban pertama: bukan “Saturnus di Capricorn berarti disiplin”, melainkan “Saturnus di Capricorn 25.2° retrograde, rumah 5, konjungsi dengan Bulan orb 1.7°”.

Coba tanpa kunci

Demo berjalan pada satu bagan tetap, 5 pertanyaan per alamat per hari, dengan system prompt yang sama seperti endpoint berbayar. Kunci tidak diperlukan.

Apa yang dilihat model

Demo mengembalikan field context: ini seluruh blok yang masuk ke prompt. Berikut blok tersebut per 2 September 2026 untuk bagan demo (transit dihitung ulang di setiap permintaan, jadi daftar jendelanya besok akan berbeda):

## 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 ini disingkat: versi lengkapnya berisi 12 planet dan sudut, hingga 20 aspek natal mayor, dan hingga 12 jendela transit. Blok yang sama disusun untuk endpoint berbayar dari bagan yang kamu kirim.

Apa yang diberi tanggal dan apa yang tidak

System prompt kami mengizinkan penyebutan bulan untuk transit yang ada di blok di atas, dan melarang memberi tanggal pada suatu peristiwa. Untuk pertanyaan “kapan aku akan menikah” endpoint menjawab seperti ini (cuplikan jawaban asli dari 2 September 2026, diterjemahkan):

Saturnus transit membentuk konjungsi dengan Venus natal Anda. Transit ini akan aktif selama beberapa bulan: pada September, Oktober, November, Desember 2026, serta pada Januari, Februari, dan Maret 2027, mencapai orb terdekatnya pada Maret 2027.

Tanggal di sini tidak dikarang: itu adalah baris transiting Saturn Conjunction natal Venus dari blok konteks. Tanggal pernikahan tidak ada di jawaban dan tidak akan ada.

Catatan

Jika kamu membangun produk tempat kamu yang bertanggung jawab atas jawabannya, batas ini bekerja untukmu: prediksi peristiwa bertanggal dari model pihak lain di antarmukamu adalah risikomu, bukan risiko kami. Butuh jendela yang tepat, bukan bulan: /v1/transit-calendar.

Persona

persona mengganti suara, bukan data. Nilainya daftar tertutup, karena string dari body permintaan masuk ke system prompt.

persona	Suara
astrologer	default, seperti jawaban endpoint sebelum parameter ini ada
plain	tanpa persona, salam, dan tanda tangan
coach	dukungan dan apa yang bisa dilakukan dengan hal itu
teacher	menyebut tekniknya dan menjelaskan istilah

Pertanyaan “Jelaskan Saturnus-ku dalam satu paragraf”, persona: "coach":

Saturnus Anda berada di zodiak Capricorn, yang merupakan domisilinya sendiri, dan selain itu sedang retrograde, terletak di rumah ke-5. Ini menunjukkan dorongan yang mengakar kuat akan struktur, disiplin, dan penguasaan, terutama di bidang yang terkait dengan ekspresi diri, kreativitas, romansa, dan anak-anak.

persona: "teacher":

Dalam bagan natal Anda, Saturnus berada di Capricorn 25.2° (R) di rumah ke-5. Saturnus adalah planet disiplin, tanggung jawab, struktur, dan batasan; planet ini menunjukkan bidang tempat kita mengejar penguasaan dan menghadapi pelajaran hidup.

Persona yang tidak dikenal menghasilkan 400 INVALID_INPUT beserta daftar nilai yang valid, bukan default diam-diam.

Permintaan dan respons

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'];

Respons:

{
  "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"
  }
}

reply di sini disingkat, field lainnya apa adanya. model adalah provider yang menjawab: rantainya berpindah sendiri, dan namanya ada di respons agar kamu tahu token milik siapa yang dihitung ke tagihanmu. Jika model menyentuh batas token, jawaban dipotong ke kalimat terakhir yang selesai dan ditambahkan truncated: true, bukan terputus di tengah kata.

Bagan bersifat opsional

Tanpa chart ini adalah chat astrologi biasa: tidak ada konteks, harganya sama. Dengan chart ia menjawab tentang orang tertentu. history hingga 10 giliran dikirim oleh klien: tidak ada sesi di sisi kami, jadi setiap giliran berdiri sendiri dan bisa dipindahkan antarproses.

Harga dan batas

Harga per giliran	100 kredit
Kunci provider milikmu sendiri (BYOK)	5 kredit per giliran, token milikmu
Paket Free	dapat dipanggil tanpa pembatasan paket, dalam batas 10 000 kredit per bulan
Kunci sandbox aw_test_*	402, karena sandbox tidak memakai kredit, sedangkan model memakai uang
Pengulangan body yang identik	dari cache, x-cache: HIT, x-credits-used: 0
message	hingga 2000 karakter, history hingga 10 giliran
Bahasa	21, parameter language

Perhatian

Endpoint ini belum mendukung streaming: jawaban datang utuh. POST /v1/mcp/streaming mengirim SSE, tetapi juga menunggu jawaban lengkap dan memotongnya per kalimat, jadi kamu tidak akan melihat token pertama lebih awal.

Referensi lengkap Skema permintaan, kode error, contoh

Kunci provider milikmu sendiri X-Provider, X-Provider-Key, 5 kredit per giliran

Paket Berapa giliran per bulan di setiap paket

Agen AI dan MCP Chat yang sama sebagai tool agen