插件任务

除 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-你的令牌" \
  -d '{
    "model": "hailuo-video",
    "prompt": "海洋深处发光的水母群",
    "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-你的令牌"

{
  "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-你的令牌"

curl "https://test.kailin.com.cn/v1/tasks/3e2c1a9b/artifacts/audio-0/content" \
  -H "Authorization: Bearer sk-你的令牌" \
  --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-你的令牌" \
  -d '{ "prompt": "轻快的夏日流行歌", "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-你的令牌" \
  -d '{
    "model_name": "kling-v1",
    "prompt": "清晨的森林，阳光穿过树叶",
    "duration": 5,
    "mode": "std"
  }'

参数与响应结构与快手可灵官方 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（视频）​

内置插件一览​