开发者
跨产品统一的 API 约定
每款 Castix 产品都提供同一风格的 HTTP API，以 OpenAPI 3.1 描述，并提供 TypeScript 和 Python SDK。
01
版本化
所有接口均位于 /v1 下。不兼容的变更会发布新版本。
02
两种认证方式
发送 Bearer 令牌或 X-API-Key 请求头，按您的技术栈选择。
03
免费报价
每个计费任务都有一个免费的报价接口，让您在运行前就知道价格。
04
记账明细，而非余额
用量以账目条目记录，可逐行对账。
05
签名 webhook
任务和流事件附带 HMAC-SHA256 签名送达。
06
告诉您怎么做的错误信息
每条错误都是一句用您的语言写成、说明如何修复的话。
/v1
示例：为配音任务报价
# Free: price a dubbing job before you run it
curl -X POST https://api.castix.net/v1/dub/quote \
-H "X-API-Key: $CASTIX_KEY" \
-H "Content-Type: application/json" \
-d '{"source_url":"https://example.com/ep01.mp4","target":"fa","speakers":"auto"}'
# 200 OK (illustrative response shape)
{ "quote_id": "q_…", "minutes": 12.4, "currency": "USD", "expires_in": 900 }
完整参考文档将随各产品的开发者预览版开放。欢迎申请抢先体验。