スライドあたり語数予算

スライド数が零または負の場合は invalid_input として拒否され、計画者が零除算を起こすことはありません。

台本の語数がスライドあたり予算になる仕組み

中核の恒等式は words_per_slide が total_words を slide_count で割った値であることです。別の読みやすさ上限（max_words_per_slide、既定四十）が、その平均がなお簡潔かどうかを判定します。平均が上限以下なら within_budget は true、excess_words_per_slide は各カードが上限をどれだけ超えるか、total_excess_words はその余剰をデッキ全体に伸ばします。平均が高すぎるとき、recommended_slide_count は上限に基づく total_words を max_words_per_slide で割った ceil となり、文章を押し込む代わりにデッキを増やせます。

入力契約・応答形状・エラー挙動

単位接尾辞付き文字列より素の数値を優先し、数値文字列はカンマや「slides」のようなラベルなしの厳密な有限数パターンに一致する場合のみ受け付けます。必須の有限数二つと任意の上限一つを含む JSON 本体を POST してください。total_words（別名 words、word_count、script_words、n）は配分する台本の非負の総語数です。slide_count（別名 slides、num_slides、deck_size、count）はデッキの正のスライド数で、厳密に零より大きくなければなりません。max_words_per_slide（別名 max_wps、ceiling、target_wps、budget_max）はスライドあたり語数の任意の正の読みやすさ上限で、省略時は広く教えられる簡潔スライド目標である四十を使います。絶対値は一兆以内に抑え、Worker isolate とブラウザ上の IEEE 倍精度で中間積が有限に保たれます。成功時、応答は丸めた total_words・slide_count・max_words_per_slide をエコーし、words_per_slide を十二桁固定丸め後の正確な比に、words_per_slide_rounded をカレンダー用ラベル向けの最寄り整数に、within_budget を平均が上限以下かに、excess_words_per_slide と total_excess_words を非負の余剰に、recommended_slide_count を平均を上限下に保つ枚数（台本が空なら零）に、density を帯ラベルに、formula を文書化された恒等式に、method を script_words_over_slide_count に、message を UI バッジ用の短い英語要約に設定します。検証失敗（欠落フィールド、非有限数、絶対限度外の値、負の語数、零または負の slide_count、零または負の上限）は invalid_input を返し、課金されません。料金は unit item の成功呼び出しごとに固定の $0.002 です。

スライドあたり語数予算 API が価値を生む場面

LMS プラグインとプレゼン生成器は、学生が二千語の話と二十枚のアウトラインを設定したときに同じ純モジュールを呼び出し、コーチが上限を四十語から三十語へ厳しくしたときに recommended_slide_count を再計算します。実装は tier A の解析的 parse 作業のため、成功呼び出しは毎回公開の基本価格 $0.002 で、モデルトークンも外向きネットワークもありません。検証失敗は残高を消費しないため、開発者が意図的に slide_count 零を送る探索スクリプトも安価に保てます。