コンテンツにスキップ
AstroWay/api v2.325.0 · ja
すべてのシステムが正常です

Reports API - 自社ブランドで出せる 16 種類の既成 PDF レポート

Last updated Markdownとして開く エージェント設定

送信するのは生年月日だけで、PDFを返します。JSONからPDFを作成する必要はありません。PDFはページごとにレイアウトされ、あなたのロゴ、レポートのタイトルが入っており、私たちの名前は一切記載されていません。

現在、16種類のレポートが利用可能です。エクスポート履歴や5つのAIナラティブと共に、合計で/v1/reports/*の下に23の方法があります。

カタログ

Section titled “カタログ”

各行には、実際に生成されたサンプルファイルがあります。これはマーケットプレイスではありません：このエンドポイントのドキュメント内で印刷された呼び出しと同じもので、テンプレートと共に再発行されます。

ページ数は、2026年9月21日にこのサンプルで測定されたものです。これは地図によって変動します：より多くのアスペクトはより多くの行を意味し、relocationは各都市ごとに2〜3ページを追加します（1つの都市につき4ページ、5つの都市につき13ページ）。

エンドポイント中身ページ数クレジットサンプル
/v1/reports/natal大三角、惑星、家、アスペクト35,000PDF
/v1/reports/synastry二つの地図間のアスペクト、元素のバランス25,000PDF
/v1/reports/transit-yearly選択した年におけるトランジットの予測55,000PDF
/v1/reports/relocation出発地図、最大5都市、家を変えた惑星、近くの線、19の生活分野65,000PDF
/v1/reports/vedic-kundliラグナとナクシャトラ、シデリック位置、マハダーシとヴィムショッタリ25,000PDF
/v1/reports/lal-kitabキスマト、テヴァ、発見されたリニ、ウパイイ25,000PDF
/v1/reports/gemstoneマントラ付きの宝石の推奨、マントラなしの宝石、グラフの状態75,000PDF
/v1/reports/human-design主要パラメータ、センター、チャネル25,000PDF
/v1/reports/muhurta特定の活動に適した有利な日をランキング45,000PDF
/v1/reports/love愛の主要ポイント、大三角、アスペクト25,000PDF
/v1/reports/careerキャリアの主要ポイント、個人のコンテキスト、アスペクト25,000PDF
/v1/reports/money財務の主要ポイント、家、アスペクト35,000PDF
/v1/reports/businessビジネスの主要ポイント、家、アスペクト25,000PDF
/v1/reports/child主要な性格特徴、大三角、惑星25,000PDF
/v1/reports/stellaforge一枚のポスターとしての地図：惑星、バランス、主要なアスペクト15,000PDF
/v1/reports/tarotレイアウトの説明とカード2100PDF
/v1/reports/vastuマンダラ付きの家のプラン、評価、ヴァストゥの発見とソース、修正25,000PDF

タロットは50倍安い理由は、エフェメリッドが含まれていないからです。天文学的な計算なしの1枚のレイアウト。

深さ: standard または extended

Section titled “深さ: standard または extended”

/v1/reports/natal（および/v1/reports/generateでreport_type: "natal"）はdepthを受け付けます。standardは上記のドキュメントで、5,000クレジットです。extendedは10,000クレジットで、太陽からプルートン、ヒロン、アスケントまでの各天体に関する12のセクションを追加します。各セクションは2〜4ページの編集済みテキストで構成されています（PDFサンプル、13ページ）。これは/v1/natal-textsが提供する同じボディーから生成されます。リクエストに応じて何の生成も行われませんので、同じ地図は同じドキュメントを返します。

セクションは20の言語で利用可能で、サイトの言語です。depth: "extended"で他の言語を指定すると、400で拒否されます（他の言語からの翻訳は行われません）。他のレポートタイプは現在1つの深さしか持っていません：それらの長いセクションはまだ書かれていません。

一つのパスで16種類のレポートを処理

Section titled “一つのパスで16種類のレポートを処理”

POST /v1/reports/generateはreport_typeフィールドを受け付け、個別のパスと同じことを行います。12種類のタイプがあります：natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli。

SDKでは1つのメソッドで済みます（12個ではなく）、MCPでは1つのツールで済みます（12個ではなく）。価格は同じです：ディスパッチャ経由での呼び出しは、直接のパスと同じだけのクレジットを消費します。

PDF、HTML、またはMarkdown

Section titled “PDF、HTML、またはMarkdown”

各レポートタイプとディスパッチャはformatを受け付けます：リクエストボディ内またはクエリパラメータとして?format=（一度だけ送信してください；異なる2つの値は400で拒否されます）。価格は3つの形式で同じです：ドキュメントを支払うので、ファイル形式は関係ありません。

format返される内容保存されるか
pdf (デフォルト)PDFのurlを含むJSON、ページ数とexpires_at24時間またはretain_days
htmlドキュメント自体、Content-Type: text/html保存されません
markdown同じドキュメントをMarkdown形式で、Content-Type: text/markdown保存されません

HTMLは1つの自立したファイルです：スタイルは内部に含まれており、星図やヴァストゥのプランは埋め込まれたSVGとして表示され、スクリプトや外部フォントは含まれていません。これはPDFを印刷するのと同じページで、同じホワイトラベルブロック：会社名、レポート名、色、フッターがあります。唯一の外部リンクはlogoUrlで、これはあなたのhttpsイメージへのリンクのままです（PDFと同じように）。送信したすべての名前、場所、テキストはエスケープされますので、例えば<img onerror=...>のような名前はテキストとして印刷されます。このドキュメントは自社のページに埋め込むかiframeに挿入できます。

Markdownは同じ見出し、テキスト、表を持ちます。見出しレベルは保持されています：#はレポート名、##はセクション、###はサブセクションで、PDFと同じ順序ですので、## で始まる行で分割するとセクションになります。GitHub形式の表です。画像（星図、プラン）は省略され、その代わりに1行の注釈が表示されます。MarkdownまたはHTML内部でマークアップとして読み取られるすべての文字はバックスラッシュでエスケープされます。

Terminal window
curl -X POST "https://api.astroway.info/v1/reports/natal?format=markdown" \
  -H "X-Api-Key: aw_live_..." -H "Content-Type: application/json" \
  -d '{ "chart": { "date": "1990-05-15", "time": "14:30:00",
                   "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 },
        "language": "uk" }'

PDFへのリンクは24時間有効です。クライアントに長期有効なリンクを提供するには、?retain_days=30（最大90日）を追加してください：ファイルはその日数だけ保存され、応答内のexpires_atがそれを示します。無期限で他社のドキュメントをホスティングすることはありません。ファイルを早めに削除するにはDELETE /v1/reports/files/{filename}を使用し、無料です。ファイルには送信した内容と名前が含まれていますので、保存期間はDPAの第2節で説明されています。GET /v1/reports/historyは無料でこのキーの最後のエクスポートを表示し、期限切れのレコードはexpired: trueで送信されます。

あなたのブランド、私たちのものではありません

Section titled “あなたのブランド、私たちのものではありません”

whitelabelは15のフィールドを含むオブジェクトを受け付けます：companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing、そして5つの色（themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor）。

リクエスト内で直接送信でき、その際はアカウント設定の変更は一切不要です：

Terminal window
curl -X POST https://api.astroway.info/v1/reports/natal \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "chart": { "date": "1990-05-15", "time": "14:30:00",
                   "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 },
        "whitelabel": { "companyName": "Zoryana Studio",
                        "reportName": "Your Birth Blueprint",
                        "themeColor": "#7c3aed",
                        "footerText": "zoryana.example" } }'

生成されたドキュメントには、スタジオの名前、独自のレポートのタイトル、セクション見出しのアクセント色、そしてあなたのフッターが含まれます。AstroWayの単語は1つもありません。

このオブジェクトを各リクエストで繰り返すことを望まない方のための代替案：whitelabel: trueは保存されたアカウント設定を使用します。これを設定するには、ダッシュボードのレポートのブランド設定ページで行ってください：会社名、レポート名、連絡先、ロゴ、2つの色を設定し、サンプルのナタルレポートのプレビューを表示します。同じ設定はキーを使って/v1/whitelabel/configと/v1/whitelabel/logoからアクセスでき、POST /v1/whitelabel/previewはPDFのサンプルを描きます。オブジェクトで送信されたフィールドは保存されたものに優先されます。

すぐに使えるアプリケーション

Section titled “すぐに使えるアプリケーション”

ライブデモとGitHubのコード、MITライセンス。

プラクティショナーのデスク：左側にクライアントのデータ、右側に準備されたPDF。各レポートのタイルはクリック前のクレジット価格を表示し、準備されたサンプルにリンクします。White-labelはチェックボックスでオンにできます。バックエンドは1つのルートのみで、依存関係はありません、なぜならこれが本質だからです：ブラウザはAPIに直接アクセスできないため、キーはサーバー上に保存されます。

Terminal window
git clone https://github.com/astroway/starter-practice
cd starter-practice && npm install
cp .env.example .env     # your key goes here
npm run dev

4つのことを覚えておいてください。価格は決断する場所で表示されます：サーバーはX-Credits-Usedをページに戻し、ログだけでなく表示します。16のレポートは4つのフォームリクエストを持ち、16個ではありません。同じリクエストを2回行うと無料です、なぜならレスポンスキャッシュが同じファイルを返すからです。そしてALLOWED_REPORTSは、インスタンスがレンダリングするものを制限します：パブリックなデモはタロットのレイアウト（/v1/reports/tarot, 100クレジット）のみをレンダリングします、なぜならオープンインターネットのページがナタルレポート（/v1/reports/natal, 5,000クレジット）を誰でも作成すると、無料の月間限度が2クリックで消費されてしまうからです。

言語

Section titled “言語”

languageフィールドは21のコードを受け付けます。完全に翻訳されたのは3つのみ：ウクライナ語、英語、ロシア語。残りの18言語では、星座の名前のみが翻訳され、見出しや説明は英語のままです：例えば、ドイツ語のレポートでは「Leo」が「Planets」の見出しの下に表示されます。

これは直接書いているのです：レポートはクライアントが保持するドキュメントです。ドイツ語で売ることが、ドイツ語の星座の名前を見た時にクライアント側で不快な発見になることを避けるためです。muhurtaレポートは現在完全に英語です。

プランで何枚のレポートが出せるか

Section titled “プランで何枚のレポートが出せるか”

/v1/reports/natalとその他のPDFは5,000クレジットで、月間の限度はレポート数に直接変換されます：

プランクレジット/月PDFレポートタロットレポート
Free10,000利用不可利用不可
Indie, $550,00010500
Starter, $19200,000402,000
Pro, $59800,0001608,000
Business, $1993,500,00070035,000
Reports Pack, $991,500,00030015,000

Freeプランではレポートが意図的に利用できません：各PDFは私たちのサイドでレンダリングに数秒かかり、無料プランはそれをカバーしません。最も安い入口はIndieで$5です。

Reports Packはレポートのみに特化した追加プランです：$99/月、1,500,000クレジット、つまり33セント/枚の300枚のPDFが含まれ、ホワイトラベル付きです。これはProプランのPDFよりも安く、レポート以外のAPIは開いていません。このプランのキーは/v1/reports/*と/v1/whitelabel/*のみで使用されます。

レポートの再販売：PDFがあなたにどれだけかかるか

Section titled “レポートの再販売：PDFがあなたにどれだけかかるか”

レポートをクライアントに販売する場合、重要なのは1つの数字だけです：あなたの規模で1枚のPDFがどれだけかかりますか。プランの限度内では、そのプランの価格をPDF数で割ったものが1枚あたりの価格です。限度を超えた場合、各PDFは超過分の10,000クレジットごとに追加料金がかかりますので、5,000クレジットのPDFはプランの超過料金の半額になります。

プランプラン内のPDF限度内のPDF価格限度を超えた各PDF
Indie, $510$0.50$2.50
Starter, $1940$0.48$2.50
Pro, $59160$0.37$1.50
Reports Pack, $99300$0.33$1.50
Business, $199700$0.28$1.00

最も安いプランは、月間のPDF数と超過料金を含めて、どれだけ売るかによって変わります：

月間のPDF数最も安いプランあなたの費用1枚あたり
10Indie$5$0.50
40Starter$19$0.48
100Pro$59$0.59
160Pro$59$0.37
300Reports Pack$99$0.33
500Business$199$0.40
700Business$199$0.28

切り替え点：StarterはIndieよりも16枚のPDFから有利、ProはStarterよりも57枚のPDFから有利、Reports PackはProよりも187枚のPDFから有利（レポート以外の機能が必要でない場合）、BusinessはReports Packよりも367枚のPDFから有利です。ProとBusinessは他のAPI機能も開き、Packはレポートとホワイトラベルのみです。

**あなたの利益はあなたが設定します。**Reports Packで300枚のPDFを売る場合、月間の費用は$99です。$9枚で売ると$2,700の収入、$19枚で売ると$5,700の収入になります。小売価格はお勧めしませんが、計算は同じです：あなたの価格から33セントを引きます。

拡張ナタルレポートは標準レポートの2倍の価格ですので、各プランではPDFの価格が2倍になります：Reports Packでは$0.66です。

2つのことが実際の費用をさらに減らします。同じデータで2回リクエストすると、レスポンスキャッシュから同じファイルが返され、費用はかかりませんので、レポートを2回ダウンロードしたクライアントは1回だけ支払います。そして年契約は9割引きで、Reports Packは$0.25/枚になります。

販売する前に、サンプルを開いてください：各サンプルはAPIが返すのと同じファイルで、whitelabelを使うとあなたの名前と色が標準のものに置き換わります。

テキストが必要で、ドキュメントが必要でない場合

Section titled “テキストが必要で、ドキュメントが必要でない場合”

5つのエンドポイントはJSONとしてAIナラティブを返し、レイアウトやPDFは含まれません：/v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative。各250クレジットです。これらを使用するのは、テキストが自社のテンプレート、アプリケーション、またはメール配信に使用される場合です。

ナタルレポートは混合モードにも対応しています：enrich: trueはPDF内にAIナラティブを追加します。同じテスト地図では、5ページに拡張されます（3ページから）。

参考になりましたか？
編集を提案