Image
Kling Image 4.0
Crea immagini 2K o 4K con Kling Image 4.0. Usa foto di riferimento con nome, variazioni di una singola immagine oppure una serie di immagini collegate, poi interroga il servizio finché non ricevi gli URL delle immagini completate.
Invia una richiesta JSON a POST /v1/images/generations con l’ID del modello kling-image-4-0. Salva l’ID dell’attività restituito. Lo stesso endpoint accetta prompt di solo testo e prompt guidati da immagini di riferimento.
Esempio rapido
Questa richiesta genera una singola immagine quadrata 2K. 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",
"contents": [
{"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
],
"settings": {"resolution": "2k", "aspect_ratio": "1:1"}
}'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 |
contents | array, obbligatorio | Un prompt e da zero a dieci immagini di riferimento. |
contents[].type | stringa, obbligatoria | prompt oppure refer_image. |
contents[].text | stringa | Obbligatorio per il prompt. Limite di 50.000 caratteri per l’inglese e di 21.000 per le altre lingue. Nei testi misti, la somma delle due frazioni rispetto ai rispettivi limiti non deve superare uno. |
contents[].url | stringa | Obbligatorio per ogni riferimento. Usa un URL HTTP(S) accessibile per un JPEG o PNG fino a 30 MB. Entrambi i lati devono misurare almeno 300 pixel e il rapporto larghezza/altezza deve essere compreso tra 2:5 e 5:2. |
contents[].id | stringa | Nome univoco facoltativo per un riferimento. Cita il nome nel prompt come @name. |
settings.result_type | stringa | single (predefinito) per immagini indipendenti oppure series per immagini correlate. |
settings.n | intero | Da 1 a 9 immagini indipendenti. Il valore predefinito è 1. Si usa solo in modalità singola. |
settings.series_amount | intero o stringa | In modalità serie, da 2 a 4 immagini; il valore predefinito è 4. In modalità singola questo campo viene ignorato e può essere un intero da 2 a 10 oppure la stringa auto. |
settings.resolution | stringa | 2k (predefinito) oppure 4k. |
settings.aspect_ratio | stringa | auto (predefinito), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 oppure 21:9. |
options.watermark_info.enabled | booleano | Facoltativo. È supportato solo false. |
Una serie a partire da una foto di riferimento
Sostituisci l’URL di esempio con un URL pubblico della foto del tuo prodotto. Questo esempio richiede tre immagini correlate. Mantieni le istruzioni per ogni fotogramma nello stesso prompt.
{
"model": "kling-image-4-0",
"contents": [
{"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
{"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
],
"settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}Recupera tutte le immagini
Copia id dalla risposta POST in TASK_ID. Interroga questo endpoint con la stessa chiave finché lo stato dell’attività non è completed o failed.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Al completamento, leggi ogni URL in output.data[].url. Un’attività può restituire più immagini. Se un controllo dello stato viene interrotto, cerca di nuovo l’ID originale. Consulta il riferimento delle attività per il ciclo di vita e la directory degli errori per i codici di errore.
Prezzi
Il totale è dato dal numero di immagini generate alla risoluzione richiesta moltiplicato per la tariffa corrente per immagine, più un addebito per ogni immagine di riferimento fornita in input. Quattro immagini 4K con due riferimenti costano quanto quattro addebiti per immagini 4K generate più due addebiti per immagini di riferimento. Le richieste non riuscite non comportano addebiti. Consulta le tariffe attuali.
Errori e consigli
Un input non valido restituisce un errore di richiesta. Controlla che il testo del prompt non manchi, che gli ID dei riferimenti non siano duplicati e che le impostazioni di risoluzione o serie siano supportate. Se la chiamata iniziale ha restituito un ID attività, controlla prima quell’ID per decidere se occorre inviare un’altra richiesta.
Per una descrizione con più riferimenti, assegna un nome diverso a ogni soggetto e indica al modello quali caratteristiche visive fornire con ciascun riferimento. Inserisci nel prompt le indicazioni della fotocamera e la sequenza delle riprese. Consulta il playground di Kling Image 4.0 e lo schema OpenAPI.
