Image
Kling Image 4.0 Long Image
Génère des fiches produit e-commerce et des maquettes de pages web verticales en 1K ou 2K avec Kling Image 4.0 Long Image, puis interroge l’état de la tâche pour récupérer l’URL du PNG final.
Envoie une requête JSON à POST /v1/images/generations avec l’ID de modèle kling-image-4-0-long-image. Enregistre l’ID de tâche renvoyé, puis interroge GET /v1/tasks/{id} jusqu’à ce que le PNG vertical soit prêt.
Exemple rapide
Cette requête crée une maquette de page web en 1K à partir d’un brief textuel. Stocke ta clé API dans la variable d’environnement SEEDROUTER_API_KEY.
curl https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "prompt", "text": "Design a tall landing page for a specialty coffee roastery with a hero banner, three single-origin bean cards, roasting notes, and store hours."}
],
"settings": {"skill": "webpage", "resolution": "1k"}
}'Endpoint et en-têtes
Envoie un corps JSON à POST https://api.seedrouter.ai/v1/images/generations avec Content-Type: application/json et Authorization: Bearer YOUR_API_KEY. Conserve ta clé API côté serveur.
Paramètres
| Champ | Type | Valeurs et réglages par défaut |
|---|---|---|
model | string, requis | kling-image-4-0-long-image |
contents | array, requis | Un élément prompt accompagné d’images de référence propres au mode choisi. |
contents[].type | string, requis | prompt, refer_image (mode ecommerce uniquement, 1 à 3 requis), style_refer_image (mode webpage uniquement, 1 max) ou subject_refer_image (mode webpage uniquement, 1 max). element n’est pas pris en charge. |
contents[].text | string | Requis pour prompt. Limite de 166 000 caractères en anglais seul, 71 000 dans les autres langues. Un texte mixte doit respecter english / 166000 + non_english / 71000 <= 1. |
contents[].url | string | Requis pour chaque élément image. URL HTTP(S) publique d’un fichier JPEG ou PNG de 30 Mo maximum, d’au moins 300 px par côté, avec un ratio compris entre 2:5 et 5:2. |
contents[].id | string | Identifiant de référence unique facultatif parmi tous les éléments image de la requête. Mentionne-le sous la forme @id dans le prompt. |
settings.skill | string, requis | ecommerce pour les fiches produit ou webpage pour les designs de pages web. |
settings.length | string | short (~2 à 5 sections), medium (par défaut, ~6 à 10 sections) ou long (~11 à 18 sections). S’applique uniquement à ecommerce ; ignoré en mode webpage. |
settings.resolution | string | 1k (par défaut, 1024 px de large) ou 2k (2048 px de large). La hauteur s’adapte au contenu. 4k n’est pas pris en charge. |
options.watermark_info.enabled | boolean | Facultatif. Seule la valeur false est prise en charge. |
Fiche produit e-commerce
Le mode ecommerce exige entre 1 et 3 entrées refer_image. Mentionne chaque photo dans le prompt à l’aide de son id.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "refer_image", "url": "https://example.com/kettle-front.png", "id": "front"},
{"type": "refer_image", "url": "https://example.com/kettle-spout.jpg", "id": "spout"},
{"type": "prompt", "text": "Build an ecommerce product detail page for the gooseneck kettle in @front with a close-up section highlighting @spout. Include hero visual, temperature control callouts, brewing scenes, and care notes."}
],
"settings": {"skill": "ecommerce", "length": "medium", "resolution": "2k"}
}Design de page web avec références de style et de sujet
Le mode webpage accepte les entrées facultatives style_refer_image (1 max) et subject_refer_image (1 max). Omets settings.length en mode webpage.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "style_refer_image", "url": "https://example.com/editorial-grid.png", "id": "layout"},
{"type": "subject_refer_image", "url": "https://example.com/watch.jpg", "id": "watch"},
{"type": "prompt", "text": "Design a watch launch webpage matching the typography and grid rhythm of @layout while showcasing @watch across the hero, movement breakdown, and spec table."}
],
"settings": {"skill": "webpage", "resolution": "2k"}
}Récupérer l’image longue
Copie le champ id de la réponse POST dans TASK_ID, puis interroge l’état de la tâche jusqu’à obtenir completed ou failed. Les tâches d’image longue prennent généralement plusieurs minutes, en particulier pour les mises en page long en 2k.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Une fois la tâche terminée, lis output.data[0].url. Chaque requête produit un seul PNG vertical complet. En 2k, les pages longues peuvent dépasser 50 Mo : prévois des délais de téléchargement et une mise à l’échelle d’affichage adaptés. Consulte la référence des tâches et le répertoire des erreurs.
Tarification
Chaque requête terminée facture un palier de sortie (ecommerce selon resolution × length, ou webpage selon resolution) plus des frais d’image de référence pour chaque image fournie en entrée (dès la première). Une requête échouée n’est pas facturée. Consulte les tarifs en vigueur.
Erreurs et conseils
Les requêtes invalides renvoient un code HTTP 400 avant toute facturation. Les erreurs de validation les plus courantes consistent à omettre settings.skill, envoyer ecommerce sans 1 à 3 URL refer_image, mélanger refer_image avec le mode webpage, demander 4k ou dupliquer des identifiants de référence.
Indique précisément l’ordre des sections dans ton prompt — de la bannière héro jusqu’aux caractéristiques ou au pied de page — et n’inclus que des informations produit vérifiées pour garder une mise en page fidèle. Découvre le Playground Kling Image 4.0 Long Image et le schéma OpenAPI.
