FLUX 3 Image Klein

Generuj lub edytuj jeden obraz z maksymalnie dziesięcioma URL referencji, pięcioma poziomami rozdzielczości i asynchronicznymi wynikami zadań.

Szybki przykład

Wyślij żądanie obrazu, zapisz zwrócone id i odpytuj zadanie do completed lub failed. API używa asynchronicznych zadań i wyjść URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

Punkt końcowy i nagłówki

POST https://api.seedrouter.ai/v1/images/generations

Nagłówek	Wartość
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

Trzymaj klucz na serwerze. Sukces HTTP potwierdza zadanie, nie gotowość obrazu.

Parametry

Przyjmowanych jest 11 pól. Tylko model i prompt są wymagane. Pomiń opcjonalne pola, by użyć wartości domyślnych; null nie jest dozwolone.

Pole	Typ	Domyślnie	Ograniczenie
`model`	ciąg znaków	Wymagane	`flux-3-image-klein`
`prompt`	ciąg znaków	Wymagane	Niepusty opis obrazu lub instrukcja edycji
`image_urls`	tablica ciągów	Brak	Do 10 publicznych HTTP(S) URL obrazów bez danych logowania; pusta tablica oznacza brak referencji
`aspect_ratio`	ciąg znaków	`auto`	Wymienione proporcje; akceptuje też formy jak `16x9`
`size`	ciąg znaków	Brak	Alias proporcji dla zgodności; preferuj `aspect_ratio` i wyślij tylko jedno
`resolution`	ciąg znaków	`1k`	`768sq`, `1k`, `1.5k`, `2k`, `4k`; bez rozróżniania wielkości liter; `768` to alias `768sq`
`safety_tolerance`	liczba całkowita	`2`	0–4; 0 jest najostrzejsze
`seed`	liczba całkowita	Losowo	0–4294967295; jawne 0 jest zachowane
`steps`	liczba całkowita	`16`	1–16
`output_format`	ciąg znaków	`jpeg`	`jpeg`, `png`; `jpg` to alias `jpeg`
`n`	liczba całkowita	`1`	Tylko 1

Proporcje: auto, 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21.

Playground ma stały model i dziesięć kontrolek, w tym n ustawione na 1. Wartości bezpieczeństwa powyżej 2 są tylko w API, z wyjątkiem administratorów.

Brak referencji oznacza generowanie z tekstu. Jedna pozwala edytować, wiele — komponować z kilku obrazów. Przy auto edycja bierze proporcje pierwszej referencji. Sam tekst określa format przez prompt, z domyślnym 1:1, jeśli go nie ustali. Rozdzielczość domyślna to 1k w każdym trybie.

Poziomy oznaczają przybliżoną skalę: 768sq to około 768 × 768; 1K około 1 MP; 1.5K około 2 MP; 2K około 4 MP; 4K około 16 MP. Rzeczywiste wymiary sprawdź w zwróconym pliku.

Punkt nie przyjmuje width, height, wymiarów w pikselach w size, negative_prompt, guidance, grounding, prompt_upsampling, mask ani mask_url. Nieznane pola dają HTTP 400 przed naliczeniem opłaty. Wyjście WebP, wejście base64, streaming i callbacki nie są oferowane.

Referencje i edycja obszarów

Przed wysłaniem umieść referencje pod publicznym URL. Treść żądania zawiera URL, nie bajty plików ani data URL.

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

Zastąp przykładowe URL własnymi dostępnymi obrazami. Referencje mają kolejność: ref_image_0 jest pierwsza. Instrukcje ramek należą do ciągu prompt, nie osobnego pola. Współrzędne to [y1, x1, y2, x2], znormalizowane do 0–1000. Obiekt układu może zawierać id, bbox, desc; edycja może używać id, from, src_bbox, tgt_bbox, desc. Zakoduj całe żądanie jako JSON, aby poprawnie zastosować znaki ucieczki dla cudzysłowów wewnątrz promptu.

Rozliczanie

Jedno udane żądanie daje jeden obraz. Cenę ustala tylko rozdzielczość; kroki, seed, proporcje, referencje i format nie dodają opłat. Tekst na obraz i edycja mają tę samą stawkę. Nieudane żądania nie są płatne. Zobacz aktualne ceny.

Odpowiedź zadania i odpytywanie

Wysłanie:

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Ukończone zadanie (przykładowy URL):

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

Odczytaj output.data[0].url. Przewiduj do dziesięciu minut generowania, szczególnie w 4K. Odpytywanie jest tylko do odczytu; timeout klienta nie zezwala na kolejne płatne żądanie. Publiczne odpowiedzi nie zawierają kosztów ani sald konta.

Błędy

Błędy HTTP używają {"error": {"code": integer, "message": string}}. Zobacz wspólny katalog błędów. Nieudane zadanie pokazuje błąd wraz z status: "failed". Popraw parametry przed ponownym wysłaniem; zachowaj ID do sprawdzania wysłanego żądania.

Wskazówki i powiązane poradniki

Opisuj pożądany wynik i wskaż obszary lub szczegóły do zachowania. Mniej kroków może zmienić jakość bez obniżenia ceny. Porównuj jedną zmianę naraz.