本文へスキップ

HeyGen Video Translate で動画の聞き取れる話し声を指定言語に翻訳し、リップシンクを合わせます。video_url を指定し、178 の翻訳先から選んで precision または speed を設定します。翻訳したセリフを話しているように見せる人全員の許可が必要です。

最低価格 $0.048/秒

プレイグラウンド

リクエストを送信

クイックスタート

例は、選択中のエンドポイントの公開パラメーター定義から作っています。API キーとサンプル素材を差し替えて、ご自身のサーバーから送信してください。

SDK・連携
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

API 認証

API キーはサーバーの環境変数 SPICY_API_KEY に保存します。Bearer 認証を使用し、JSON リクエストには Content-Type: application/json を指定してください。

Authorization: Bearer $SPICY_API_KEY
サンプル出力このサンプルを使う
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "heygen/video-translate/video-translate",
  "input": {
    "generation_mode": "precision",
    "target_language": "English",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

このモデルの入力スキーマから生成した例です。API はどのリクエストも、同じスキーマで検証します。

入力パラメーター

これらのフィールドは、リクエスト本文の input オブジェクトに指定します。名前と型は API と一致します。デフォルト値の指定がない項目に、デフォルト値があると想定しないでください。

video_urlstring必須料金に影響

話し声のある動画が必須で、上限は 120 秒です。モデルページでは MP4 と WebM を受け付けます。本人に似た声で翻訳したセリフを話しているように見せることについて、出演者の同意を得てください。長さの上限を超える動画は拒否され、料金は発生しません。

デフォルト値
指定なし
制約
minLength:1
format:"uri"
contentMediaType:["video/mp4","video/webm","video/quicktime"]
generation_modestring任意料金に影響

より高品質なリップシンクを目指す場合は、既定の precision を使います。speed はより速い処理を目指し、単価は Precision の半額です。完了までの時間を保証するものではありません。

デフォルト値
"precision"
使用可能な値
"precision""speed"
target_languagestring任意

既定は英語です。2 種類の英語アクセントを含む、178 の基本言語・地域の方言から選択します。翻訳先を変更しても秒単価は同じです。

デフォルト値
"English"
使用可能な値
"English""Spanish""French""Hindi""Italian""German""Polish""Portuguese""Chinese""Japanese""Dutch""Turkish""Korean""Danish""Arabic""Romanian""Mandarin""Filipino""Swedish""Indonesian""Ukrainian""Greek""Czech""Bulgarian""Malay""Slovak""Croatian""Tamil""Finnish""Russian""Afrikaans (South Africa)""Albanian (Albania)""Amharic (Ethiopia)""Arabic (Algeria)""Arabic (Bahrain)""Arabic (Egypt)""Arabic (Iraq)""Arabic (Jordan)""Arabic (Kuwait)""Arabic (Lebanon)""Arabic (Libya)""Arabic (Morocco)""Arabic (Oman)""Arabic (Qatar)""Arabic (Saudi Arabia)""Arabic (Syria)""Arabic (Tunisia)""Arabic (United Arab Emirates)""Arabic (Yemen)""Armenian (Armenia)""Azerbaijani (Latin, Azerbaijan)""Bangla (Bangladesh)""Basque""Bengali (India)""Bosnian (Bosnia and Herzegovina)""Bulgarian (Bulgaria)""Burmese (Myanmar)""Catalan""Chinese (Cantonese, Traditional)""Chinese (Jilu Mandarin, Simplified)""Chinese (Mandarin, Simplified)""Chinese (Northeastern Mandarin, Simplified)""Chinese (Southwestern Mandarin, Simplified)""Chinese (Taiwanese Mandarin, Traditional)""Chinese (Wu, Simplified)""Chinese (Zhongyuan Mandarin Henan, Simplified)""Chinese (Zhongyuan Mandarin Shaanxi, Simplified)""Croatian (Croatia)""Czech (Czechia)""Danish (Denmark)""Dutch (Belgium)""Dutch (Netherlands)""English (Australia)""English (Canada)""English (Hong Kong SAR)""English (India)""English (Ireland)""English (Kenya)""English (New Zealand)""English (Nigeria)""English (Philippines)""English (Singapore)""English (South Africa)""English (Tanzania)""English (UK)""English (United States)""Estonian (Estonia)""Filipino (Philippines)""Finnish (Finland)""French (Belgium)""French (Canada)""French (France)""French (Switzerland)""Galician""Georgian (Georgia)""German (Austria)""German (Germany)""German (Switzerland)""Greek (Greece)""Gujarati (India)""Hebrew (Israel)""Hindi (India)""Hungarian (Hungary)""Icelandic (Iceland)""Indonesian (Indonesia)""Irish (Ireland)""Italian (Italy)""Japanese (Japan)""Javanese (Latin, Indonesia)""Kannada (India)""Kazakh (Kazakhstan)""Khmer (Cambodia)""Korean (Korea)""Lao (Laos)""Latvian (Latvia)""Lithuanian (Lithuania)""Macedonian (North Macedonia)""Malay (Malaysia)""Malayalam (India)""Maltese (Malta)""Marathi (India)""Mongolian (Mongolia)""Nepali (Nepal)""Norwegian Bokmål (Norway)""Pashto (Afghanistan)""Persian (Iran)""Polish (Poland)""Portuguese (Brazil)""Portuguese (Portugal)""Romanian (Romania)""Russian (Russia)""Serbian (Latin, Serbia)""Sinhala (Sri Lanka)""Slovak (Slovakia)""Slovenian (Slovenia)""Somali (Somalia)""Spanish (Argentina)""Spanish (Bolivia)""Spanish (Chile)""Spanish (Colombia)""Spanish (Costa Rica)""Spanish (Cuba)""Spanish (Dominican Republic)""Spanish (Ecuador)""Spanish (El Salvador)""Spanish (Equatorial Guinea)""Spanish (Guatemala)""Spanish (Honduras)""Spanish (Mexico)""Spanish (Nicaragua)""Spanish (Panama)""Spanish (Paraguay)""Spanish (Peru)""Spanish (Puerto Rico)""Spanish (Spain)""Spanish (United States)""Spanish (Uruguay)""Spanish (Venezuela)""Sundanese (Indonesia)""Swahili (Kenya)""Swahili (Tanzania)""Swedish (Sweden)""Tamil (India)""Tamil (Malaysia)""Tamil (Singapore)""Tamil (Sri Lanka)""Telugu (India)""Thai (Thailand)""Turkish (Türkiye)""Ukrainian (Ukraine)""Urdu (India)""Urdu (Pakistan)""Uzbek (Latin, Uzbekistan)""Vietnamese (Vietnam)""Welsh (United Kingdom)""Zulu (South Africa)""English - Your Accent""English - American Accent"

タスクを追跡

HTTP 202 はタスクを受け付けたという意味で、生成が終わったという意味ではありません。返ってきた taskId を保存し、そのタスクの状態を問い合わせてください。結果を待っている間に、同じ内容でタスクを作り直さないでください。

受理レスポンス
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

受理レスポンスには今回の概算料金が含まれるため、アプリのタスク履歴と請求画面に同じ金額を表示できます。

タスクを取得する
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

ポーリングは約 2 秒間隔から始め、徐々に間隔を延ばします。終了状態になったら止めてください。通信が切れたときも、元の taskId で状態を確認します。作成をやり直すときは、同じ冪等キーと同じ本文をそのまま使い回してください。

あるいは、コールバックに知らせてもらう
import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

タスク作成時に callBackUrl を渡せば、完了したレコードが POST で届きます——ポーリングは一切不要です。配信には毎回 X-Webhook-Timestamp、X-Webhook-Signature、X-Webhook-Payload-Version が付きます。署名は taskId.timestamp.sha256(body) に対する HMAC-SHA256(base64)なので、生のバイト列で検証してください。JSON を解析して再度文字列化するとバイト列が変わり、検証は必ず失敗します。失敗した配信は再送されるため同じ taskId が二度届くことがあります。ハンドラーは冪等に。まず 2xx を返し、処理はその後で——応答が遅いと配信失敗として扱われます。

結果を取得

output を読むのは、state が succeeded のときだけにしてください。失敗したときは errorCode、errorMessage、request_id を手がかりに調べます。例に出ている料金や状態は、実際の請求ではありません。

完了レスポンスの例
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "heygen/video-translate/video-translate",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
          "mime": "video/mp4",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

利用可能なファイルは assets[].url からそのまま開くか、ダウンロードできます。API の Authorization ヘッダーは不要です。署名付き URL は expiresAt で失効しますが、保存期間内であればタスクを再取得することで更新できます。処理中または利用できないファイルに URL はありません。署名付き URL は非公開情報として扱ってください。

SDK・連携

アプリ、ターミナル、AI アシスタント、ビジュアルワークフローで SpicyAPI を活用。接続ガイドを選んでください。

ComfyUI で使う

ComfyUI Manager か下のコマンドで SpicyAPI ノードをインストールしたら、キャンバスで HeyGen Video Translate · Translate Video with Lip Sync を検索してください。このノードにはこのページと同じオプションがあり、実行前に価格が表示されます。

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi