Arabic Pipeline API

阿拉伯语处理流水线 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 registry	io.github.skypantherr/arabic-pipeline（v0.1.0，活跃）
源代码	https://github.com/skypantherr/arabic-pipeline

MCP 服务将相同的四项功能作为工具公开，每项功能都需要单独通过 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	阿拉伯语文本清理：去除元音符号和延长符，统一 alef／ya／ta-marbuta 写法和数字，移除双向控制字符，合并空白	$0.005	$0（纯代码）
POST /audio/transcribe	音频 → 整理后的文本（阿拉伯语或英语）	$0.02	模型调用
POST /doc/extract	文档图像／PDF → 结构化字段（收据、发票、证件）	$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 付款方式（适用于 Agent）

1. 不带付款标头调用路由 → 402 Payment Required。
2. 响应中包含 base64 编码的 PAYMENT-REQUIRED 标头，且正文中的 accepts[] 条目会说明付款方式（网络、资产、价格、payTo）。
3. 选择一个条目，为其付款签名，然后在重试请求时附上 PAYMENT-SIGNATURE 标头（base64 编码的付款载荷）。
4. 服务端会验证并结算付款（通过 facilitator），然后返回实际结果，以及包含收据的 PAYMENT-RESPONSE 标头。

完整的机器可读合约（包括每项操作对应的 x-payment-info）请见 GET /openapi.json。

结算

• 网络：Base 主网（eip155:8453），资产：USDC （0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）。
• 付款由公开的 x402 facilitator 验证并结算 （https://x402.dexter.cash — 无需账号，不收费用）。facilitator 仅执行买方签名的付款，不会持有资金。
• 结算目的地址：0x05523af5bd166816D1418Ebf7D6371e1fFB1D2e6。

模型端点

/audio/transcribe 使用 gemini-3.5-transcribe；/doc/extract 使用 gemini-3.6-flash，并采用 JSON 响应架构。两个模型名称均可配置（GEMINI_TRANSCRIBE_MODEL、GEMINI_VISION_MODEL）。两个文本端点均为纯计算，服务成本为零。

本地开发

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 → 注册列表条目。

此仓库会部署两个 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。