ForHosting KIT · 文章作成・要約AI

独自の単語辞書で文章全体のトーンを判定

Q: 照合では大文字と小文字を区別しますか？

区別しません。 文章と語彙項目を小文字に正規化してから、単語全体を照合します。

Q: 一つの単語を複数の分類に登録できますか？

はい。 単語が現れるたびに、その語を含むすべての分類へ一回ずつ加算され、各分類の結果に表示されます。

Q: 皮肉や文脈を理解できますか？

できません。 明示的な単語一致だけを分類します。この制限が結果の透明性と再現性につながります。

サンプルの依頼文では、フォーマルな語が3つ、緊急の語と親しみの語が1つずつ一致し、5件中3件でフォーマル、確信度0.6と判定されます。単語リストは自分で作るので、結果を一語ずつ確かめられます。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

この文章トーン分類機能は、お客様が用意した語彙リストと文章を照合します。フォーマル、カジュアル、緊急、親しみやすい表現の単語一覧を指定すると、モデルやネットワーク通信を使わず、単語単位で一致数を数えます。主要なトーン、分類別の件数、一致した単語、信頼度の割合、指定した既定値が使われたかどうかを返します。同じ文章と語彙リストからは常に同じ結果が得られるため、編集基準の確認、振り分け規則、自動テストに安定して利用できます。

文章ルールに合う語彙リストを作成します

有用な分類を行うには、対象となる文章に合わせた語彙リストが必要です。組織内で実際に格式を示す単語はフォーマルに、くだけた表現はカジュアルに登録してください。「直ちに」「期限」「重大」などは緊急、「ようこそ」「ありがとう」「喜んで」などは親しみやすい分類の候補になります。

分類規則がすべて明示されるため、不透明なモデルがラベルを選んだ理由を推測する必要はなく、担当者が根拠を確認して修正できます。照合は大文字と小文字を区別せず、単語全体を対象に行います。同じ単語を複数の分類に含めることもでき、その場合は出現するたびに該当するすべての分類へ加算されます。

同じ分類内の重複項目はまとめられるため、誤って同じ単語を繰り返しても重みは増えません。対象分野でトーンを十分に示す具体的な語を選ぶことが重要です。意味の弱い一般語を多く含めると、頻度は低くても重要な手掛かりが埋もれる場合があります。

各分類には最大千語まで登録でき、実務的な編集辞書を作りながら処理量を一定範囲に保てます。

得点と決定的な同点処理を理解します

分類機能は文章を単語に分け、それぞれを四つのリストで検索します。同じ単語が文章内で繰り返された場合は毎回数えます。反復によって文章の印象が強まることがあるためです。

結果にはフォーマル、カジュアル、緊急、親しみやすい表現の件数と、分類ごとに一致した異なる単語が含まれ、判断根拠を確認できます。最も件数の多い分類が主要トーンです。信頼度は主要分類の件数を全分類の一致総数で割った値であり、観測された手掛かりのうち選択を支える割合を表します。

執筆者の意図に関する統計的な確率ではありません。最高件数が同じ場合は、フォーマル、カジュアル、緊急、親しみやすい表現の順で選びます。この固定規則により、ブラウザーと自動処理で同じ結果になります。

必要であれば件数を参照し、後続処理で別の規則を適用できます。通常の句読点や大文字小文字は一致に影響しません。語彙項目は一語に限られ、複数語の表現や意味理解にはモデル型の分析が適しています。

一致しない場合のエラーと既定値を選択します

一致がないこと自体も重要な情報です。指定したトーン指標が文章に一つも現れない場合、初期設定では入力エラーを返します。これにより、中立的な文章や辞書にない文章を、根拠があるかのように自動分類することを防げます。

語彙リストの作成中は既定値を省略し、足りない語を見つける方法が有効です。代表的な文章で評価した後にだけ既定値を追加するとよいでしょう。範囲が広すぎる語、業界特有の用法、複数分類に含まれる語が原因であることがよくあります。

この機能は皮肉、構文、読者、文脈を推測しません。限定された同じ文章と同じ語彙から、常に同じ件数、ラベル、予備状態を返す再現性が特長です。

活用例

サポートメッセージを振り分ける

緊急語が多いメッセージを優先キューへ送り、一致した単語を判断根拠として保存します。

文章スタイル規則を適用する

公開前の原稿を、組織独自のフォーマル語とカジュアル語の一覧で確認します。

生成文章をテストする

