Masz prompt do Seedream, który działa w aplikacji webowej, i chcesz go teraz użyć we własnym kodzie. Do tego potrzebny jest klucz API. Są dwa sposoby, by go zdobyć: chmura samego ByteDance, BytePlus ModelArk, gdzie tworzysz klucz, wybierasz ID modelu i płacisz za obraz; albo platforma API, która udostępnia Seedream za jednym kluczem razem z innymi modelami. Ten przewodnik obejmuje oba, z dokładnymi krokami, oficjalnymi cenami z 12 października 2026 i tym, co zmienia się między nimi.
Krótka odpowiedź: zaloguj się do konsoli BytePlus, otwórz stronę API keys, kliknij Create API key i wywołaj https://ark.ap-southeast.bytepluses.com/api/v3/images/generations, podając klucz jako token bearer oraz ID modelu, np. dola-seedream-5-0-pro-260628. Seedream 5.0 Pro kosztuje 0,045 $ za obraz do 1.5K i 0,09 $ powyżej, Flash 0,018 $, a Lite 0,035 $. BytePlus domyślnie stosuje filtr treści. Klucz SpicyAPI uruchamia te same wersje modelu Seedream bez dodanego filtra, po 0,036 $ za obraz 1K dla 5.0 Pro, a tym samym kluczem wywołasz też wideo i inne modele obrazu.
- Jeden model, oficjalne konto: BytePlus ModelArk. Najtańsza droga do Seedream 5.0 Flash.
- Kilka modeli, prace dla dorosłych lub niższa cena Pro: klucz platformy API, np. SpicyAPI.
- Strony „free Seedream API key” (darmowy klucz API Seedream): oficjalny cennik nie zawiera darmowego limitu na obrazy wyjściowe. Klucze udostępniane w sieci to cudzy limit.
Opcja 1: klucz API Seedream z BytePlus ModelArk
BytePlus to międzynarodowa chmura ByteDance, a ModelArk to jej usługa modeli. Seedream jest tam jednym z modeli obrazu, obok wideo Seedance i modeli językowych Seed. Jedno konto i jeden klucz obejmują je wszystkie.
- Załóż konto BytePlus i zaloguj się do konsoli. Dodaj metodę płatności, zanim zaczniesz na nim polegać: według oficjalnej strony z cennikiem konto, które pozostaje na minusie przez dwie godziny, ma zawieszone usługi modeli do czasu doładowania.
- Otwórz stronę API keys. Jeśli twoja organizacja używa przestrzeni projektów, najpierw przełącz się na właściwą w lewym dolnym rogu, bo klucz sięga tylko do modeli w swoim projekcie.
- Kliknij Create API key, potwierdź nazwę i kliknij Create. Klucz pojawi się na liście kluczy API. Klucze utworzone po 17 września 2026 używają nowego formatu jawnego tekstu; starsze nadal działają.
- Umieść klucz w zmiennej środowiskowej (dokumentacja używa
ARK_API_KEY), a nie w kodzie.
Oficjalne kroki dla klucza kończą się tutaj. W konsoli jest też strona Model activation, która pokazuje twoje limity zapytań; kilka przewodników osób trzecich dodaje krok aktywacji przed pierwszym wywołaniem obrazu, więc jeśli wywołanie zostanie odrzucone z powodu dostępu, ta strona to pierwsze miejsce do sprawdzenia.
Następnie wywołaj endpoint obrazów z ID modelu:
curl https://ark.ap-southeast.bytepluses.com/api/v3/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "dola-seedream-5-0-pro-260628",
"prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
"size": "2K",
"output_format": "png",
"watermark": false
}'Wywołanie jest synchroniczne. Odpowiedź zawiera tablicę data, a url każdego elementu to link do pobrania jednego obrazu. Link jest przechowywany tylko przez 24 godziny, więc pobierz plik lub skopiuj go do własnego magazynu od razu. Ustaw response_format na b64_json, jeśli wolisz dostać bajty obrazu w odpowiedzi. watermark domyślnie ma wartość true, co dodaje widoczny znak, więc ustaw false, jeśli go nie chcesz.
Trzy kolejne rzeczy warto znać, zanim zaczniesz na tym budować:
- Ogranicz każdy klucz. Klucz można ograniczyć do konkretnych ID modeli i konkretnych adresów IP. Jedno konto może mieć do 50 kluczy, więc osobny, ograniczony klucz dla każdej aplikacji to tanie ubezpieczenie na wypadek wycieku.
- Pilnuj limitu zapytań. Seedream 5.0 Pro i Flash pozwalają na 500 obrazów na minutę na wersję modelu na konto; powyżej tego wywołania zwracają błąd.
- Moderacja treści jest domyślnie włączona. Filtr wstępny treści ModelArk obejmuje treści dla dorosłych i drastyczne i jest włączony w nowych endpointach; można go wyłączyć dla poszczególnych endpointów, ale nadal obowiązuje podstawowy zestaw polityk treści BytePlus. Zablokowane obrazy nie są naliczane.
ID modeli Seedream w BytePlus
| Model | ID modelu |
|---|---|
| Seedream 5.0 Pro | dola-seedream-5-0-pro-260628 |
| Seedream 5.0 Flash | dola-seedream-5-0-flash-260915 |
| Seedream 5.0 Lite | seedream-5-0-lite-260128 |
| Seedream 4.5 | seedream-4-5-251128 |
| Seedream 4.0 | seedream-4-0-250828 |
BytePlus nazywa teraz modele 5.0 Pro i Flash „Dola Seedream”. To ta sama linia modeli. Sufiks z datą zmienia się, gdy pojawia się nowy snapshot, więc skopiuj ID z listy modeli zamiast je zgadywać.
Oficjalne ceny API Seedream
Ze strony z cennikiem ModelArk, sprawdzone 12 października 2026:
| Model | Wynik, za obraz | Obrazy wejściowe |
|---|---|---|
| Seedream 5.0 Pro | 0,045 $ do 2,61 MP (1.5K); 0,09 $ powyżej | Pierwszy bezpłatny, potem 0,003 $ za każdy |
| Seedream 5.0 Pro, rozdzielanie warstw | 0,0225 $ do 1.5K; 0,045 $ powyżej (za warstwę) | — |
| Seedream 5.0 Flash | 0,018 $ | Bezpłatne |
| Seedream 5.0 Lite | 0,035 $ | Bezpłatne |
| Seedream 4.5 | 0,04 $ | Bezpłatne |
| Seedream 4.0 | 0,03 $ | Bezpłatne |
Na liście nie ma darmowego limitu na obrazy wyjściowe. Partia 1000 obrazów Seedream 5.0 Pro w 2K kosztuje 90 $, a 1000 obrazów Flash 18 $.
Opcja 2: Seedream przez jeden klucz SpicyAPI
Platforma API daje jeden klucz do wielu modeli i zajmuje się kontami dostawców, które za nią stoją. W SpicyAPI kroki wyglądają tak:
- Zarejestruj się i otwórz klucze API w konsoli.
- Utwórz klucz. Możesz ustawić dla niego limit dzienny, miesięczny i całkowity oraz ograniczyć, jakie modele może wywoływać.
- Doładuj saldo kartą, Apple Pay, Google Pay lub kryptowalutą. To saldo w dolarach amerykańskich, bez subskrypcji, a opłacone saldo nie wygasa.
- Wywołaj endpoint zadań z nazwą modelu:
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
--data '{
"model": "bytedance/seedream-5.0-pro/text-to-image",
"input": {
"prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
"resolution": "2k",
"aspect_ratio": "16:9"
}
}'
To wywołanie jest asynchroniczne: od razu zwraca ID zadania. Odpytuj GET https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=<id>, aż zadanie się zakończy, albo przy tworzeniu podaj adres callbacku. Gotowe obrazy są przechowywane w magazynie SpicyAPI do 14 dni, za podpisanymi linkami, więc nie ścigasz się z 24-godzinnym wygaśnięciem. Dokumentacja API zawiera opis pól, a strona Seedream 5.0 Pro pełny schemat wejścia, w tym edycje z obrazami referencyjnymi i rozdzielanie warstw.
Ceny za obraz z 12 października 2026:
| Model | SpicyAPI | Oficjalne BytePlus |
|---|---|---|
| Seedream 5.0 Pro, 1K | 0,036 $ | 0,045 $ |
| Seedream 5.0 Pro, 2K | 0,072 $ | 0,09 $ |
| Seedream 5.0 Lite | 0,0345 $ | 0,035 $ |
| Seedream 5.0 Flash | 0,029 $ | 0,018 $ |
| Seedream 4.0 | 0,03 $ | 0,03 $ |
Pro jest o 20% poniżej ceny oficjalnej w obu rozmiarach; SpicyAPI oferuje 1K i 2K, nie 1.5K. Lite i 4.0 kosztują mniej więcej tyle samo. Flash kosztuje w SpicyAPI więcej niż w BytePlus. Jeśli potrzebujesz tylko Flash, a twoje treści mieszczą się w politykach BytePlus, tańszym wyborem jest klucz oficjalny.
Większa różnica dotyczy tego, co wraca. SpicyAPI nie dodaje do Seedream żadnego filtra treści. W naszych wrześniowych testach Seedream 5.0 Pro zrealizował 33 z 34 uruchomień tekst na obraz i edycji dla dorosłych, Lite wszystkie 34, a Flash złagodził kilka mocniejszych zapytań. Pełne wyniki są w artykule Czy Seedream jest bez cenzury?. O tym, co narysuje, nadal decyduje sam model, a pełnoletność postaci i prawa do każdego edytowanego zdjęcia pozostają po twojej stronie.
Jaki klucz wybrać?
| Czego chcesz | Weź |
|---|---|
| Tylko Seedream, głównie obrazy ogólne lub komercyjne, konto bezpośrednio w ByteDance | Klucz BytePlus ModelArk |
| Najniższa cena Seedream 5.0 Flash | Klucz BytePlus ModelArk |
| Seedream plus wideo (Seedance, Wan, MiniMax) lub inne modele obrazu pod jednym kluczem i jednym saldem | Klucz platformy |
| Obrazy dla dorosłych bez filtra dostawcy z przodu | Klucz platformy bez dodanego filtra, np. SpicyAPI |
| Seedream 5.0 Pro w niższej cenie za obraz | SpicyAPI (0,036 $ w 1K) |
Możesz też używać obu: BytePlus do ogólnych prac, przy których jest najtańszy, a klucza platformy do całej reszty.
A „darmowy klucz API Seedream”?
„Seedream API key free” i „Seedream API key generator” to częste wyszukiwania. Nie istnieje oficjalny darmowy klucz. BytePlus pobiera opłatę za każdy obraz wyjściowy, a obrazy wejściowe są bezpłatne. Klucze publikowane na GitHubie lub na forach należą do cudzych kont. Przestają działać, gdy właściciel to zauważy, a wszystko, co na nich zbudujesz, psuje się razem z nimi. Strony-generatory obiecujące darmowy klucz albo odsprzedają dostęp, albo rozdają klucze, które nie są ich.
Najtańszy uczciwy sposób testowania to wysłanie kilku obrazów: dziesięć obrazów Seedream 5.0 Pro w 1K kosztuje mniej niż 50 centów na każdej z dróg. W SpicyAPI nieudane zadania zwykle nie są naliczane (każda strona modelu podaje, jeśli jakiś model jest wyjątkiem), a cena uruchomienia jest widoczna przed jego wysłaniem.
Rozwiązywanie problemów z nowym kluczem
- 401 lub „invalid API key”: sprawdź, czy nagłówek ma postać
Authorization: Bearer <key>i czy w zmiennej środowiskowej nie ma spacji ani znaku nowej linii na końcu. - Błędy dostępu lub „model not found” w BytePlus: ID modelu jest błędnie wpisane, klucz jest ograniczony do innych modeli albo należy do innej przestrzeni projektu. Jeśli nic z tego nie pasuje, sprawdź stronę Model activation.
- Błędy treści w BytePlus: filtr wstępny zablokował prompt lub wynik. Nie są naliczane. Przeformułowanie może pomóc przy granicznych treściach ogólnych. Do prac dla dorosłych najpierw przeczytaj politykę użytkowania BytePlus, bo jej podstawowe zasady treści obowiązują całe konto, nawet po wyłączeniu filtra.
- Linki przestają działać następnego dnia: adresy URL obrazów BytePlus wygasają po 24 godzinach. Zapisz plik, gdy tylko dotrze odpowiedź.
- Wywołania przestają działać po kilku dniach: sprawdź saldo konta. Konto na minusie przez dwie godziny jest zawieszane do czasu doładowania.
Najczęściej zadawane pytania
Gdzie znajdę swój klucz API Seedream?
W konsoli BytePlus, na stronie API keys. W SpicyAPI w Console → API keys. W obu miejscach lista kluczy pokazuje klucze, które utworzyłeś.
Czy API Seedream jest darmowe?
Nie. W BytePlus każdy obraz wyjściowy jest naliczany, od 0,018 $ za 5.0 Flash do 0,09 $ za 5.0 Pro powyżej 1.5K. Obrazy wejściowe są bezpłatne, z wyjątkiem tego, że Seedream 5.0 Pro pobiera 0,003 $ za każdy obraz wejściowy po pierwszym.
Jakie jest ID modelu Seedream 5.0?
W BytePlus: dola-seedream-5-0-pro-260628 dla Pro, dola-seedream-5-0-flash-260915 dla Flash i seedream-5-0-lite-260128 dla Lite. W SpicyAPI: bytedance/seedream-5.0-pro/text-to-image oraz odpowiadające nazwy dla Flash, Lite i edycji.
Czy mogę używać API Seedream do obrazów NSFW?
Nie z domyślnymi ustawieniami BytePlus: filtr wstępny treści blokuje treści dla dorosłych, a polityki treści BytePlus obowiązują nawet po jego wyłączeniu. W SpicyAPI nie ma dodanego filtra, a Seedream 5.0 Pro i Lite zrealizowały niemal wszystkie nasze testy dla dorosłych.
Seedream 4.5 czy 5.0?
W BytePlus 5.0 Lite (0,035 $) kosztuje mniej niż 4.5 (0,04 $), a 5.0 Flash (0,018 $) kosztuje mniej niż oba. Pro to ten, za który warto zapłacić więcej, gdy najważniejsza jest jakość obrazu. Nasze porównanie Lite, Pro i Flash zawiera wyniki obok siebie.
Podsumowanie
Zdobycie klucza API Seedream w BytePlus zajmuje kilka minut: utwórz klucz, użyj właściwego ID modelu, zapisuj każdy obraz w ciągu 24 godzin i pilnuj salda. To najtańsza droga do Seedream 5.0 Flash i właściwa do ogólnych prac na bezpośrednim koncie ByteDance. Jeśli chcesz mieć Seedream obok innych modeli obrazu i wideo pod jednym kluczem, niższą cenę Pro, wyniki dostępne do dwóch tygodni albo obrazy dla dorosłych bez filtra dostawcy, to pokrywa klucz SpicyAPI.
