AI chat trên bản đồ sao thật

Last updated 25 thg 9, 2026 Xem dưới dạng Markdown Thiết lập tác nhân

Một LLM thông thường trả lời câu hỏi về Sao Thổ dựa trên trí nhớ về cung hoàng đạo. POST /v1/ai/chat trả lời từ bản đồ sao mà chúng tôi vừa tính: vị trí, nhà, góc chiếu kèm orb và các cửa sổ transit trong nửa năm tới. Sự khác biệt thấy ngay từ câu trả lời đầu tiên: không phải “Sao Thổ ở Ma Kết nghĩa là kỷ luật”, mà là “Sao Thổ ở Ma Kết 25.2° nghịch hành, nhà 5, hợp với Mặt Trăng orb 1.7°”.

Thử không cần key

Bản demo chạy trên một bản đồ sao cố định, 5 câu hỏi mỗi ngày cho mỗi địa chỉ, dùng cùng system prompt với endpoint trả phí. Không cần key.

Model nhìn thấy gì

Bản demo trả về trường context: đó là toàn bộ khối được đưa vào prompt. Đây là khối đó vào ngày 2 tháng 9 năm 2026 cho bản đồ sao trong demo (transit được tính lại ở mỗi request, nên ngày mai danh sách cửa sổ sẽ khác):

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

Khối này đã được rút gọn: bản đầy đủ có 12 hành tinh và góc, tối đa 20 góc chiếu chính của bản đồ gốc và tối đa 12 cửa sổ transit. Khối tương tự được dựng cho endpoint trả phí từ bản đồ sao mà bạn gửi.

Nó ghi ngày cho gì và không ghi ngày cho gì

System prompt của chúng tôi cho phép nêu tên tháng cho các transit có trong khối ở trên, và cấm ghi ngày cho một sự kiện. Với câu hỏi “khi nào tôi kết hôn”, endpoint trả lời như sau (trích đoạn một câu trả lời thật ngày 2 tháng 9 năm 2026, dịch từ tiếng Ukraina):

Sao Thổ transit tạo góc hợp với Sao Kim trong bản đồ gốc của bạn. Transit này sẽ hoạt động trong vài tháng: vào tháng Chín, tháng Mười, tháng Mười Một, tháng Mười Hai năm 2026, cũng như tháng Một, tháng Hai và tháng Ba năm 2027, đạt orb chặt nhất vào tháng Ba năm 2027.

Các ngày ở đây không phải bịa ra: đó là dòng transiting Saturn Conjunction natal Venus trong khối ngữ cảnh. Ngày kết hôn không có trong câu trả lời và sẽ không bao giờ có.

Persona

persona đổi giọng văn, không đổi dữ liệu. Giá trị là một danh sách đóng, vì chuỗi từ body của request được đưa vào system prompt.

`persona`	Giọng văn
`astrologer`	mặc định, giống cách endpoint trả lời trước khi có tham số này
`plain`	không có persona, lời chào hay chữ ký
`coach`	sự hỗ trợ và những gì nên làm với điều đó
`teacher`	nêu tên kỹ thuật và giải thích thuật ngữ

Câu hỏi “Mô tả Sao Thổ của tôi trong một đoạn”, persona: "coach":

Sao Thổ của bạn nằm ở cung Ma Kết, là nhà riêng của nó, và hơn nữa nó đang nghịch hành, nằm ở nhà thứ 5. Điều này cho thấy một khát khao sâu xa về cấu trúc, kỷ luật và sự thành thạo, đặc biệt trong các lĩnh vực liên quan tới thể hiện bản thân, sáng tạo, tình cảm lãng mạn và con cái.

persona: "teacher":

Trong bản đồ sao cá nhân của bạn, Sao Thổ nằm ở Ma Kết 25.2° (R) trong nhà thứ 5. Sao Thổ là hành tinh của kỷ luật, trách nhiệm, cấu trúc và giới hạn; nó chỉ ra những lĩnh vực mà chúng ta hướng tới sự thành thạo và đối mặt với các bài học cuộc đời.

Persona không xác định là 400 INVALID_INPUT kèm danh sách giá trị hợp lệ, chứ không lặng lẽ dùng mặc định.

Request và phản hồi

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

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);

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

Phản hồi:

{
  "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 ở đây đã được rút gọn, các trường còn lại giữ nguyên. model là nhà cung cấp đã trả lời: chuỗi tự chuyển đổi, và tên của nó có trong phản hồi để bạn thấy token của ai đã được tính vào hóa đơn của bạn. Nếu model chạm trần token, phản hồi được cắt tới câu hoàn chỉnh cuối cùng và thêm truncated: true, chứ không bị đứt giữa chừng một từ.

Bản đồ sao là tùy chọn

Không có chart thì đây là một chat chiêm tinh thông thường: không có ngữ cảnh, giá như nhau. Có chart thì nó trả lời về một người cụ thể. history tối đa 10 lượt do client gửi: phía chúng tôi không có session, nên mỗi lượt đều tự đầy đủ và có thể chuyển giữa các tiến trình.

Giá và giới hạn


Giá mỗi lượt	100 credit
Key nhà cung cấp của riêng bạn (BYOK)	5 credit mỗi lượt, token là của bạn
Gói Free	gọi được không bị giới hạn bởi gói, trong phạm vi 10 000 credit mỗi tháng
Key sandbox `aw_test_*`	`402`, vì sandbox không tiêu credit, còn model thì tiêu tiền
Lặp lại body giống hệt	lấy từ cache, `x-cache: HIT`, `x-credits-used: 0`
`message`	tối đa 2000 ký tự, `history` tối đa 10 lượt
Ngôn ngữ	21, tham số `language`

Reference đầy đủ Schema của request, mã lỗi, ví dụ

Key nhà cung cấp của riêng bạn X-Provider, X-Provider-Key, 5 credit mỗi lượt

Bảng giá Bao nhiêu lượt mỗi tháng trên từng gói

AI agent và MCP Cùng chat đó dưới dạng tool của agent