Atomic AI API
既存サイトを「ことばで直す」編集と、atom再利用による生成を、HTTPで呼べるAPIです。 全文を読み直さず、最小コンテキストだけを読むことで、 大きいページほどトークン（＝コスト）を大幅に削減します。
主な用途（ユースケース）
- ・既存サイトの一括文言更新 — キャンペーン見出し・営業時間・表記などを自然文で差し替え。
- ・大量LP・店舗ページのテーマ替え — 構造を保ったまま見た目・コピーを更新。
- ・新規サイトの下書き生成 — 業種クエリからatom再利用でベースを生成し、あとは「ことばで直す」。
- ・既存HTMLの構造化 — /atomize で再利用可能な部品に分解し、社内の制作を高速化。
できること
- ・/edit — 既存HTMLを自然文で編集（見出し・本文・ボタン等）。対象が無い指示は可能なら追加で反映し、一意に特定できない時のみ候補を提示します（反映を確認できた時だけ成功とします。代表セット/UI編集で偽成功0・多価格サイト等のprice編集は反映確認を是正継続中）。
- ・/generate — クエリから新規サイト生成（atom再利用＋必要分のみ生成）。
- ・/atomize — HTMLを再利用可能な構造（meta atom）へ分解。
- ・/assemble — 既存atomを合成（再利用＝0トークン）。
- ・/search — 用途の自然文で類似atomを意味検索。
実測値（measured・NO SIMULATION）
| 指標 | 実測 |
|---|---|
| /edit 入力トークン削減（中央値・最新エンジン） | 小+64.7% / 中+74.3% / 大+91.5%（T8実測 N=36） |
| 改善幅（最小コンテキスト化の効果） | 従来比 中+30.8pt / 大+7.5pt（A_in最小化・T8実測 N=36） |
| 編集の反映 / 偽成功（正直） | 代表セット/viral/UI編集で偽成功0（rendered検証）。price編集の偽成功: 是正前 約34%（T8 N=35）→ 是正後 0/35（同一の厳密harness・post-fix build・接続断0で完走・T3最終監査中）。引用形のprice編集は21/21反映。計算系（「1割値上げ」等）は安全側でdecline（偽の成功は出さない）。無条件の「偽成功0」は掲げない。 |
| Crossover閾値（実測） | crossover≈7KB。削減が効くのは全2,417サイトの約94%（≥10KB）。削減が出ない小ページは約3〜6%（<6KB=3.1% / <10KB=5.7%）。T8実測 N=24 |
| /generate 新規生成のatom再利用率（平均） | 90.1%（T8実測 N=12）。再利用が高いほど出力トークンが小さい（高再利用は低再利用の約1/5） |
※数値はサイズ・内容で変動します。小さいページでは削減が出ない（むしろ不利な）領域があります。
使い方（オンボーディング）
- APIキーを受け取る（
X-API-Keyヘッダで認証）。 - ヘルスチェックで疎通確認。
- 既存サイトを
/editに投げて「ことばで直す」。 - 使用量は
/usageで確認（キー×月のトークン）。
# 1) 疎通
curl https://<host>/api/health
# 2) ことばで直す（要 X-API-Key）
curl -X POST https://<host>/api/edit \
-H 'Content-Type: application/json' -H 'X-API-Key: <your-key>' \
-d '{"code":"<html>...既存サイト...</html>","query":"見出しを春の特集に変更して"}'レスポンス例（/edit・大ページの実測値）:
{
"ok": true,
"applied": 1,
"new_code": "<html>...更新後のHTML...</html>",
"tokens": { "A_metaatom_in": 2377, "B_fullread_in": 20204 },
"input_saved_pct": 88.2,
"plan": "pro"
}※ A_metaatom_in＝最小コンテキストで読んだ入力 / B_fullread_in＝全文を読んだ場合（baseline）。差が削減。
詳細リファレンス・SDK（Python / TypeScript / curl）は技術ドキュメントを参照。
料金
プラン体系（Free / Starter / Pro / Enterprise）は使用量メータリング・月次上限まで実装済みです。 価格は準備中（事業判断・弁護士レビュー前のため非掲載）。確定後にこの枠へ掲載します。
※現時点で課金は行いません（計測のみ）。本ページの料金枠は確定価格ではありません。
現在の制限（正直に）
- ・一般提供前です（限定提供レベル）。レート制限の厳密化・APIキー発行の自動化は準備中。
- ・小さいページではトークン削減が出ない場合があります（上表のcrossover）。
- ・「何でも完璧に編集」とは謳いません。反映できない指示は正直に候補提示で返します。
よくある質問
Q. 既存サイトを壊しませんか？
A. 編集は最小diffで行い、変更が本文に反映されたことを確認できた時だけ成功（ok=true）を返します（代表セット/UI編集で偽成功0・price編集の広域は反映確認を是正中）。一意に特定できない指示は候補提示で返します。
Q. どのくらいトークン（コスト）が下がりますか？
A. 編集対象のページが大きいほど削減が伸びます（最新エンジンで 小 中央値+64.7% / 中+74.3% / 大+91.5%・T8実測 N=36）。約7KB未満の小ページは削減が出ない場合があり、その旨を正直に表示します。
Q. 対応している入力は？
A. HTML（既存サイト）と自然文の指示です。日本語の指示・コンテンツに対応します。
Q. 認証・利用上限は？
A. APIキー（X-API-Key）認証。プラン別の月次トークン上限とレート制限があり、/usage で残量を確認できます。
Q. 料金は？
A. 準備中です（事業判断・弁護士レビュー前のため非掲載）。現時点で課金は行いません（計測のみ）。
Q. SLA・稼働保証はありますか？
A. 現在は限定提供のため正式なSLAは未提供です。一般提供時に提示予定です（装わず未確定と明示）。
お問い合わせ
導入のご相談・APIキー発行のご希望は、お問い合わせフォームよりご連絡ください。
お問い合わせ本ページの説明は現時点の実装に基づく案内です。利用規約・プライバシーポリシー・特定商取引法に基づく表記は 弁護士レビュー前のドラフトであり、正式な法的効力を持つものではありません（確定・公開は事業判断および法務確認後）。