文件

文件中心

客戶進來應該先看懂統一串接方式:呼叫 MidSync API、依模型補上可用參數、建立任務後用 callback 收結果。確認流程後,再用簡潔試算器估價並直接打開對應文件。

價格試算器

用下拉欄位快速選模型、時長、解析度等條件,直接看預估點數。

操作簡潔

依模型切換必要欄位

先試算再串接

打開

估價 API 文件

直接看 `/unified-video/quote` 怎麼用、要帶哪些欄位、會回什麼。

request 欄位說明

response 欄位說明

前端串接注意事項

打開

建立任務 API 文件

直接看 `/unified-video/generate` 怎麼送、要保存什麼,以及 callback 應怎麼接。

建立任務參數

回應欄位

callback / fallback 說明

打開

逐支 API 文件

每一支 API 都各自有單獨頁面,裡面會直接說明用途、參數、回應欄位與使用方式。

查看 API 文件

整合指南

產品

這份指南定義 MidSync 前端應該如何做成產品體驗,而不是單純的 raw API 表單。

多個 API 入口的整合指南

影片模型

影音

取得影片模型的 runtime metadata,讓前端知道有哪些模型、欄位、選項與限制可以安全渲染。

GET /unified-video/models

影片估價

影音

用與 generate 相同的 request body,在正式送出前預先取得點數估價。

POST /unified-video/quote

影片建立任務

影音

在客戶接受設定與價格後,真正建立影片任務。

POST /unified-video/generate

影片狀態

影音

當你需要手動查詢、fallback 或補救流程時,用這支 API 查影片任務狀態。

GET /unified-video/:taskId/status

用量紀錄

計費

取得逐筆用量歷史,適合做帳務表格與明細頁。

GET /v1/usage/logs

用量摘要

計費

取得彙總用量數據,適合做儀表板與帳務摘要卡片。

GET /v1/usage/summary

Seedance 1.5 Pro

模型

目前最適合做文字轉影片與圖片轉影片的客戶入口模型。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用

Kling 2.5 Turbo

模型

一個模型同時支援文字轉影片與圖片轉影片,價格主要看時長。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用

Kling 2.6 T2V

模型

專門做文字轉影片的 Kling 2.6,音訊會直接影響價格。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用

Kling 2.6 I2V

模型

專門做圖片轉影片的 Kling 2.6,至少需要 1 張圖。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用

Kling 3.0

模型

同時支援單鏡頭、多鏡頭、模式切換與元素參考的 Kling 模型。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用

Hailuo 2.3 Pro

模型

只支援圖片轉影片,且可用組合非常少的 Hailuo 變體。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用

Hailuo 2.3 Standard

模型

只支援圖片轉影片,且固定較低價格的 Hailuo 變體。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用

Veo 3.1

模型

Veo 的高品質版本,與 fast 共用同一組前端欄位。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用

Veo 3.1 Fast

模型

Veo 的較低價版本,欄位與 veo-3.1 相同。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用

Runway

模型

同時支援文字轉影片與單圖轉影片,但品質與時長組合有限。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用

Grok Video

模型

可做文字轉影片與圖片轉影片,且價格會依時長與解析度動態變化。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用