دردشة AI على خريطة حقيقية

يجيب أي LLM عادي عن سؤال حول زحل من ذاكرته عن البرج. أما POST /v1/ai/chat فتجيب من الخريطة التي حسبناها للتو: الموقع، والبيت، والجوانب مع الـ orbs، ونوافذ العبور للأشهر الستة القادمة. يظهر الفرق من الإجابة الأولى: لا “زحل في الجدي يعني الانضباط”، بل “زحل في الجدي 25.2° متراجع، البيت الخامس، اقتران مع القمر بـ orb قدره 1.7°”.

جرّبها دون مفتاح

يعمل العرض التجريبي على خريطة ثابتة واحدة، بحد 5 أسئلة يوميًا لكل عنوان، وبنفس موجّه النظام المستخدم في نقطة النهاية المدفوعة. لا حاجة إلى مفتاح.

ما الذي يراه النموذج

يُرجع العرض التجريبي الحقل context: وهو الكتلة الكاملة التي دخلت في الموجّه. هذه هي كما كانت في 2 سبتمبر 2026 لخريطة العرض التجريبي (تُعاد حساب العبورات في كل طلب، لذا ستختلف قائمة النوافذ غدًا):

## 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°)

الكتلة مختصرة: النسخة الكاملة فيها 12 كوكبًا وزاوية، وحتى 20 جانبًا ولاديًا رئيسيًا، وحتى 12 نافذة عبور. تُبنى الكتلة نفسها لنقطة النهاية المدفوعة من الخريطة التي ترسلها أنت.

ما الذي يؤرّخه وما الذي لا يؤرّخه

يسمح موجّه النظام لدينا بتسمية الأشهر للعبورات الموجودة في الكتلة أعلاه، ويمنع تحديد تاريخ لحدث. على سؤال “متى سأتزوج” تجيب نقطة النهاية هكذا (مقتطف من إجابة حقيقية بتاريخ 2 سبتمبر 2026):

يشكّل زحل العابر اقترانًا مع زهرتك الولادية. سيبقى هذا العبور نشطًا لعدة أشهر: في سبتمبر وأكتوبر ونوفمبر وديسمبر 2026، وكذلك في يناير وفبراير ومارس 2027، ويبلغ أضيق orb له في مارس 2027.

التواريخ هنا ليست مختلقة: إنها السطر transiting Saturn Conjunction natal Venus من كتلة السياق. لا يوجد في الإجابة تاريخ للزواج، ولن يوجد.

ملاحظة

إذا كنت تبني منتجًا تتحمل فيه مسؤولية الإجابة، فهذا الحد يعمل لصالحك: تنبؤ مؤرَّخ بحدث صادر عن نموذج طرف آخر في واجهتك هو مخاطرتك أنت، لا مخاطرتنا. تحتاج نافذة دقيقة بدل الشهر؟ استخدم /v1/transit-calendar.

الشخصيات

يبدّل persona الصوت لا البيانات. القيم قائمة مغلقة، لأن النص القادم من جسم الطلب يدخل في موجّه النظام.

persona	الصوت
astrologer	الافتراضي، كما كانت نقطة النهاية تجيب قبل إضافة المعامل
plain	بلا شخصية، بلا تحية ولا توقيع
coach	الدعم، وما يمكن فعله بذلك
teacher	يسمّي التقنية ويشرح المصطلحات

السؤال “صف زحلي في فقرة واحدة”، مع persona: "coach":

زحلك في برج الجدي، وهو بيته الخاص، وهو إضافة إلى ذلك متراجع ويقع في البيت الخامس. يشير هذا إلى رغبة عميقة الجذور في البنية والانضباط والإتقان، خاصة في المجالات المرتبطة بالتعبير عن الذات والإبداع والرومانسية والأطفال.

persona: "teacher":

في خريطتك الولادية يقع زحل في الجدي 25.2° (R) في البيت الخامس. زحل هو كوكب الانضباط والمسؤولية والبنية والقيود؛ ويشير إلى المجالات التي نسعى فيها إلى الإتقان ونواجه فيها دروس الحياة.

الشخصية غير المعروفة تُرجع 400 INVALID_INPUT مع قائمة القيم المسموح بها، لا قيمة افتراضية صامتة.

الطلب والاستجابة

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

الاستجابة:

{
  "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 هنا، وبقية الحقول كما هي. model هو المزود الذي أجاب: تتبدّل السلسلة تلقائيًا، واسمه موجود في الاستجابة لترى رموز من احتسبها حسابك. إذا اصطدم النموذج بسقف الرموز، تُقتطع الإجابة عند آخر جملة مكتملة ويُضاف truncated: true، بدل أن تنقطع في منتصف كلمة.

الخريطة اختيارية

دون chart هي دردشة فلكية عادية: لا سياق، والسعر نفسه. مع chart تجيب عن شخص محدد. يرسل العميل history بحد 10 أدوار: لا توجد جلسات من جهتنا، لذا كل دور مكتفٍ بذاته ويمكن نقله بين العمليات.

السعر والحدود

سعر الدور	100 رصيد
مفتاح مزودك الخاص (BYOK)	5 أرصدة للدور، والرموز على حسابك
خطة Free	الاستدعاء دون قيود الخطة، ضمن 10 000 رصيد شهريًا
مفاتيح Sandbox aw_test_*	402، لأن بيئة الاختبار لا تستهلك الرصيد بينما النموذج يستهلك مالًا
تكرار جسم طلب مطابق	من الذاكرة المؤقتة، x-cache: HIT، x-credits-used: 0
message	حتى 2000 حرف، و history حتى 10 أدوار
اللغات	21، عبر المعامل language

تنبيه

لا يوجد بث (streaming) على نقطة النهاية هذه حاليًا: تصل الإجابة كاملة. تُرسل POST /v1/mcp/streaming بصيغة SSE، لكنها أيضًا تنتظر الإجابة الكاملة ثم تقطّعها إلى جمل، لذا لن ترى الرمز الأول أبكر.

المرجع الكامل مخطط الطلب، رموز الأخطاء، أمثلة

مفتاح مزودك الخاص X-Provider و X-Provider-Key و 5 أرصدة للدور

الأسعار كم دورًا شهريًا في كل خطة

وكلاء AI و MCP الدردشة نفسها كأداة للوكيل