Ten poradnik jest na razie tylko po angielsku. →
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
prompt | Tak | Describe the image to generate: subject, composition, style, and lighting. |
resolution | Nie | Rozmiar wyniku. Większy jest ostrzejszy i droższy. 1k · 2k · Domyślnie: 2k |
aspect_ratio | Nie | Kształt kadru: szeroki, kwadratowy albo pionowy. 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 4:5 · 5:4 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · Domyślnie: 1:1 |
output_format | Nie | Format pliku wyniku. jpeg · png · Domyślnie: jpeg |
enable_thinking | Nie | Run a thinking pass that refines the prompt before generating. Off is faster. Domyślnie: true |
Ceny
Ceny podajemy w kredytach, tych samych, których używasz na stronie (1 kredyt = 0,01 $). Kwota jest rezerwowana, gdy zadanie zostaje przyjęte, a po zakończeniu rozliczana według rzeczywistego kosztu; za nieudane zadania kredyty wracają.
| Opcja | Kredyty za obraz | ≈ USD |
|---|---|---|
| resolution 1K | 5,4 | 0,054 USD |
| resolution 2K | 10,8 | 0,11 USD |
Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 6 kredytów za obraz (0,06 USD).
Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.
Szybki start z API
Wywołaj API Seedream 5.0 Pro w trzech krokach
- Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow- i korzystają z tych samych kredytów co strona.
- Wyślij żądanie. Wyślij POST /jobs/createTask z model bytedance/seedream-5.0-pro/text-to-image i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
- Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"resolution": "2k",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.
Pytania o API Seedream 5.0 Pro
Ile kosztuje API Seedream 5.0 Pro?
Seedream 5.0 Pro kosztuje od 6 kredytów (0,06 USD) za obraz – najtańsze zadanie to „Utwórz obraz”. Ceny według opcji: 1K 5,4 kredytu za obraz, 2K 10,8 kredytu za obraz. Kredyty są te same co na stronie (1 kredyt = 0,01 USD), nowe konta dostają 30 darmowych kredytów, a nieudane zadania są zwracane.
Jaka jest nazwa modelu Seedream 5.0 Pro w API?
Wpisz bytedance/seedream-5.0-pro/text-to-image do zadania Utwórz obraz; bytedance/seedream-5.0-pro/edit do zadania Edytuj obraz; bytedance/seedream-5.0-pro/layer-decomposition do zadania Podział na warstwy w polu model żądania POST /jobs/createTask.
Ile obrazów referencyjnych przyjmuje jedna edycja?
Do dziesięciu. Przypisz każdemu rolę w prompcie, bo nienazwane źródła zostaną ze sobą zmieszane. Każda referencja poza pierwszą powiększa wycenę, którą widzisz przed wysłaniem.
Czy mogę ustawić rozmiar wyjścia albo proporcje obrazu?
Tak, jako proporcję i próg, a nie dowolne piksele. aspect_ratio przyjmuje piętnaście kształtów od 1:3 do 3:1, a resolution wybiera 1k albo 2k. Text-to-image domyślnie używa 1:1, edycja – trybu auto, który wybiera obsługiwaną proporcję najbliższą pierwszej referencji. Jeśli potrzebujesz nazwanego presetu szerokość*wysokość, użyj Seedream 5.0 Lite.
Czy jest seed dla powtarzalnych wyników?
Nie. Żaden z endpointów go nie udostępnia, więc dwa identyczne żądania zwrócą dwa różne kadry. Przechowuj prompt razem z każdym zasobem, który zamierzasz wykorzystać ponownie.
JPEG czy PNG – o co prosić?
png, gdy kadr idzie dalej do retuszu albo compositingu i liczą się bezstratne krawędzie; jpeg do rund przeglądowych i dostawy wprost. To zmienia plik, który dostajesz, a nie obraz, który powstał.
Czy potrafi renderować tekst wewnątrz obrazu?
Krótkie napisy czasem wychodzą, ale nie do tego ten model służy. Do szyldów, winiet i tekstów na opakowaniach użyj modelu zbudowanego pod typografię w obrazie.
Jakie limity ma API Seedream 5.0 Pro?
Rozdzielczości: 1K · 2K; Proporcje obrazu: 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 +9; Długość promptu (znaki): 5,000. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Seedream 5.0 Pro bez pisania kodu?
Tak. Playground uruchamia Seedream 5.0 Pro na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.
Wszystkie modele Seedream
Seedream 5.0 Lite pracuje na stałych rozmiarach kadru 2K, co trzyma serię w jednym stylu, a Seedream 5.0 Flash to szybszy i tańszy krewny. Pro jest do finalnego, najbardziej szczegółowego kadru.
- API Seedream 5.0 ProSzczegółowe obrazy i edycja na podstawie nawet dziesięciu referencjiOd 6 kredytów za obraz
- API Seedream 5.0 FlashSzybki Seedream: obrazy, edycja i warstwy do 2KOd 4 kredytów za obraz
- API Seedream 5.0 LiteKadry 2K o stałym rozmiarze, by seria była spójnaOd 6 kredytów za obraz
- API Seedream 4.0Dokładne rozmiary do 4096×2304 i edycja z dziesięcioma referencjamiOd 5 kredytów za obraz

