Tâches de plugins

En plus de Midjourney, la passerelle embarque des canaux de plugins : musique Suno, vidéo Kling/Hailuo/Vidu, Veo, Jimeng, etc. Deux schémas d'appel existent :

Schéma	S'applique à	Flux
Tâche générique	La plupart des plugins (pilotés par modèle)	POST /v1/tasks soumission → GET /v1/tasks/{id} interrogation → récupération des artefacts
Passthrough natif	Suno, Kling, etc.	Chemins natifs du fournisseur /suno/*, /kling/* — les paramètres correspondent à l'API officielle du fournisseur

Points de terminaison de tâches génériques

Soumettre une tâche

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

Paramètre	Type	Obligatoire	Description
model	string	Oui	Nom du modèle de plugin — détermine le routage
Autres champs	-	Non	Paramètres propres au plugin (prompt, URL d'image, durée, ratio d'aspect…), transmis tels quels

Réponse :

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

Interroger une tâche

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

Valeurs de status : SUBMITTED / IN_PROGRESS / SUCCESS / FAILURE (certains plugins ajoutent leurs propres états — fiez-vous à la réponse).

Artefacts de tâche

Point de terminaison	Description
GET /v1/tasks/{key}/artifacts	Liste les artefacts d'une tâche (fichiers audio/vidéo/image)
GET /v1/tasks/{key}/artifacts/{artifact_key}/content	Télécharge un artefact spécifique (flux binaire)

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 (musique)

Passthrough au format SunoAPI :

Point de terminaison	Description
POST /suno/submit/{action}	Soumet une tâche — action est une action SunoAPI (music, lyrics, caption, …), les paramètres correspondent à la documentation SunoAPI
GET /suno/fetch/{task_id}	Interroge une tâche
POST /suno/fetch	Interrogation par lot — le corps accepte ["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 }'

Le champ data reproduit la structure brute de la tâche Suno. Avec wait_audio: true, l'appel attend que l'audio soit prêt et renvoie directement les URL audio.

Kling (vidéo)

Passthrough natif Kling :

Point de terminaison	Description
POST /kling/v1/videos/text2video	Texte vers vidéo
POST /kling/v1/videos/image2video	Image vers vidéo
GET /kling/v1/videos/text2video/{task_id}	Interroge une tâche texte vers vidéo
GET /kling/v1/videos/image2video/{task_id}	Interroge une tâche image vers vidéo

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

Les paramètres et les réponses correspondent à l'API officielle de Kling (model_name / mode / aspect_ratio / cfg_scale, etc.) — remplacez simplement le domaine par celui de la passerelle.

Vue d'ensemble des plugins intégrés

Les plugins ci-dessous soumettent tous via POST /v1/tasks (model défini sur le nom correspondant) et interrogent via GET /v1/tasks/{task_id}. Leurs paramètres reflètent les API des fournisseurs amont et transitent sans modification :

Plugin	Capacité	Paramètres clés
Hailuo Video	Texte/image vers vidéo (MiniMax Hailuo)	prompt, image de première image, durée
Hailuo H3	Tâches vidéo des modèles H3	Identiques à ci-dessus
Google Veo	Tâches vidéo Veo (canaux Gemini/Vertex)	prompt, durée, ratio d'aspect
Doubao	Vidéo/image Jimeng (ByteDance)	prompt, image, résolution
Alibaba Bailian	Tâches image/vidéo Tongyi Wanxiang	prompt, modèle, taille
xAI	Vidéo Grok Imagine (générer/éditer/étendre)	prompt, ID de tâche source
Vidu	Texte/image vers vidéo	prompt, image de première image, durée
Jimeng	Tâches Jimeng	prompt, image

Avertissement

Les points de terminaison de plugins transmettent les formats des fournisseurs — les paramètres invalides provoquent des erreurs amont directes. Vérifiez toujours la documentation des paramètres dans la galerie de modèles de la Console avant de soumettre. Les URL de résultat sont temporaires ; réhébergez rapidement les fichiers une fois SUCCESS atteint.