GET /v1/route

同一个账号，按区域执行

网站统一提供中英文界面，共用账号、工作区、API 密钥和预付余额。上传录音或提交文字前，先向调度 API 获取区域地址。

先确定区域，再提交内容

调度依据接入网络：中国大陆网络选择中国区，其他已识别国家或地区选择美国区。调度接口不接收文本或音频。服务端接入时，识别的是你服务器的网络位置，不一定是最终用户的位置；界面语言不参与调度。

调度接入示例

# 1. Ask the scheduler before sending text or audio (requires jq).
CASTREADER_API_BASE=$(curl --fail-with-body --silent --show-error \
  'https://voice.castreader.com/v1/route' \
  -H "Authorization: Bearer $CASTREADER_API_KEY" | jq -er '.base_url')

# 2. Inspect the selected region's capabilities.
curl --fail-with-body "$CASTREADER_API_BASE/models" \
  -H "Authorization: Bearer $CASTREADER_API_KEY"

# 3. Upload authorized recordings and generate at this base URL.
# Keep the returned job/request ID and the same Idempotency-Key for retries.

# Recover an existing task's original regional endpoint.
curl --fail-with-body --get \
  'https://voice.castreader.com/v1/route' \
  --data-urlencode "job_id=$CASTREADER_JOB_ID" \
  -H "Authorization: Bearer $CASTREADER_API_KEY"

返回字段与任务归属

JSON

{
  "region": "cn",
  "network_region": "cn",
  "base_url": "https://voice.castreader.cn/v1",
  "console_url": "https://voice.castreader.cn/api/console",
  "expires_in": 300,
  "voice_data_failover": false,
  "languages": [
    "zh",
    "en"
  ]
}

查询时最多传入 voice_id、request_id、job_id 中的一个。已有任务和下载保持原区域。若使用另一地区的声音发起新生成，返回 regional_voice_required，需在当前区域重新注册已授权声音；系统不会自动复制录音。

路由可缓存至 expires_in 指定的秒数。同一操作的重试保持原端点。网络位置无法确定或区域不可用时应等待重试，不要把内容改发到另一地区。

一个钱包，两种充值方式

银行卡 Stripe 与支付宝充值计入同一份以美元计量的 API 余额。切换语言不会转移资金，也不会创建第二个账号。支付宝按公示套餐价 ¥7 获得 $1 API 额度。CastReader 阅读订阅仍独立计费。

统一管理与区域存储

账号、权限、账单及资源元数据由美国控制服务统一管理；文本、参考录音、模型声音文件和生成音频保存在所选区域。英文可选 v3 时间戳，中文、日文等语言不进行时间戳对齐。

继续阅读 API 文档 →