开放 API

快速接入

1. 1. 鉴权：把密钥放进请求头

   curl https://smilesub.xixiaotech.cn/api/v1/me \
     -H "Authorization: Bearer sk_live_你的密钥"
   
   # 也可以（很多网关的习惯写法）：
   #   -H "X-API-Key: sk_live_你的密钥"

   不支持把密钥写在 URL 参数里：URL 会进 access log、浏览器历史和 Referer， 一个长期有效的密钥出现在日志里就等于泄露。

2. 2. 典型流程（音频 → 字幕 → 下载）

   # ① 上传音频并建任务（注意 Content-Length 必须带，请求体是裸二进制不是 multipart）
   curl -X POST "https://smilesub.xixiaotech.cn/api/v1/subtitles?language=zh" \
     -H "Authorization: Bearer sk_live_你的密钥" \
     -H "Content-Type: audio/wav" \
     -H "X-Filename: product-intro.wav" \
     --data-binary @audio.wav
   # → { "success": true, "data": { "file_id": "…", "status": "queued", "credits_charged": 30 } }
   
   # ② 轮询状态，直到 has_subtitles 为 true
   curl "https://smilesub.xixiaotech.cn/api/v1/tasks/FILE_ID" \
     -H "Authorization: Bearer sk_live_你的密钥"
   
   # ③ 下载字幕（srt/vtt/txt 免费；ass、bilingual 按次计费）
   curl -o out.srt "https://smilesub.xixiaotech.cn/api/v1/tasks/FILE_ID/export?format=srt" \
     -H "Authorization: Bearer sk_live_你的密钥"

   请先自己用 ffmpeg 抽出音频再上传（ffmpeg -i in.mp4 -vn -ac 1 -ar 16000 out.wav）。 网页端也是这么做的——服务器因此从不经手整段视频。

3. 3. 同步翻译（多语种一次提交）

   curl -X POST https://smilesub.xixiaotech.cn/api/v1/translate \
     -H "Authorization: Bearer sk_live_你的密钥" \
     -H "Content-Type: application/json" \
     -d '{
       "srt": "1\n00:00:00,000 --> 00:00:03,000\n你好\n",
       "source_language": "zh",
       "target_languages": ["en", "ja"],
       "output": "srt"
     }'
   # → { "success": true, "data": { "translations": { "en": { "content": "…" }, "ja": { "content": "…" } },
   #                                "credits_charged": 6, "balance_after": 994 } }

端点清单