プラグインタスク

Midjourney のほかにも、ゲートウェイにはプラグインチャネルが組み込まれています：Suno 音楽、Kling/Hailuo/Vidu 動画、Veo、Jimeng など。呼び出しパターンは 2 種類あります：

パターン	対象	フロー
汎用タスク	ほとんどのプラグイン（モデルで判別）	`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、画像 URL、長さ、アスペクト比…）。そのままパススルーされます

レスポンス：

{ "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}`	1 件のタスクを照会
`POST /suno/fetch`	一括照会 — ボディは `["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 を指定すると、音声の準備ができるまで待ってから音声 URL を直接返します。

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 Hailuo）	`prompt`、最初のフレーム画像、長さ
Hailuo H3	H3 モデルの動画タスク	上記と同じ
Google Veo	Veo 動画タスク（Gemini/Vertex チャネル）	`prompt`、長さ、アスペクト比
Doubao	Jimeng の動画/画像（ByteDance）	`prompt`、画像、解像度
Alibaba Bailian	Tongyi Wanxiang の画像/動画タスク	`prompt`、モデル、サイズ
xAI	Grok Imagine 動画（生成/編集/延長）	`prompt`、元タスク ID
Vidu	テキスト/画像から動画	`prompt`、最初のフレーム画像、長さ
Jimeng	Jimeng タスク	`prompt`、画像

注意

プラグインエンドポイントはベンダー形式をそのままパススルーします — 不正なパラメーターは上流のエラーとして直接現れます。送信する前に、コンソールのモデルギャラリーでパラメーターのドキュメントを必ず確認してください。結果の URL は一時的なものです。SUCCESS になったらすぐにファイルを再ホストしてください。

汎用タスクエンドポイント​

タスクの送信​

タスクの照会​

タスクの成果物​

Suno（音楽）​

Kling（動画）​

組み込みプラグイン一覧​