text-md-json API
txt・md・csv・json・yaml・コードファイルなどのテキストを Markdown と構造化 md-json に変換します。サーバーローカル処理、1 ファイル最大 10 MB、1 回 $0.0001 です。
- ツール ID
text-md-json- 対応タイプ
txt / md / csv / コードなど 23 拡張子- ファイル上限
10 MB- 料金
$0.0001 / 回- カタログ確認日
text-md-json とは？
text-md-json は Roko ツールサービスのローカルテキスト解析ツールです。txt・md・csv・json・yaml・html や go・py・js・ts などのコードファイルをアップロードすると、Markdown テキストと構造化 md-json（schema_version 1.0）を返します。
処理はサーバー上でローカルに実行されます。md と txt はそのまま Markdown として返却され、コード・CSV・JSON はフェンスコードブロック内にリテラルで保持され、マークアップ解釈は行われません。異種テキスト資産を検索可能で LLM に投入しやすい標準入力へ統一するのに適します。
Roko で最も安価なツールの一つです。1 回 $0.0001、失敗タスクは課金されません。呼び出しには Roko API キーと、トークンへの当該ツール実行権限が必要です。
主な能力
23 のテキスト拡張子
txt・md・csv・json・yaml・html、go・py・js・ts などのソースファイルを解析できます。
忠実な変換
md/txt はそのまま出力。コードとデータファイルはフェンスコードブロック内にリテラル保持されます。
ダブルフォーマット出力
Markdown テキストと md-json 構造を同時に返却。options で選択できます。
最安の単価
1 回 $0.0001。高頻度・大量のテキスト正規化に向いています。
対応入力タイプ
拡張子は現在のツールサービス実行定義によるものです。1 ファイル 10 MB まで、アップロードは 1 ファイルずつです。
| タイプ | 拡張子 | 処理方法 |
|---|---|---|
| テキスト・マークアップ | txt, md | そのまま Markdown として出力 |
| データファイル | csv, json, yaml, yml, xml | フェンスコードブロック内にリテラル保持 |
| ウェブページ | html | フェンスコードブロック内にリテラル保持 |
| ソースコード | go, py, js, ts, tsx, jsx, css, java, c, cpp, h, rs, sql, sh | フェンスコードブロック内にリテラル保持 |
text-md-json 料金
料金は 2026-10-06 の Roko 本番ツールカタログで確認済みです。成功した呼び出しごとに課金され、実際の料金は呼び出し時の決済記録が基準です。
| 課金項目 | 料金 |
|---|---|
| 解析 1 回あたり | $0.0001 |
費用計算例
1 ファイルの通常コスト。ほぼ無視できます。
コーパス全体の正規化の典型的なコスト。失敗タスクは課金されません。
3 ステップで text-md-json を呼び出す
アップロードレスポンスの id を invoke の input.file_id に指定し、解析タスク送信後に task_id で結果を取得します。API キーをフロントエンドに露出しないでください。
1. ファイルをアップロード
curl https://api.rokoapi.com/v1/tools/text-md-json/files \
-H "Authorization: Bearer $API_KEY" \
-F "file=@/path/to/notes.md"2. 解析タスクを送信
curl https://api.rokoapi.com/v1/tools/text-md-json/invoke \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: text-parse-0001" \
-d '{
"input": { "file_id": "FILE_ID" },
"options": { "output_formats": ["markdown", "json"] }
}'3. 結果を取得
curl https://api.rokoapi.com/v1/tasks/$TASK_ID/result \
-H "Authorization: Bearer $API_KEY"invoke は 202 と task_id を返します。解析完了後、結果エンドポイントから md-json（schema_version 1.0）を取得します。Idempotency-Key は 8〜64 文字の英数字・アンダースコア・ハイフン。同一キーのリプレイは元タスクを返し、再課金されません。
利用前に知っておくべき制限
- 1 ファイル 10 MB まで、アップロードは 1 ファイルずつ。拡張子は対応リスト内である必要があります。
- コードとデータファイルはリテラルで保持され、意味単位の並べ替えやクリーニングは行われません。
- 純粋なバイナリファイル（画像・PDF など）は対象外です。file-md-json を使用してください。
- タスク結果には保存期限があります。早めに取得・保存を。API キーをフロントエンドに露出しないでください。
- md と txt はそのまま返却され、ツールは内容フォーマットの検証や修復を行いません。
text-md-json よくある質問
text-md-json はどのファイルタイプに対応？
23 のテキスト拡張子：txt、md、csv、json、yaml、yml、xml、html、go、py、js、ts、tsx、jsx、css、java、c、cpp、h、rs、sql、sh などのソースファイル。
text-md-json の料金は？
2026-10-06 の本番カタログでは 1 呼び出し $0.0001 です。解析失敗は課金されず、実際の料金は呼び出し時の決済記録が基準です。
md-json の出力にはどのフィールドが含まれますか？
結果 JSON には schema_version、markdown（Markdown 全文）、structure_source、capabilities フラグ、warnings 配列が含まれます。file-md-json と同じ構造です。
file-md-json との違いは？
text-md-json はテキスト・コード系ファイルをローカル変換し $0.0001/回。file-md-json は PDF/DOCX/XLSX などのバイナリ文書を変換チャネルで解析し $0.001/回です。
コードファイルは書き換えられますか？
いいえ。コード・CSV・JSON はフェンスコードブロック内にリテラルで保持され、書き換え・解釈・再フォーマットは行われません。
403 や権限エラーが返るのはなぜ？
ツール呼び出しには API キーと、トークンへの当該ツール実行権限が必要です。コンソールでトークンに text-md-json を有効化してから再試行してください。