Задачи плагинов

Помимо Midjourney, в шлюзе есть каналы-плагины: музыка Suno, видео Kling/Hailuo/Vidu, Veo, Jimeng и другие. Существуют два шаблона вызова:

Шаблон	Применимость	Порядок действий
Универсальная задача	Большинство плагинов (управляется моделью)	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	Да	Название модели плагина — определяет маршрутизацию
Прочие поля	-	Нет	Специфичные для плагина параметры (промпт, 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}	Запрос одной задачи
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}	Запрос задачи text-to-video
GET /kling/v1/videos/image2video/{task_id}	Запрос задачи 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"
  }'

Параметры и ответы совпадают с официальным API Kling (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 своевременно перезалейте файлы на собственное хранилище.