翻訳済み動画にリップシンクを生成

curl --request POST 'https://api.voicecheap.ai/v1/actions/lipsync_create' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"projectId":"project_launch_2026","workId":"5f8423d1-e4c0-4f80-9e3f-eed959389e24","translatedVersionId":"0fa684f3-4997-4d7a-9424-16d1f9ac849c","lipSyncMode":"standard","activeSpeakerDetectionEnabled":false,"requestId":"41321bda-e243-4b6f-96a4-622cd047c991"}'

const input = {
  projectId: 'project_launch_2026',
  workId: '5f8423d1-e4c0-4f80-9e3f-eed959389e24',
  translatedVersionId: '0fa684f3-4997-4d7a-9424-16d1f9ac849c',
  lipSyncMode: 'standard',
  activeSpeakerDetectionEnabled: false,
  requestId: '41321bda-e243-4b6f-96a4-622cd047c991',
};
const response = await fetch('https://api.voicecheap.ai/v1/actions/lipsync_create', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.VOICECHEAP_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(input),
});
const body = await response.json();
if (!response.ok) throw new Error(body.code + ': ' + body.message);
console.log(body);

import os
import requests

response = requests.post(
    "https://api.voicecheap.ai/v1/actions/lipsync_create",
    headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]},
    json={"projectId": "project_launch_2026", "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24", "translatedVersionId": "0fa684f3-4997-4d7a-9424-16d1f9ac849c", "lipSyncMode": "standard", "activeSpeakerDetectionEnabled": False, "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"},
    timeout=120,
)
body = response.json()
if not response.ok:
    raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
print(body)

