Tác vụ plugin

Ngoài Midjourney, gateway còn đi kèm các kênh plugin: nhạc Suno, video Kling/Hailuo/Vidu, Veo, Jimeng, v.v. Có hai kiểu gọi:

Kiểu	Áp dụng cho	Luồng
Tác vụ chung	Hầu hết các plugin (điều khiển qua model)	POST /v1/tasks gửi → GET /v1/tasks/{id} truy vấn → lấy sản phẩm (artifact)
Truyền thẳng native	Suno, Kling, v.v.	Đường dẫn native của nhà cung cấp /suno/*, /kling/* — tham số khớp với API chính thức của nhà cung cấp

Các endpoint tác vụ chung

Gửi tác vụ

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
  }'

Tham số	Kiểu	Bắt buộc	Mô tả
model	string	Có	Tên mô hình plugin — quyết định routing
Các trường khác	-	Không	Tham số riêng của plugin (prompt, URL ảnh, thời lượng, tỉ lệ khung hình…), được truyền thẳng nguyên trạng

Phản hồi:

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

Truy vấn tác vụ

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"
  }
}

Giá trị status: SUBMITTED / IN_PROGRESS / SUCCESS / FAILURE (một số plugin bổ sung trạng thái riêng của chúng — hãy tin vào phản hồi).

Sản phẩm của tác vụ (Task Artifacts)

Endpoint	Mô tả
GET /v1/tasks/{key}/artifacts	Liệt kê các sản phẩm của một tác vụ (tệp âm thanh/video/hình ảnh)
GET /v1/tasks/{key}/artifacts/{artifact_key}/content	Tải xuống một sản phẩm cụ thể (luồng nhị phân)

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 (Nhạc)

Truyền thẳng theo định dạng SunoAPI:

Endpoint	Mô tả
POST /suno/submit/{action}	Gửi tác vụ — action là một action của SunoAPI (music, lyrics, caption, …), tham số khớp với tài liệu SunoAPI
GET /suno/fetch/{task_id}	Truy vấn một tác vụ
POST /suno/fetch	Truy vấn hàng loạt — body nhận ["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 }'

Trường data phản chiếu cấu trúc tác vụ Suno gốc. Với wait_audio: true, lượt gọi sẽ chờ cho đến khi âm thanh sẵn sàng và trả về trực tiếp các URL âm thanh.

Kling (Video)

Truyền thẳng native của Kling:

Endpoint	Mô tả
POST /kling/v1/videos/text2video	Văn bản thành video
POST /kling/v1/videos/image2video	Hình ảnh thành video
GET /kling/v1/videos/text2video/{task_id}	Truy vấn tác vụ text-to-video
GET /kling/v1/videos/image2video/{task_id}	Truy vấn tác vụ image-to-video

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"
  }'

Tham số và phản hồi khớp với API chính thức của Kling (model_name / mode / aspect_ratio / cfg_scale, v.v.) — chỉ cần thay domain bằng gateway.

Tổng quan plugin tích hợp sẵn

Tất cả các plugin dưới đây đều gửi qua POST /v1/tasks (đặt model thành tên tương ứng) và truy vấn qua GET /v1/tasks/{task_id}. Tham số của chúng phản chiếu API của nhà cung cấp upstream và được truyền thẳng nguyên trạng:

Plugin	Khả năng	Tham số chính
Hailuo Video	Văn bản/hình ảnh thành video (MiniMax Hailuo)	prompt, ảnh khung hình đầu tiên, thời lượng
Hailuo H3	Tác vụ video mô hình H3	Giống như trên
Google Veo	Tác vụ video Veo (kênh Gemini/Vertex)	prompt, thời lượng, tỉ lệ khung hình
Doubao	Video/hình ảnh Jimeng (ByteDance)	prompt, ảnh, độ phân giải
Alibaba Bailian	Tác vụ ảnh/video Tongyi Wanxiang	prompt, model, size
xAI	Video Grok Imagine (tạo/chỉnh sửa/mở rộng)	prompt, ID tác vụ nguồn
Vidu	Văn bản/hình ảnh thành video	prompt, ảnh khung hình đầu tiên, thời lượng
Jimeng	Tác vụ Jimeng	prompt, ảnh

Cảnh báo

Các endpoint plugin truyền thẳng định dạng của nhà cung cấp — tham số không hợp lệ sẽ hiện lỗi từ phía upstream. Hãy luôn kiểm tra kỹ tài liệu tham số trong thư viện mô hình của Console trước khi gửi. URL kết quả là tạm thời; hãy lưu trữ lại tệp ngay khi trạng thái SUCCESS.