オープン API

クイックスタート

1. 1. 認証：キーをリクエストヘッダーに入れる

   curl https://smilesub.xixiaotech.cn/api/v1/me \
     -H "Authorization: Bearer sk_live_あなたのキー"
   
   # どちらでも構いません（多くのゲートウェイで使われる書き方）：
   #   -H "X-API-Key: sk_live_あなたのキー"

   キーを URL パラメータに書く方法はサポートしていません。URL はアクセスログ、ブラウザ履歴、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 とバイリンガルは回数課金）
   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）。 Web 版の本番フローも同じで、サーバーが動画全体を扱うことは通常ありません。

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": "ja",
       "target_languages": ["en", "ko"],
       "output": "srt"
     }'
   # → { "success": true, "data": { "translations": { "en": { "content": "…" }, "ko": { "content": "…" } },
   #                                "credits_charged": 6, "balance_after": 994 } }

エンドポイント一覧