Arabic Pipeline API

Arabic Pipeline API

アラビア語のテキスト、音声、文書を対象とした従量課金ユーティリティです。x402 を通じて Base 上の USDC で販売されています。

API キー不要。アカウント不要。サブスクリプション不要。 最初のリクエストには 402 Payment Required が返されます。クライアントが支払いに署名して再試行すると、資金はプロバイダーのウォレットに入金されます。プロトコルはこれだけです。だからこそ、このサービスでは間に決済処理業者を挟まず、プロバイダーに直接支払うことができます。

url https://payapi.market/mcp

稼働中のエンドポイント

	URL
REST API	https://arabic-pipeline.arabic-pipeline.workers.dev
MCP サーバー（ストリーミング可能な HTTP）	https://arabic-pipeline-mcp.arabic-pipeline.workers.dev/
OpenAPI	https://arabic-pipeline.arabic-pipeline.workers.dev/openapi.json
x402scan	https://www.x402scan.com/server/298e1e2b-3f5c-4890-9791-6d063fd20931
MCP レジストリ	io.github.skypantherr/arabic-pipeline（v0.1.0、稼働中）
ソース	https://github.com/skypantherr/arabic-pipeline

MCP サーバーは、同じ 4 つの機能をツールとして公開します。それぞれに個別の x402 支払いが必要です（text_metrics、text_normalize、audio_transcribe、doc_extract）。

エンドポイント

ルート	機能	価格	提供コスト
GET /text/metrics?text=…	件数、言語の割合、文・単語の統計、読了時間を算出します	$0.002	$0（純粋なコード処理）
POST /text/metrics	同上。JSON 本文を使用します	$0.002	$0（純粋なコード処理）
POST /text/normalize	アラビア語テキストを整形します：タシュキール／タトウィールの処理、アリフ／ヤー／ター・マルブータの統一、数字の統一、双方向制御文字の除去、空白の統合	$0.005	$0（純粋なコード処理）
POST /audio/transcribe	音声 → クリーンなテキスト（アラビア語または英語）	$0.02	モデル呼び出し
POST /doc/extract	文書画像／PDF → 構造化フィールド（レシート、請求書、ID）	$0.03	モデル呼び出し

POST /text/normalize は mode を受け取ります。

• light — ロスレス：空白、数字の統一、双方向テキストの整形のみ。
• search — light に加え、タシュキールの除去と文字の統一（أإآ→ا、ى→ي、ة→ه）。
• index — search に加え、句読点を除去します（重複排除／インデックスキーとして使用します）。

お試しください

# 1. Any paid route answers 402 with a payment challenge
curl -i https://arabic-pipeline.arabic-pipeline.workers.dev/text/normalize \
  -H 'content-type: application/json' \
  -d '{"text":"مُحَمَّدٌ عَلِيّ","mode":"search"}'

# 2. Free routes (no payment needed)
curl https://arabic-pipeline.arabic-pipeline.workers.dev/openapi.json
curl https://arabic-pipeline.arabic-pipeline.workers.dev/

x402 による支払いの仕組み（エージェント向け）

1. 支払いヘッダーなしでルートを呼び出すと、402 Payment Required が返されます。
2. レスポンスには base64 の PAYMENT-REQUIRED ヘッダーが含まれます。また、本文の accepts[] エントリーに、支払い方法（ネットワーク、アセット、価格、payTo）が記載されます。
3. エントリーを 1 つ選び、支払いに署名してから、 PAYMENT-SIGNATURE ヘッダー（base64 の支払いペイロード）を付けてリクエストを再試行します。
4. サーバーが支払いを検証して決済し（ファシリテーター経由）、実際の結果と領収情報を含む PAYMENT-RESPONSE ヘッダーを返します。

各操作の x-payment-info を含む、機械可読な完全な契約は GET /openapi.json にあります。

決済

• ネットワーク：Base mainnet（eip155:8453）、アセット：USDC （0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）。
• 支払いの検証と決済には、公開 x402 ファシリテーター （https://x402.dexter.cash — アカウント不要、手数料なし）を使用します。ファシリテーターは購入者が署名した支払いを実行するだけで、資金を保有することはありません。
• 決済先：0x05523af5bd166816D1418Ebf7D6371e1fFB1D2e6。

モデルのエンドポイント

/audio/transcribe は gemini-3.5-transcribe を使用し、/doc/extract は JSON レスポンススキーマで gemini-3.6-flash を使用します。どちらのモデル名も設定可能です（GEMINI_TRANSCRIBE_MODEL、GEMINI_VISION_MODEL）。2 つのテキストエンドポイントは純粋な計算処理で、提供コストはかかりません。

ローカル開発

npm install
cp .dev.vars.example .dev.vars   # then add GEMINI_API_KEY
npm run dev                       # wrangler dev
npm test                          # vitest
npm run typecheck

デプロイ

DEPLOY.md を参照してください。簡単に言うと、npm run login → npm run secret → npm run deploy → リスティングを登録します。

このリポジトリから 2 つの Workers をデプロイします。

npm run deploy              # REST API  -> arabic-pipeline.arabic-pipeline.workers.dev
npx wrangler deploy -c wrangler.mcp.toml   # MCP server -> arabic-pipeline-mcp.arabic-pipeline.workers.dev

ライセンス

MIT。