Claude Opus 5.5 è disponibile su SeedRouter

Image

Kling Image 4.0 Long Image

View Markdown

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

CampoTipoValori e impostazioni predefinite
modelstringa, obbligatoriakling-image-4-0-long-image
contentsarray, obbligatorioUn elemento prompt più gli elementi immagine di riferimento specifici per modalità.
contents[].typestringa, obbligatoriaprompt, 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[].textstringaObbligatorio 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[].urlstringaObbligatorio 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[].idstringaID di riferimento univoco facoltativo tra tutti gli elementi immagine della richiesta. Citalo nel prompt come @id.
settings.skillstringa, obbligatoriaecommerce per schede prodotto oppure webpage per layout di pagine web.
settings.lengthstringashort (~2–5 sezioni), medium (predefinito, ~6–10 sezioni) oppure long (~11–18 sezioni). Vale solo per ecommerce; ignorato per webpage.
settings.resolutionstringa1k (predefinito, 1024 px di larghezza) oppure 2k (2048 px di larghezza). L’altezza si adatta ai contenuti. 4k non è supportato.
options.watermark_info.enabledbooleanoFacoltativo. È 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.