モデルの変動する出力に頼らず、自動テストで再現可能なトーンラベルを検証します。

よくある質問

照合では大文字と小文字を区別しますか？

区別しません。文章と語彙項目を小文字に正規化してから、単語全体を照合します。

二つのトーンが同点の場合はどうなりますか？

フォーマル、カジュアル、緊急、親しみやすい表現の順で選びます。別の規則を使う場合は全件数を参照できます。

一つの単語を複数の分類に登録できますか？

はい。単語が現れるたびに、その語を含むすべての分類へ一回ずつ加算され、各分類の結果に表示されます。

皮肉や文脈を理解できますか？

できません。明示的な単語一致だけを分類します。この制限が結果の透明性と再現性につながります。

一致する語がひとつもない場合はどうなりますか？

既定のトーンを指定しておけば、そのトーンが件数0、確信度0として返され、既定値を使ったことも示されます。指定がない場合はエラーになるため、根拠のある判定と区別できます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/write/tone-word-classify

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/write/tone-word-classify \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Please review this document promptly. Your assistance is appreciated.","lexicon":{"formal":["please","document","appreciated"],"casual":["hey","cool","yeah"],"urgent":["promptly","immediately","urgent"],"friendly":["thanks","welcome","assistance"]}}'

const res = await fetch("https://api.kit.forhosting.com/write/tone-word-classify", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "Please review this document promptly. Your assistance is appreciated.",
    "lexicon": {
      "formal": [
        "please",
        "document",
        "appreciated"
      ],
      "casual": [
        "hey",
        "cool",
        "yeah"
      ],
      "urgent": [
        "promptly",
        "immediately",
        "urgent"
      ],
      "friendly": [
        "thanks",
        "welcome",
        "assistance"
      ]
    }
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/write/tone-word-classify",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "Please review this document promptly. Your assistance is appreciated.",
    "lexicon": {
        "formal": [
            "please",
            "document",
            "appreciated"
        ],
        "casual": [
            "hey",
            "cool",
            "yeah"
        ],
        "urgent": [
            "promptly",
            "immediately",
            "urgent"
        ],
        "friendly": [
            "thanks",
            "welcome",
            "assistance"
        ]
    }
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/write/tone-word-classify", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"Please review this document promptly. Your assistance is appreciated.","lexicon":{"formal":["please","document","appreciated"],"casual":["hey","cool","yeah"],"urgent":["promptly","immediately","urgent"],"friendly":["thanks","welcome","assistance"]}}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"Please review this document promptly. Your assistance is appreciated.","lexicon":{"formal":["please","document","appreciated"],"casual":["hey","cool","yeah"],"urgent":["promptly","immediately","urgent"],"friendly":["thanks","welcome","assistance"]}}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/write/tone-word-classify", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "text": "Please review this document promptly. Your assistance is appreciated.",
  "lexicon": {
    "formal": [
      "please",
      "document",
      "appreciated"
    ],
    "casual": [
      "hey",
      "cool",
      "yeah"
    ],
    "urgent": [
      "promptly",
      "immediately",
      "urgent"
    ],
    "friendly": [
      "thanks",
      "welcome",
      "assistance"
    ]
  }
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "write.tone_word_classify",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

`max_chars`	100000
`max_lexicon_words_per_tone`	1000

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

一致しない場合のエラーと既定値を選択します

すべての項目を必ず振り分ける必要がある場合は、default_tone に対応する四つのラベルのいずれかを指定してください。結果にはそのラベル、すべてゼロの件数、ゼロの信頼度、真に設定された used_default が含まれます。そのため、根拠に基づく分類と予備の振り分けを追加の要求なしで区別できます。予想外の結果になった場合は matched_words を確認してください。

技術的な質問

一回の分類料金はいくらですか？

API リクエスト一回につき $0.002 です。ブラウザー版では同じ決定的な処理を端末内で実行します。

一致する単語がない場合はどうなりますか？

default_tone がなければ invalid_input を返します。既定値があれば used_default は真、信頼度はゼロになります。

KITの完全なドキュメントを見る →

無料で実行

文章ルールに合う語彙リストを作成します

得点と決定的な同点処理を理解します

一致しない場合のエラーと既定値を選択します

活用例

サポートメッセージを振り分ける

文章スタイル規則を適用する

生成文章をテストする

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

制限

エラー

技術的な注記

一致しない場合のエラーと既定値を選択します

技術的な質問

ありがとう