Image
Kling Image 4.0 Long Image
Genera schede prodotto ecommerce e layout web 1K o 2K con Kling Image 4.0 Long Image, poi interroga l’attività per ottenere l’URL del PNG finale.
Invia una richiesta JSON a POST /v1/images/generations con l’ID del modello kling-image-4-0-long-image. Salva l’ID dell’attività restituito, poi interroga GET /v1/tasks/{id} finché il singolo PNG verticale non è completato.
Esempio rapido
Questa richiesta crea un layout webpage 1K da un brief testuale. Memorizza la tua chiave API nella variabile d’ambiente 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 e intestazioni
Invia JSON a POST https://api.seedrouter.ai/v1/images/generations con Content-Type: application/json e Authorization: Bearer YOUR_API_KEY. Conserva la chiave sul tuo server.
Parametri
| Campo | Tipo | Valori e impostazioni predefinite |
|---|---|---|
model | stringa, obbligatoria | kling-image-4-0-long-image |
contents | array, obbligatorio | Un elemento prompt più gli elementi immagine di riferimento specifici per modalità. |
contents[].type | stringa, obbligatoria | prompt, refer_image (solo ecommerce, 1–3 obbligatori), style_refer_image (solo webpage, al massimo 1) oppure subject_refer_image (solo webpage, al massimo 1). element non è supportato. |
contents[].text | stringa | Obbligatorio per prompt. Limite di 166.000 caratteri per il solo inglese e 71.000 per le altre lingue. Il testo misto deve rispettare english / 166000 + non_english / 71000 <= 1. |
contents[].url | stringa | Obbligatorio per ogni elemento immagine. URL HTTP(S) pubblico di un file JPEG o PNG fino a 30 MB, almeno 300 px per lato, rapporto d’aspetto da 2:5 a 5:2. |
contents[].id | stringa | ID di riferimento univoco facoltativo tra tutti gli elementi immagine della richiesta. Citalo nel prompt come @id. |
settings.skill | stringa, obbligatoria | ecommerce per schede prodotto oppure webpage per layout di pagine web. |
settings.length | stringa | short (~2–5 sezioni), medium (predefinito, ~6–10 sezioni) oppure long (~11–18 sezioni). Vale solo per ecommerce; ignorato per webpage. |
settings.resolution | stringa | 1k (predefinito, 1024 px di larghezza) oppure 2k (2048 px di larghezza). L’altezza si adatta ai contenuti. 4k non è supportato. |
options.watermark_info.enabled | booleano | Facoltativo. È supportato solo false. |
Scheda prodotto ecommerce
La modalità ecommerce richiede da 1 a 3 voci refer_image. Richiama ciascuna foto tramite il suo id nel prompt.
{
"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 webpage con riferimenti di stile e soggetto
La modalità webpage accetta voci facoltative style_refer_image (al massimo 1) e subject_refer_image (al massimo 1). Ometti settings.length in modalità 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"}
}Recupera l’immagine lunga
Copia id dalla risposta POST in TASK_ID e interroga lo stato finché non risulta completed o failed. Le attività di immagini lunghe richiedono in genere diversi minuti, soprattutto per i layout long + 2k.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Al completamento, leggi output.data[0].url. Ogni richiesta produce un solo PNG verticale completo. A 2k, le pagine lunghe possono superare 50 MB: prevedi timeout di download e ridimensionamenti di visualizzazione adeguati. Consulta il riferimento delle attività e la directory degli errori.
Prezzi
Ogni richiesta completata addebita una tariffa per fascia di output (ecommerce in base a resolution × length, oppure webpage in base a resolution) più un addebito per immagine di riferimento per ciascuna immagine in ingresso (inclusa la prima). Le richieste non riuscite non comportano addebiti. Consulta le tariffe attuali.
Errori e consigli
Le richieste non valide restituiscono HTTP 400 prima dell’addebito. Gli errori di validazione più frequenti includono omettere settings.skill, inviare ecommerce senza 1–3 URL refer_image, mescolare refer_image con la modalità webpage, richiedere 4k o duplicare gli ID dei riferimenti.
Indica l’ordine esatto delle sezioni nel prompt — dal banner hero fino alle specifiche o al footer — e inserisci solo dati di prodotto verificati, così l’impaginazione rimane precisa. Consulta il playground di Kling Image 4.0 Long Image e lo schema OpenAPI.