{
  "data": {
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
    "status": "running",
    "pollAction": "action_request_get",
    "pollAfterSeconds": 5
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

{
  "data": {
    "projectId": "project_launch_2026",
    "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24",
    "translatedVersionId": "0fa684f3-4997-4d7a-9424-16d1f9ac849c",
    "status": "processing"
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

{
  "data": {
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
    "operation": "lipsync_create",
    "createdAt": 1792144800000,
    "updatedAt": 1792144820000,
    "status": "running",
    "pollAfterSeconds": 5
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

{
  "data": {
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
    "operation": "lipsync_create",
    "createdAt": 1792144800000,
    "updatedAt": 1792144820000,
    "status": "completed",
    "resultStored": false,
    "message": "The action completed. Retrieve its output from the corresponding history or resource action."
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

POST

actions

lipsync_create

curl --request POST 'https://api.voicecheap.ai/v1/actions/lipsync_create' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"projectId":"project_launch_2026","workId":"5f8423d1-e4c0-4f80-9e3f-eed959389e24","translatedVersionId":"0fa684f3-4997-4d7a-9424-16d1f9ac849c","lipSyncMode":"standard","activeSpeakerDetectionEnabled":false,"requestId":"41321bda-e243-4b6f-96a4-622cd047c991"}'

const input = {
  projectId: 'project_launch_2026',
  workId: '5f8423d1-e4c0-4f80-9e3f-eed959389e24',
  translatedVersionId: '0fa684f3-4997-4d7a-9424-16d1f9ac849c',
  lipSyncMode: 'standard',
  activeSpeakerDetectionEnabled: false,
  requestId: '41321bda-e243-4b6f-96a4-622cd047c991',
};
const response = await fetch('https://api.voicecheap.ai/v1/actions/lipsync_create', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.VOICECHEAP_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(input),
});
const body = await response.json();
if (!response.ok) throw new Error(body.code + ': ' + body.message);
console.log(body);

import os
import requests

response = requests.post(
    "https://api.voicecheap.ai/v1/actions/lipsync_create",
    headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]},
    json={"projectId": "project_launch_2026", "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24", "translatedVersionId": "0fa684f3-4997-4d7a-9424-16d1f9ac849c", "lipSyncMode": "standard", "activeSpeakerDetectionEnabled": False, "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"},
    timeout=120,
)
body = response.json()
if not response.ok:
    raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
print(body)

{
  "data": {
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
    "status": "running",
    "pollAction": "action_request_get",
    "pollAfterSeconds": 5
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

{
  "data": {
    "projectId": "project_launch_2026",
    "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24",
    "translatedVersionId": "0fa684f3-4997-4d7a-9424-16d1f9ac849c",
    "status": "processing"
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

{
  "data": {
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
    "operation": "lipsync_create",
    "createdAt": 1792144800000,
    "updatedAt": 1792144820000,
    "status": "running",
    "pollAfterSeconds": 5
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

{
  "data": {
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
    "operation": "lipsync_create",
    "createdAt": 1792144800000,
    "updatedAt": 1792144820000,
    "status": "completed",
    "resultStored": false,
    "message": "The action completed. Retrieve its output from the corresponding history or resource action."
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

完了した翻訳バージョンの保存済みメディアからリップシンクを生成します。プランに応じて standard、pro、studio モードを利用でき、通常のメディアクレジットが適用されます。projects_status をポーリングしてください。

POST https://api.voicecheap.ai/v1/actions/lipsync_create

認証と権限

string

必須

このヘッダーに VoiceCheap API キーを指定してください。同じ API キーを Authorization: Bearer で送信することもできます。OAuth アクセストークンは MCP でのみ使用でき、この REST エンドポイントでは使用できません。

必要な権限: translations:write. 有効な有料サブスクリプションが必要です。権限によってチーム内のロール、リソースの所有権、メディアクレジット、プランの制限が変わることはありません。

パラメーター

string

必須

テキスト値。最小文字数: 1. 最大文字数: 200. パターン: ^[^/\\]+$.

string

必須

テキスト値。最小文字数: 1. 最大文字数: 200. パターン: ^[^/\\]+$.

string

必須

テキスト値。最小文字数: 1. 最大文字数: 200. パターン: ^[^/\\]+$.

string

テキスト値。許容値: “standard”, “pro”, “studio”. デフォルト値: “standard”.

boolean

真偽値。デフォルト値: false.

string

トランスポート境界では任意です。省略すると、検証前にサーバーが識別子を補完します。レスポンスを受信できなかった場合に安全に復旧できるよう、固定の UUID v4 を指定してください。形式: “uuid”. パターン: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$.

完全な入力スキーマ

以下の JSON Schema は、ディスカバリーで公開される正確なフィールド名、ネストされた型、デフォルト値、範囲、許容値を保持しています。フィールド間の追加ルールは操作の注意事項に記載されています。

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "pattern": "^[^/\\\\]+$"
    },
    "workId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "pattern": "^[^/\\\\]+$"
    },
    "translatedVersionId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "pattern": "^[^/\\\\]+$"
    },
    "lipSyncMode": {
      "default": "standard",
      "type": "string",
      "enum": ["standard", "pro", "studio"]
    },
    "activeSpeakerDetectionEnabled": {
      "default": false,
      "type": "boolean"
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
      "description": "UUID v4 for this action. Reuse the same ID with identical arguments on retries."
    }
  },
  "required": ["projectId", "workId", "translatedVersionId"],
  "additionalProperties": false
}

冪等性

変更操作ごとに、requestId または Idempotency-Key HTTP ヘッダーに UUID v4 を指定してください。ネットワーク障害後の再試行では、同じ識別子と同一の引数を使用します。両方を指定する場合は一致させる必要があります。保存済みリクエストを再取得しても、操作は再実行されず、月間呼び出し回数も追加で消費されません。失敗または中断したリクエストは自動的には再開されません。すべての変更操作は、再試行時に同じリクエストがまだ実行中であれば、通常の初回実行が同期処理であっても HTTP 202 を返す場合があります。実行が完了していても resultStored が false の場合、再試行では元の結果ではなく、保存済みリクエストの状態を HTTP 200 で返します。出力は対応するドメインの履歴、結果、またはダウンロードアクションで取得してください。

リクエスト例

例に記載されたリソース識別子とメディアキーを、ご自身のアカウントで返された値に置き換えてください。同じ変更操作を再試行する場合は、リクエスト識別子を変更しないでください。

curl --request POST 'https://api.voicecheap.ai/v1/actions/lipsync_create' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"projectId":"project_launch_2026","workId":"5f8423d1-e4c0-4f80-9e3f-eed959389e24","translatedVersionId":"0fa684f3-4997-4d7a-9424-16d1f9ac849c","lipSyncMode":"standard","activeSpeakerDetectionEnabled":false,"requestId":"41321bda-e243-4b6f-96a4-622cd047c991"}'

const input = {
  projectId: 'project_launch_2026',
  workId: '5f8423d1-e4c0-4f80-9e3f-eed959389e24',
  translatedVersionId: '0fa684f3-4997-4d7a-9424-16d1f9ac849c',
  lipSyncMode: 'standard',
  activeSpeakerDetectionEnabled: false,
  requestId: '41321bda-e243-4b6f-96a4-622cd047c991',
};
const response = await fetch('https://api.voicecheap.ai/v1/actions/lipsync_create', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.VOICECHEAP_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(input),
});
const body = await response.json();
if (!response.ok) throw new Error(body.code + ': ' + body.message);
console.log(body);

import os
import requests

response = requests.post(
    "https://api.voicecheap.ai/v1/actions/lipsync_create",
    headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]},
    json={"projectId": "project_launch_2026", "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24", "translatedVersionId": "0fa684f3-4997-4d7a-9424-16d1f9ac849c", "lipSyncMode": "standard", "activeSpeakerDetectionEnabled": False, "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"},
    timeout=120,
)
body = response.json()
if not response.ok:
    raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
print(body)

レスポンス

この操作は実行中に HTTP 202 を返します。requestId を保存し、その識別子と元の操作名を指定して action_request_get をポーリングしてください。ポーリングの状態は running、completed、failed、interrupted です。完了した結果が別のメディアジョブを示す場合は、その操作に対応するステータスまたは出力取得アクションで処理を続けてください。リップシンクを受け入れた後、選択したプロジェクト、ワーク、バージョンの識別子と processing ステータスを返します。

{
  "data": {
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
    "status": "running",
    "pollAction": "action_request_get",
    "pollAfterSeconds": 5
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

{
  "data": {
    "projectId": "project_launch_2026",
    "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24",
    "translatedVersionId": "0fa684f3-4997-4d7a-9424-16d1f9ac849c",
    "status": "processing"
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

{
  "data": {
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
    "operation": "lipsync_create",
    "createdAt": 1792144800000,
    "updatedAt": 1792144820000,
    "status": "running",
    "pollAfterSeconds": 5
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

{
  "data": {
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
    "operation": "lipsync_create",
    "createdAt": 1792144800000,
    "updatedAt": 1792144820000,
    "status": "completed",
    "resultStored": false,
    "message": "The action completed. Retrieve its output from the corresponding history or resource action."
  },
  "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}

結果フィールド

フィールド	説明
`data.projectId`	親プロジェクトの識別子。
`data.workId`	アクセスが許可された言語ワークの識別子。
`data.translatedVersionId`	選択された完了済み翻訳バージョン。
`data.status`	後続リクエストの受け入れ後は processing。出力の完了は別途ポーリングする必要があります。

リクエストの復旧とポーリング

接続が切断された後も同じ識別子を使用してください。resultStored が false の場合は、対応する履歴、結果、またはダウンロードアクションで出力を取得します。進捗を確認するためだけに、別の生成を開始しないでください。

curl --request POST 'https://api.voicecheap.ai/v1/actions/action_request_get' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"requestId":"41321bda-e243-4b6f-96a4-622cd047c991","operation":"lipsync_create"}'

HTTP 200

{
  "data": {
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
    "operation": "lipsync_create",
    "status": "completed",
    "createdAt": 1792144800000,
    "updatedAt": 1792144820000,
    "resultStored": true,
    "result": {
      "projectId": "project_launch_2026",
      "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24",
      "translatedVersionId": "0fa684f3-4997-4d7a-9424-16d1f9ac849c",
      "status": "processing"
    }
  }
}

操作の注意事項

選択した翻訳バージョンは completed 状態で、保存済みの動画 URL と音声 URL の両方が必要です。呼び出し元が指定した動画 URL や音声 URL は受け付けません。
lipSyncMode のデフォルトは standard で、standard、pro、studio を受け付けます。プランのアクセス権、長さ、メディアクレジットの確認は引き続き適用されます。activeSpeakerDetectionEnabled のデフォルトは false です。
実行に時間がかかるアクションです。まず action_request_get をポーリングしてこの操作のハンドラー結果を取得し、その後 projects_status または projects_get をポーリングしてリップシンクの完了と出力 URL を確認してください。
ハンドラーの結果にはリップシンクの jobId や動画 URL は含まれません。projects_get.translations[].lipSync から最新エントリと履歴の公開情報を取得できます。
認証済み実行者には引き続きプロジェクトのアクセス権チェックが適用されます。プロジェクトの請求先所有者であっても、他のメンバーの非公開プロジェクトへのアクセス権は付与されません。

使用量

正常に実行された呼び出しごとに、月間 API/MCP 呼び出し回数を 1 回消費します。メディアクレジットと、その操作固有の生成枠も適用されます。

エラー

HTTP ステータス	コード	意味または対処方法
400	`BAD_REQUEST`	指定された保存済み動画の長さが未設定、無効、またはモードの長さ上限を超えています。
400	`CREDENTIAL_IN_QUERY`	access_token または api_key クエリパラメーターに認証情報が指定されています。認証情報はヘッダーで送信してください。
400	`IDEMPOTENCY_CONFLICT`	Idempotency-Key ヘッダーとリクエストボディの requestId は一致させる必要があります。
400	`INVALID_REQUEST_ID`	UUID v4 の requestId または Idempotency-Key を指定してください。
400	`TRANSLATION_NOT_READY`	選択したバージョンが完了していないか、保存済みの動画または音声がありません。
400	`VALIDATION_ERROR`	スキーマに従って入力を修正してください。無効な値や整合性のない値は実行前に拒否されます。
401	`API_KEY_EXPIRED`	API キーの有効期限が切れています。
401	`INVALID_API_KEY`	有効期限内の有効な API キーを指定してください。
401	`INVALID_CREDENTIAL`	Authorization ヘッダーの形式が不正、または x-api-key と競合しています。
401	`MISSING_CREDENTIAL`	利用可能なヘッダー認証情報が指定されていないか、4096文字を超えています。
401	`UNAUTHORIZED`	現在のアカウントには、このモードへのアクセス権、リップシンクの利用可能枠、または十分なメディアクレジットがありません。
401	`USER_NOT_FOUND`	認証情報に対応するアカウントはすでに存在しません。
403	`ACCOUNT_UNAVAILABLE`	操作を実行するアカウントまたは請求対象アカウントが利用できないか、削除中です。
403	`AMBIGUOUS_TEAM_API_KEY`	認証情報のユーザーが複数のチームに属しているため、課金コンテキストが曖昧です。
403	`FORBIDDEN`	認証済み実行者は、このプロジェクトにアクセスできません。
403	`INSUFFICIENT_SCOPE`	必要な権限をすべて付与するか、別の認証情報を使用してください。
403	`INTEGRATION_PLAN_UNSUPPORTED`	アカウントの連携上限を確認できませんでした。
403	`SUBSCRIPTION_REQUIRED`	有効な有料サブスクリプションを使用してください。
403	`TEAM_OWNER_NOT_FOUND`	実効的なチームオーナーのアカウントが見つかりませんでした。
404	`PROJECT_NOT_FOUND`	アクセス可能なアカウントにこのプロジェクトは存在しません。
404	`TRANSLATION_NOT_FOUND`	workId は、このプロジェクトに属する言語別ワークを指していません。
404	`TRANSLATION_VERSION_NOT_FOUND`	translatedVersionId は、選択した言語別ワークに属していません。
409	`CONCURRENT_ACTION_LIMIT_REACHED`	このアカウントでは、すでに 10 件の連携アクションが実行中です。新しいアクションを開始する前に、既存のリクエストをポーリングしてください。
409	`CONFLICT`	リップシンクを開始する前に、選択した翻訳メディアが変更されました。
409	`IDEMPOTENCY_CONFLICT`	識別子を再利用する場合は、同じ操作と引数でのみ使用してください。
429	`INTEGRATION_MONTHLY_LIMIT_REACHED`	月次リセットを待つか、プランを変更してください。
429	`INTEGRATION_RATE_LIMIT_REACHED`	Retry-After がある場合は指定時間を待ち、バックオフを使用してください。
500	`INTERNAL_ERROR`	変更操作を再試行するか判断する前に、保存済みリクエストの状態とリソースの履歴を確認してください。
503	`ACTION_RESULT_UNAVAILABLE`	アクションは実行されましたが、結果を保存できませんでした。新しい生成を開始する前に、保存済みリクエストの状態とリソース履歴を確認してください。
503	`SERVER_RESTARTING`	サーバーが再起動中です。少し待ってから再試行し、変更操作では同じリクエスト識別子を使用してください。

{
  "code": "INSUFFICIENT_SCOPE",
  "message": "This credential does not permit the requested action.",
  "status": 403,
  "details": {
    "requiredScopes": ["translations:write"]
  }
}

概要

ディスカバリー

アカウント

使用量とアクティビティ

設定と通知

チーム

プロジェクト

翻訳と吹き替え

文字起こしと編集

テキスト読み上げ

読み上げ音声

吹き替え音声

文字起こし

字幕とキャプション

画像

サムネイル

フォルダー

用語集

Webhook

公開

リクエストの状態

OAuth と MCP プロトコル

翻訳済み動画にリップシンクを生成

認証と権限

パラメーター

冪等性

リクエスト例

レスポンス

結果フィールド

リクエストの復旧とポーリング

操作の注意事項

使用量

エラー

​認証と権限

​パラメーター

​冪等性

​リクエスト例

​レスポンス

​結果フィールド

​リクエストの復旧とポーリング

​操作の注意事項

​使用量

​エラー

認証と権限

パラメーター

冪等性

リクエスト例

レスポンス

結果フィールド

リクエストの復旧とポーリング

操作の注意事項

使用量

エラー