外掛任務

除了 Midjourney，閘道也內建外掛渠道：Suno 音樂、Kling/海螺/Vidu 影片、Veo、即夢等。呼叫方式分為兩類：

模式	適用對象	流程
通用任務	大部分外掛（以模型驅動）	`POST /v1/tasks` 提交 → `GET /v1/tasks/{id}` 輪詢 → 取得產物
原生轉傳	Suno、Kling 等	走廠商原生路徑 `/suno/`、`/kling/`——參數與廠商官方 API 一致

通用任務端點

提交任務

POST /v1/tasks

curl https://test.kailin.com.cn/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model": "hailuo-video",
    "prompt": "Bioluminescent jellyfish in the deep ocean",
    "duration": 6
  }'

參數	類型	必填	說明
`model`	string	是	外掛模型名稱——決定路由到哪個外掛
其餘欄位	-	否	外掛各自的參數（prompt、圖片網址、時長、長寬比等），原樣轉傳

回應：

{ "task_id": "3e2c1a9b-xxxx-xxxx-xxxx" }

查詢任務

GET /v1/tasks/{task_id}

curl https://test.kailin.com.cn/v1/tasks/3e2c1a9b-xxxx \
  -H "Authorization: Bearer sk-your-token"

{
  "task_id": "3e2c1a9b-xxxx",
  "status": "SUCCESS",
  "data": {
    "video_url": "https://oss.example.com/v/xxx.mp4"
  }
}

status 取值：SUBMITTED / IN_PROGRESS / SUCCESS / FAILURE（部分外掛會擴充自己的狀態值——以實際回應為準）。

任務產物

端點	說明
`GET /v1/tasks/{key}/artifacts`	列出任務的產物清單（音訊/影片/圖片檔案）
`GET /v1/tasks/{key}/artifacts/{artifact_key}/content`	下載指定產物（二進位串流）

curl "https://test.kailin.com.cn/v1/tasks/3e2c1a9b/artifacts" \
  -H "Authorization: Bearer sk-your-token"

curl "https://test.kailin.com.cn/v1/tasks/3e2c1a9b/artifacts/audio-0/content" \
  -H "Authorization: Bearer sk-your-token" \
  --output track.mp3

Suno（音樂）

SunoAPI 格式轉傳：

端點	說明
`POST /suno/submit/{action}`	提交任務——`action` 為 SunoAPI 動作（`music`、`lyrics`、`caption` 等），參數依 SunoAPI 文件
`GET /suno/fetch/{task_id}`	查詢單一任務
`POST /suno/fetch`	批次查詢——body 傳 `["id1", "id2"]`

curl https://test.kailin.com.cn/suno/submit/music \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{ "prompt": "An upbeat summer pop song", "make_instrumental": false, "wait_audio": false }'

data 欄位為 Suno 原始任務結構。設定 wait_audio: true 時，呼叫會等到音訊就緒後直接回傳音訊網址。

Kling（影片）

Kling 原生格式轉傳：

端點	說明
`POST /kling/v1/videos/text2video`	文生影片
`POST /kling/v1/videos/image2video`	圖生影片
`GET /kling/v1/videos/text2video/{task_id}`	查詢文生影片任務
`GET /kling/v1/videos/image2video/{task_id}`	查詢圖生影片任務

curl https://test.kailin.com.cn/kling/v1/videos/text2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model_name": "kling-v1",
    "prompt": "Morning forest, sunlight through the leaves",
    "duration": 5,
    "mode": "std"
  }'

參數與回應結構與 Kling 官方 API 一致（model_name / mode / aspect_ratio / cfg_scale 等）——只要把網域換成閘道位址即可。

內建外掛總覽

以下外掛都透過 POST /v1/tasks 提交（model 填對應名稱），並以 GET /v1/tasks/{task_id} 查詢。參數對應上游廠商 API，原樣轉傳：

外掛	能力	關鍵參數
Hailuo Video	文/圖生影片（MiniMax 海螺）	`prompt`、首幀圖片、時長
Hailuo H3	H3 模型影片任務	同上
Google Veo	Veo 影片任務（Gemini/Vertex 渠道）	`prompt`、時長、長寬比
Doubao	即夢影片/圖片（字節豆包）	`prompt`、圖片、解析度
Alibaba Bailian	通義萬相圖片/影片任務	`prompt`、模型、尺寸
xAI	Grok Imagine 影片（生成/編輯/延伸）	`prompt`、來源任務 ID
Vidu	文/圖生影片	`prompt`、首幀圖片、時長
Jimeng	即夢任務	`prompt`、圖片

警告

外掛端點為廠商格式轉傳——參數錯誤會直接回傳上游錯誤。提交前請務必在控制台的模型廣場確認對應外掛的參數說明。結果網址皆為暫時網址，SUCCESS 後請盡快轉存檔案。

通用任務端點​

提交任務​

查詢任務​

任務產物​

Suno（音樂）​

Kling（影片）​

內建外掛總覽​