跳至內容

Sync Lipsync 3

整合

模型 id sync-lipsync/v3
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/sync-lipsync/v3?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/avatar/talking_avatar_loop.mp4",
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

像範例一樣的檔案: $1.334 1,334 API 點數 您的檔案會在執行前計量 在此頁面執行

取得 API 金鑰
Sync Labs 唇形同步與虛擬角色 唇形同步 #lipsync#dubbing#localization

將任何說話影片的嘴唇重新配合新的音軌。

Sync Labs · 影片

您的第一個結果會顯示在這裡

在下方建立請求,並使用您的 API 金鑰執行。輸出會複製到我們的儲存空間,可永久保留或免費保留 7 天。

建立請求

控制項是根據模型結構描述生成的。變更設定時,程式碼和價格會同步更新。

•必填 video_url
拖放檔案,或

指向輸入影片的 URL。

•必填 audio_url
拖放檔案,或

輸入音訊位置,以 URL 表示。

sync_mode 預設 cut_off

處理音訊與影片長度差異的唇形同步模式。

進階 options

在此設定額外的 Sync.so 生成行為;任何提供的 options.sync_mode 優先於頂層 sync_mode 值。

POST /run/sync-lipsync/v3?wait=20 報價 → $1.334
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/sync-lipsync/v3?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/avatar/talking_avatar_loop.mp4",
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

執行此請求

您的金鑰會保留在此瀏覽器中:只會傳送至 Doitong API,且只有在勾選「記住」時才會儲存至 localStorage。 取得 API 金鑰

關於 Sync Lipsync 3

Sync Labs 的 lipsync-3 會取代影片中人物的嘴部動作,使其符合新的語音軌,適用於 配音、廣告在地化,以及後期修正台詞。音訊與影片長度不同時,可選擇裁切、循環、來回播放、 填入靜音或重新映射。

參數

請傳送標準名稱或原生名稱其中之一,不要同時傳送兩者。 標準名稱

名稱類型 預設值允許值 說明
video_url必填 video
類型url · video
指向輸入影片的 URL。
audio_url必填 audio
類型url · audio
輸入音訊位置,以 URL 表示。
sync_mode選填
類型enum
預設值cut_off
cut_offloopbouncesilenceremap
處理音訊與影片長度差異的唇形同步模式。
options選填
類型object
在此設定額外的 Sync.so 生成行為;任何提供的 options.sync_mode 優先於頂層 sync_mode 值。
options.sync_mode選填
類型enum
cut_offloopbouncesilenceremap
頂層 sync_mode 的覆寫值,指定輸入音訊與影片長度不同時的處理方式。
options.model_mode選填
類型enum
lipsfaceheadlipsyncemotiontalking_head
編輯區域選擇,主要適用於 react-1,用於指定模型修改的區域。
options.prompt選填
類型enum
happysadangrydisgustedsurprisedneutral
主要由 react-1 使用的情緒指引,用於引導生成。
options.temperature選填
類型number | null
0 – 1
表現力設定;對原生管理此功能的 sync-3 沒有作用。對使用此設定的模型,0 代表最低唇形同步表現力,1 代表最高。
options.active_speaker_detection選填
類型object
用於識別包含多人的影片中目前說話者的設定。
options.active_speaker_detection.auto_detect選填
類型boolean | null
自動識別目前說話者,並對該人物套用生成。
options.active_speaker_detection.v3選填
類型boolean | null
使用 v3 說話者偵測功能。
options.active_speaker_detection.use_v2選填
類型boolean | null
已棄用的 v2 說話者偵測設定。
options.active_speaker_detection.frame_number選填
類型integer | null
≥ 0
用於手動選取說話者座標的影格索引。
options.active_speaker_detection.coordinates選填
類型integer[]
2 – 2 items
以 [x, y] 表示的臉部參考點,指定影格 frame_number 中說話者的位置。
options.active_speaker_detection.bounding_boxes選填
類型array[]
每個影格偵測到的臉部邊界框,以 [x1, y1, x2, y2] 表示。
options.active_speaker_detection.bounding_boxes_url選填
類型string | null
提供每個影格邊界框的 JSON 檔案 URL。
options.active_speaker_detection.face_image選填
類型string | null
以 Base64 編碼的臉部圖像,用於手動選取說話者。
options.occlusion_detection_enabled選填
類型boolean | null
遮擋偵測開關;由於 sync-3 會自動偵測,因此對其沒有作用;其他情況下,此設定控制生成是否包含遮擋偵測。
必填 標準名稱,也可使用

檔案參數接受公開的 https:// URL、最大 10 MB 的 data: URI,或上傳檔案的 file_url。 檔案

輸出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sync-lipsync/v3",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1334,
    "usd": "1.334",
    "charged": 1334,
    "refunded": 0
  },
  "input": {
    "video": "https://content.doitong.com/video/showcase/v3/avatar/talking_avatar_loop.mp4",
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
您的檔案,由您選擇每個 outputs[].url 都是儲存空間中的副本:可永久保留(按 GB-月計費),或免費保留 7 天;可透過帳戶設定或 ?storage= 設定。
所有模型使用相同結構圖片、影片和音訊皆包含 type、url、content_type、width、height 和 duration。output 是模型自己的結果物件。
輸出欄位
video
object {url, content_type, file_name, file_size}模型產生的影片。

更多模型:唇形同步與虛擬角色

給 AI 代理程式:此頁面的 Markdown 位於 https://doitong.com/zh-TW/developers/models/sync-lipsync/v3.md. 所有模型與指南: https://doitong.com/developers/llms.txt