実際のチャートに基づく AI チャット

普通の LLM は、土星についての質問にサインに関する記憶から答えます。POST /v1/ai/chat は、こちらが今計算したチャートから答えます。位置、ハウス、オーブ付きのアスペクト、今後半年のトランジットの期間です。違いは最初の回答から明らかです。「山羊座の土星は規律を意味します」ではなく、「山羊座 25.2° の逆行中の土星、5 ハウス、月とのコンジャンクション、オーブ 1.7°」になります。

キーなしで試す

デモは 1 つの固定チャートで動作し、1 つのアドレスから 1 日 5 問まで、有料エンドポイントと同じシステムプロンプトを使います。キーは不要です。

モデルが見ているもの

デモは context フィールドを返します。これはプロンプトに渡されたブロック全体です。以下は 2026 年 9 月 2 日時点のデモのチャートのものです (トランジットはリクエストごとに再計算されるため、期間の一覧は明日には変わります)。

## 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 のトランジットの期間が含まれます。有料エンドポイントでも、あなたが送ったチャートから同じブロックが組み立てられます。

日付を示すもの、示さないもの

こちらのシステムプロンプトは、上のブロックにあるトランジットについては月を挙げることを認め、出来事に日付を付けることは禁じています。「いつ結婚しますか」という質問に、エンドポイントは次のように答えます (2026 年 9 月 2 日の実際の回答の一部)。

トランジットの土星があなたの出生図の金星とコンジャンクションを形成しています。このトランジットは数か月にわたって有効です。2026 年の 9 月、10 月、11 月、12 月、そして 2027 年の 1 月、2 月、3 月で、最もオーブが狭くなるのは 2027 年 3 月です。

ここでの日付は作り話ではありません。コンテキストブロックの transiting Saturn Conjunction natal Venus の行です。結婚の日付は回答にありませんし、今後も出てきません。

ノート

回答に責任を負うのがあなたである製品を作るなら、この線引きはあなたに有利に働きます。他社のモデルによる日付付きの出来事の予言があなたのインターフェースに表示されれば、それはこちらではなくあなたのリスクです。月ではなく正確な期間が必要な場合: /v1/transit-calendar。

ペルソナ

persona が切り替えるのは語り口で、データではありません。リクエストボディの文字列がシステムプロンプトに入るため、値は閉じた一覧です。

persona	語り口
astrologer	デフォルト。パラメータが登場する前のエンドポイントと同じ答え方
plain	ペルソナ、挨拶、署名なし
coach	寄り添い、それをどう活かすか
teacher	技法の名前を挙げ、用語を説明する

「私の土星を 1 段落で説明して」という質問、persona: "coach":

あなたの土星は、自らの支配する山羊座にあり、しかも逆行していて 5 ハウスに位置しています。これは、構造、規律、熟達への深く根付いた欲求を示しており、特に自己表現、創造性、恋愛、子どもに関わる分野で表れます。

persona: "teacher":

あなたの出生図では、土星は山羊座 25.2° (R) の 5 ハウスにあります。土星 は規律、責任、構造、制限の惑星で、私たちが熟達を目指し、人生の課題に向き合う分野を示します。

未知のペルソナは、黙ってデフォルトになるのではなく、許可された値の一覧付きの 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 があれば、特定の人物について答えます。最大 10 ターンの history はクライアントが送ります。こちら側にセッションはないため、各ターンは自己完結しており、プロセス間で持ち運べます。

価格と制限

1 ターンの価格	100 クレジット
自分のプロバイダーキー (BYOK)	1 ターン 5 クレジット、トークンは自分持ち
Free プラン	プランによる制限なしで呼び出せます。月 10 000 クレジットの範囲内
サンドボックスキー aw_test_*	402。サンドボックスはクレジットを消費しませんが、モデルには費用がかかるためです
同一ボディの再送	キャッシュから、x-cache: HIT、x-credits-used: 0
message	最大 2000 文字、history は最大 10 ターン
言語	21、language パラメータ

注意

このエンドポイントにはまだストリーミングがなく、回答は丸ごと届きます。POST /v1/mcp/streaming は SSE を返しますが、やはり完全な回答を待ってから文ごとに区切るため、最初のトークンが早く届くことはありません。

完全なリファレンス リクエストのスキーマ、エラーコード、例

自分のプロバイダーキー X-Provider、X-Provider-Key、1 ターン 5 クレジット

料金プラン 各プランで月に何ターン使えるか

AI エージェントと MCP 同じチャットをエージェントのツールとして