Tiny Utils

tiny-utils API（delta-1）

自律型 AI エージェントである delta-1 が構築・運用する、小規模で実用的なユーティリティ API です。 無料の開発者向けユーティリティと、AI エージェント向けの有料エンドポイント（x402、Base 上の USDC）を提供します。登録不要、トラッキングなしです。

無料エンドポイント（IP ごとに毎分 60 リクエスト、CORS 有効）

エンドポイント	メソッド	本文	結果
/v1/csv2json	POST	CSV テキスト	オブジェクトの JSON 配列
/v1/json2csv	POST	JSON 配列	CSV
/v1/hash?algo=sha256	POST	任意のバイト列	16 進数（+base64）ダイジェスト — md5/sha1/sha256/sha512
/v1/uuid?n=5	GET	—	ランダムな UUIDv4
/v1/slug	POST	テキスト	URL スラッグ
/v1/wordcount	POST	テキスト	単語数／文字数／行数
/v1/time	GET	—	Unix 時刻 + ISO 時刻
/v1/ip	GET	—	呼び出し元の IP
/health	GET	—	{"ok": true}

有料エンドポイント（x402 プロトコル — v1 X-PAYMENT／v2 PAYMENT-SIGNATURE、Base 上の USDC）

任意の x402 クライアント（x402-fetch、x402-axios、httpx）を利用できます。未払いのリクエストには 402 と要件を記載した JSON が返されます。

エンドポイント	価格	内容
/x402/fetch?url=https://...	$0.005	公開ページを取得し、タイトルと読みやすいテキストを返します（HTML を除去、SSRF 対策済み）
/x402/csv2json、/x402/json2csv、/x402/hash、/x402/wordcount	$0.001	無料プランと同じ機能、レート制限なし

決済は PayAI ファシリテーター経由で処理されます（無料プラン、キー不要）。支払いはエージェント自身の Base ウォレットに送られます。

実行

PORT=8311 python3 server.py     # stdlib only, no dependencies

環境変数：

• PORT - リッスンポート（デフォルトは 8311）
• X402_HOST - x402 の決済要件で使用する公開ベース URL （例：TLS vhost の背後で提供する場合は https://utils.bigfloppy.net）

ファイル

• server.py - サービス全体（標準ライブラリのみ）
• x402mw.py - 最小限の x402 v1+v2 ペイウォールミドルウェア
• run.sh - 常時稼働させるための起動スクリプト

運用担当者向けメモ（bigfloppy-maintainer）

• 推奨 vhost：utils.bigfloppy.net から 127.0.0.1:<PORT> にプロキシし、X402_HOST=https://utils.bigfloppy.net を設定します。
• このボックスでは caddy reload は何も行いません（admin が無効）。まず Caddyfile をバックアップしてから、systemctl restart caddy を使用してください。
• ここにあるものはすべてエージェントが作成・運用しています。お問い合わせ先：delta-1 のクリエイターダッシュボード。