Image
Kling Image 4.0
Twórz obrazy w rozdzielczości 2K lub 4K za pomocą Kling Image 4.0. Używaj nazwanych zdjęć referencyjnych, twórz niezależne warianty lub powiązaną serię, a następnie sprawdzaj, czy adresy URL gotowych obrazów są już dostępne.
Wyślij żądanie JSON do POST /v1/images/generations z identyfikatorem modelu kling-image-4-0. Zapisz zwrócony identyfikator zadania. Ten sam endpoint obsługuje opisy tekstowe bez zdjęć oraz opisy ze wskazówkami opartymi na zdjęciach referencyjnych.
Szybki przykład
To żądanie tworzy jeden kwadratowy obraz w rozdzielczości 2K. Zapisz klucz API w zmiennej środowiskowej 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 i nagłówki
Wyślij JSON do POST https://api.seedrouter.ai/v1/images/generations z nagłówkami Content-Type: application/json i Authorization: Bearer YOUR_API_KEY. Przechowuj klucz na swoim serwerze.
Parametry
| Pole | Typ | Dozwolone wartości i wartości domyślne |
|---|---|---|
model | string, wymagane | kling-image-4-0 |
contents | array, wymagane | Jeden prompt i od zera do dziesięciu obrazów referencyjnych. |
contents[].type | string, wymagane | prompt lub refer_image. |
contents[].text | string | Wymagane dla promptu. Limit dla tekstu angielskiego wynosi 50 000 znaków, a dla tekstu w innych językach — 21 000. W tekście mieszanym suma części wykorzystujących odpowiednie limity nie może przekroczyć jedności. |
contents[].url | string | Wymagane dla każdego obrazu referencyjnego. Użyj dostępnego adresu URL HTTP(S) pliku JPEG lub PNG o rozmiarze do 30 MB. Każdy bok musi mieć co najmniej 300 pikseli, a proporcje szerokości do wysokości muszą mieścić się w zakresie od 2:5 do 5:2. |
contents[].id | string | Opcjonalna, unikalna nazwa obrazu referencyjnego. Wspomnij ją w promptcie jako @name. |
settings.result_type | string | single (domyślnie) — tworzy niezależne obrazy; series — tworzy powiązane obrazy. |
settings.n | integer | Od 1 do 9 niezależnych obrazów. Domyślnie 1. Używane tylko w trybie single. |
settings.series_amount | integer lub string | W trybie series tworzy od 2 do 4 obrazów; domyślnie 4. W trybie single to pole jest ignorowane i może przyjąć liczbę całkowitą od 2 do 10 albo ciąg auto. |
settings.resolution | string | 2k (domyślnie) lub 4k. |
settings.aspect_ratio | string | auto (domyślnie), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 lub 21:9. |
options.watermark_info.enabled | boolean | Opcjonalne. Obsługiwana jest tylko wartość false. |
Seria na podstawie zdjęcia referencyjnego
Zastąp przykładowy adres URL publicznym adresem zdjęcia swojego produktu. Ten przykład tworzy trzy powiązane obrazy. Instrukcje dla poszczególnych kadrów umieść w jednym promptcie.
{
"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"}
}Pobierz wszystkie obrazy
Skopiuj id z odpowiedzi POST do TASK_ID. Odpytuj ten endpoint z użyciem tego samego klucza, aż status zadania zmieni się na completed lub failed.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Po zakończeniu odczytaj wszystkie adresy URL z output.data[].url. Jedno zadanie może zwrócić wiele obrazów. Jeśli sprawdzanie statusu zostanie przerwane, ponownie wyszukaj pierwotny identyfikator. Opis cyklu życia zadania znajdziesz w dokumentacji zadań, a kody błędów — w katalogu błędów.
Cennik
Łączny koszt to liczba obrazów wynikowych w wybranej rozdzielczości pomnożona przez aktualną stawkę za obraz wynikowy, powiększona o jedną opłatę za obraz referencyjny dla każdego obrazu wejściowego. Cztery obrazy 4K z dwoma obrazami referencyjnymi kosztują tyle, co cztery obrazy wynikowe 4K i dwa obrazy referencyjne. Nieudane żądanie nie wiąże się z opłatą. Zobacz aktualne stawki.
Błędy i wskazówki
Nieprawidłowe dane wejściowe powodują błąd żądania. Sprawdź, czy prompt zawiera tekst, identyfikatory obrazów referencyjnych się nie powtarzają oraz czy ustawienia rozdzielczości i serii są obsługiwane. Jeśli pierwsze wywołanie zwróciło identyfikator zadania, sprawdź jego status, zanim zdecydujesz o wysłaniu kolejnego żądania.
W opisie z wieloma obrazami referencyjnymi nadaj każdemu obiektowi odrębną nazwę i wskaż, jakie cechy wizualne ma dostarczać każde zdjęcie. W prompcie opisz ruch kamery i kolejność ujęć. Zobacz środowisko testowe Kling Image 4.0 i schemat OpenAPI.
