ForHosting KIT · 開発者向けツール

開始番号と増分を指定して行番号を付ける

通常の1ずつ増える番号だけでは足りない場合に、独自の行番号を設定できます。文章、一覧、コード例、書き起こし、引用ブロックを貼り付け、先頭行の番号と、その後の番号をいくつずつ変えるかを指定してください。各行の順序と内容を保ったまま、引用、比較、別文書への貼り付けに使いやすい一定の参照番号を追加します。作業手順に応じて、降順の値や同じ値の繰り返しにも対応します。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

周囲の文書に合う開始値を選びます

開始設定は、先頭行に付ける番号を決めます。全文ではなく一部だけを扱う場合に特に重要です。たとえば前の節が240行目で終わっているなら、次の節を241から始めることで、仮の行を挿入せずに参照番号を連続させられます。独自の開始値は、授業用課題、法的資料、インタビューの書き起こし、段階的なコードレビューなど、貼り付けた断片に意味のある位置を残したい場面にも便利です。意図的な空行を含め、原文を表示したいとおりに入力してください。一般的な改行形式はOSが異なっても結果が安定するように統一されますが、元の行の内容を削除、書き換え、折り返し、その他の方法で変更することはありません。入力を分割して得られたすべての行に番号が付きます。空行や、末尾の改行によって生じる最後の空行も対象です。この明確な仕様により、同じ入力と設定からは常に同じ内容と同じ番号が得られ、後から参照しても曖昧になりません。

増分を使って連番以外の並びを作ります

増分は各行の後で番号に加算されるため、並び方を直接制御できます。1なら通常の連番になり、開始値が10で増分が5なら10、15、20のように進みます。間隔を広くすると、後で追加する内容のために論理的な余白を残せるので、仕様書、台本、レビュー記録などに役立ちます。負の増分を指定すると、カウントダウンや逆順の抜粋に使える降順の参照番号になります。増分をゼロにすると、順番より共通の節記号を示したい場合に、すべての行で同じ番号を意図的に繰り返せます。開始値と増分は、公開されている範囲内の整数でなければなりません。整数だけに限定することで、予期しない小数の番号を防ぎ、引用しやすい結果になります。出力前には、最後に生成される値が安全な整数の範囲に収まることも確認します。これらの規則により、ブラウザーでも自動化されたAPI処理でも、長い入力を確定的に扱い、気付かない数値の丸めを防ぎます。

安定した結果を引用やレビューに利用します

区切り文字は、生成した番号と元の行との間に置く短い文字列です。既定のピリオドと空白は一般的な一覧に自然ですが、コード一覧や引用形式に応じて、コロン、タブ、縦線、括弧風の記号も選べます。結果には、すぐにコピーできる結合済みテキストと、各項目を個別に処理するプログラム向けの番号付き行の配列が含まれます。さらに、行数と、実際に使用した開始値、増分、区切り文字も返すため、連携処理は結果の作成条件を正確に記録できます。変換にはネットワーク、言語モデル、時計、乱数を使用しません。応答を組み立てる前に、入力サイズ、行数、区切り文字の長さを制限し、検証します。そのため、再現性が必要な編集工程にも適しています。設定を原文の版とともに保存しておけば、原文が変わらない限り、後から同じ番号付き抜粋を再生成できます。

活用例

コード一覧の行番号を引き継ぐ

大きなソースファイルで使われている行番号から抜粋を始め、レビュー用の安定した参照を作成します。

間隔を空けた仕様項目を準備する

要件を10刻みなどで番号付けし、既存の参照間に後から新しい項目を挿入できるようにします。

引用しやすい書き起こしを作る

抜粋を共有する前に、意図的な空行を含むすべての行へ一貫した参照番号を付けます。

よくある質問

リクエスト1回の料金はいくらですか？

API リクエスト1回の料金は $0.002 です。ブラウザー版でも同じ確定的なアルゴリズムを使用します。

番号を降順にできますか？

はい。増分に -1 や -10 などの負の整数を指定してください。

すべての行を同じ番号にできますか？

はい。増分をゼロにすると、各行で開始値が繰り返されます。

空行は削除されますか？

いいえ。末尾の改行で生じた最後の空行も含め、空行は保持されて番号が付きます。

改行コードは変更されますか？

各環境で同じ出力になるように、CRLF と CR の改行を LF に統一します。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/str/enumerate-lines-custom

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

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

curl -X POST https://api.kit.forhosting.com/str/enumerate-lines-custom \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"First reference\nSecond reference\nThird reference"}'

const res = await fetch("https://api.kit.forhosting.com/str/enumerate-lines-custom", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "First reference\nSecond reference\nThird reference"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/enumerate-lines-custom",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "First reference\nSecond reference\nThird reference"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/enumerate-lines-custom", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"First reference\\nSecond reference\\nThird reference"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"First reference\nSecond reference\nThird reference"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/enumerate-lines-custom", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "text": "First reference\nSecond reference\nThird reference"
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

`max_chars`	100000
`max_lines`	10000
`max_separator_chars`	32

エラー

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

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