Claude Opus 5.5 jest już dostępny w SeedRouter

Image

Kling Image 4.0

View Markdown

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

PoleTypDozwolone wartości i wartości domyślne
modelstring, wymaganekling-image-4-0
contentsarray, wymaganeJeden prompt i od zera do dziesięciu obrazów referencyjnych.
contents[].typestring, wymaganeprompt lub refer_image.
contents[].textstringWymagane 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[].urlstringWymagane 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[].idstringOpcjonalna, unikalna nazwa obrazu referencyjnego. Wspomnij ją w promptcie jako @name.
settings.result_typestringsingle (domyślnie) — tworzy niezależne obrazy; series — tworzy powiązane obrazy.
settings.nintegerOd 1 do 9 niezależnych obrazów. Domyślnie 1. Używane tylko w trybie single.
settings.series_amountinteger lub stringW 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.resolutionstring2k (domyślnie) lub 4k.
settings.aspect_ratiostringauto (domyślnie), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 lub 21:9.
options.watermark_info.enabledbooleanOpcjonalne. 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.