AstroAPI

Appearance

AI要約 ​

どの計算も数十件の解釈テキストを返します。AI要約は、そのなかで最も重要なものを、そのホロスコープがその人にとって実際に何を意味するのかを述べた数文にまとめます。相性（シナストリー）とコンポジットでは、二人にとっての意味をまとめます。

要約は計算中には生成されません。計算は署名付きリンクを返し、そのリンクを開いたときに初めてモデルが動きます。

必要なモジュール

ai:summary モジュールが必要です。Premium および Deluxe プランに含まれ、単体では販売していません。

要約する対象のホロスコープ種別の解釈テキスト（例：natal:texts）も必要です。テキストがなければ要約するものがありません。

仕組み ​

  1. これまでどおり計算エンドポイントを呼び出します。
  2. レスポンスに署名付き URL を持つ summary オブジェクトが含まれます。
  3. 要約が欲しいときに、その URL を開きます。

ステップ 1 と 2 では、計算も保存も課金も行われません。これは意図的な設計です。ほとんどの利用者が使わない機能のために、通常のホロスコープ呼び出しが料金を負担すべきではないからです。

要約リンク ​

json
{
    "data": {
        "points": { "...": "..." },
        "aspects": [],
        "chart": { "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..." },
        "summary": {
            "url": "https://api.astroapi.cloud/api/calc/natal/summary?t=eyJ0Ijoi...&expires=1793000000&sig=Ab3...",
            "method": "GET",
            "cost": 10,
            "expiresAt": "2026-08-30T10:00:00Z"
        }
    }
}
フィールド説明
url要約を返す署名付き URL。リクエスト全体を含むため、ボディは不要です。
method常に GET。
cost要約を生成したときに課金される API リクエスト数。キャッシュされた要約は 1 です。
expiresAtリンクは 7 日間有効です。新しいものが必要なら計算をやり直してください。

summary オブジェクトは、契約にモジュールが含まれている場合のみ存在します。見当たらない場合はプランをご確認ください。

チャートだけでなくリンクも保存してください

リンクは 7 日で失効し、ちょうど 1 つのチャートに対して署名されています。編集はできません。URL 内の出生データ・ホロスコープ種別・組織を変更すると署名が無効になります。

要約の取得 ​

bash
curl "https://api.astroapi.cloud/api/calc/natal/summary?t=eyJ0Ijoi...&expires=1793000000&sig=Ab3..." \
  -H "X-Api-Key: your-api-key"

署名があるため API キーは省略可能で、ヘッダーを設定できないブラウザや埋め込みからでもリンクが機能します。キーを送る場合は、リンクが発行された組織と同じ組織のものである必要があります。

少し時間がかかります

要約の生成では、計算をやり直し、テキストを取得し、言語モデルを呼び出します。数秒かかると考えてください。すでに生成済みの要約は即座に返ります。

レスポンス ​

json
{
    "data": {
        "horoscopeType": "natal",
        "language": "ja",
        "summary": "あなたは慎重さよりも「見えること」から始めます。10 室の獅子座の太陽は、仕事と評判をあなたの自己理解の中心に置きます…",
        "cached": false,
        "generatedAt": "2026-08-23T10:15:22Z",
        "model": "@cf/qwen/qwen3-30b-a3b-fp8",
        "highlights": [
            { "kind": "point", "label": "Sun in Leo in house 10" },
            { "kind": "point", "label": "Moon in Taurus in house 7" },
            { "kind": "aspect", "label": "Sun square Saturn (orb 0.4°)" }
        ]
    }
}
フィールド説明
summary生成されたテキスト（4〜6 文）。
cachedキャッシュから返された場合は true。キャッシュ済みの要約は 10 ではなく 1 リクエストとして数えます。
highlights要約の元になった配置。強い順に並びます。
modelテキストを書いたモデル。

対応するホロスコープ種別 ​

種別エンドポイント要約の対象
natal/api/calc/natal/summaryその人がどんな人か
synastry/api/calc/synastry/summary二人が互いに及ぼし合うもの
composite/api/calc/composite/summary二人が一緒に形づくる関係
transit/api/calc/transit/summaryこれから訪れる時期
solar/api/calc/solar-return/summaryこれから 1 年
lunar/api/calc/lunar-return/summaryこれから 1 か月
progressions/api/calc/progressions/summaryその人が今いる人生の段階

要約に何が入るのか ​

出生図一枚で 40 件を超える解釈テキストが生成されます。それをすべてモデルに渡すと、読み解きではなく一覧になり、費用もはるかに膨らみます。そのため配置をスコアリングし、最も強いものだけを残します。

  • 配置 — 二つの光（太陽・月）とアセンダントが最も重く、次いでチャートルーラー、個人天体、アンギュラーハウスにあるものすべて。
  • アスペクト — オーブの正確さ（そのアスペクトの最大値に対してどれだけタイトか）、メジャーアスペクトかどうか、そして両端がどれだけ個人的かでスコアリングします。正確な太陽–土星のスクエアは、広い海王星–冥王星のセクスタイルを大きく上回ります。
  • シナストリー は交差アスペクトのみを残し、双方向で、どちらの天体がどちらのチャートに働きかけているかを明示します。
  • トランジット はさらに、トランジット天体が通過中のハウスも含めます。

スコアリングは決定的です。同じチャートからは常に同じ選択が得られ、それが結果をキャッシュ可能にしています。

モデルは与えられたテキストしか使えません。配置・日付・助言を創作しないため、要約は Content Editor で自分で編集したものも含め、あなた自身の解釈テキストを反映します。

言語 ​

要約は計算と同じ言語で書かれます。計算リクエストで language を指定すれば、リンクがそれを引き継ぎます。

bash
curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": { "longitude": 4.89, "latitude": 52.37, "timezone": "Europe/Amsterdam" },
    "language": "ja",
    "includeText": true
  }'

解釈テキストはすでにローカライズされており、モデルにも同じ言語で書くよう指示されます。

料金 ​

状況API リクエスト
レスポンスに要約リンクを含む計算1（変更なし）
リンクを開いて要約を生成10
リンクを開いたが要約がキャッシュ済み1
リクエスト失敗（403、422、期限切れリンク）0

生成された要約は、チャート・言語・プロンプトバージョンごとに 30 日間キャッシュされるため、同じリンクを何度開いても安価です。

レスポンスヘッダー X-Quota-Limit、X-Quota-Remaining、X-Quota-Reset は重み付けされたコストを反映し、ダッシュボードの利用状況も同様です。

エラー ​

ステータス意味
400リンクの形式が不正、またはトークンがこのホロスコープ種別のものではありません。
401署名が無効、またはリンクが期限切れです。
403契約に ai:summary またはこの種別の解釈テキストがない、あるいはリンクが別の組織のものです。
409このチャートの要約はすでに生成中です。数秒後に再試行してください。同じテキストに二重に課金されるのを防ぎます。
422このチャートに利用できる解釈テキストがないため、要約できません。

次のステップ ​

AstroAPI Documentation

Copyright © 2026 AstroAPI