Przejdź do treści
PlaygroundDokumentacjaZdobądź klucz API

Mage API · Model obrazu

Seedream API

Seedream, ze ścisłym filtrem

Zdobądź klucz APIWypróbuj Seedream w playgroundzie
POST https://api.mage.space/v1/seedream/generate

W skrócie

Seedream API uruchamia Seedream 5.5 i 5 innych wariantów przez Mage pod adresem POST https://api.mage.space/v1/seedream/generate. Zapytanie z ustawieniami domyślnymi kosztuje 42 Gems (około 0,042 $), bez subskrypcji. Seedream obsługuje zapisane postacie i referencje przez @handle w prompcie.

  • ObrazWynik
  • 6Warianty
  • 42Gems za obraz, domyślnie
  • $0.042Około, w USD

Przegląd

Co robi Seedream API

Seedream od ByteDance: od Seedream 5.0 Flash do szkiców po Seedream 5.5, najnowszy i domyślny, ze szczegółowymi scenami, czytelnym tekstem i edycją na podstawie maksymalnie 10 referencji lub Characters, do 4K w Seedream 4.5. Ścisły filtr: prompty i pierwsze obrazy są sprawdzane przed każdym uruchomieniem.

Rodzina modeli obrazów Seedream od ByteDance, do szczegółowych scen, czytelnego tekstu i edycji na podstawie maks. 10 referencji lub Characters: Seedream 5.5 (`seedream-5.5`), najnowszy i domyślny, z bardziej realistycznymi obrazami, wyraźniejszym drobnym tekstem i stabilniejszymi powtarzanymi edycjami; Seedream 5.0 Pro (`seedream-5.0-pro`), poprzedni model flagowy; Seedream 5.0 Flash (`seedream-5.0-flash`), jedna stała cena z uwzględnionymi obrazami wejściowymi, najniższa w 2K lub z obrazami wejściowymi (Seedream 5.5 kosztuje mniej przy samym prompcie w 1K); Seedream 5.0 Lite (`seedream-5.0-lite`), do 3K; Seedream 4.5 (`seedream-4.5`), do 4K; oraz Seedream 4.0 (`seedream-4.0`). Ścisły filtr: Mage sprawdza prompt i pierwszy obraz przed uruchomieniem; odrzucone żądanie kończy się błędem `content_blocked` z podaniem powodu, a Gemy są zwracane.

Przyjmuje dane wejściowe: image, additional_images.

Szybki start

Wywołaj Seedream API

Ustaw MAGE_API_KEY, wyślij żądanie na /seedream/generate i odpytuj status_url, aż żądanie się zakończy.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedream/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "seedream-5.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('seedream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'seedream-5.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seedream", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "seedream-5.5",
})

print(request["result"]["url"])

Modele

Wartości model_id dla Seedream

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
seedream-4.0Seedream 4.0
seedream-4.5Seedream 4.5
seedream-5.0-liteSeedream 5.0 Lite
seedream-5.0-proSeedream 5.0 Pro
seedream-5.0-flashSeedream 5.0 Flash
seedream-5.5Seedream 5.5Tak

Opcje

Parametry Seedream

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Dane wejściowe

Media wejściowe akceptowane przez Seedream

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

PoleRola
imageObraz referencyjny.
additional_imagesDodatkowe obrazy referencyjne.

Więcej modeli obrazów

Inne API do generowania obrazów w Mage

FAQ

Najczęściej zadawane pytania

Ile kosztuje Seedream API?
Zapytanie do Seedream z ustawieniami domyślnymi (Seedream 5.5) kosztuje 42 Gems, czyli około 0,042 $. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę, a dokładną opłatę podaje odpowiedź. Za nieudane generowanie zwracamy koszt, ale nie za takie, które zablokuje polityka treści Mage.
Jaki jest endpoint Seedream API?
POST https://api.mage.space/v1/seedream/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz Mage API. Odpowiedź zawiera status_url, który odpytujesz, aby odebrać wynik.
Które modele Seedream mogę wywołać?
seedream-4.0 (Seedream 4.0), seedream-4.5 (Seedream 4.5), seedream-5.0-lite (Seedream 5.0 Lite), seedream-5.0-pro (Seedream 5.0 Pro), seedream-5.0-flash (Seedream 5.0 Flash), seedream-5.5 (Seedream 5.5). Domyślny jest Seedream 5.5.
Czy Seedream obsługuje obrazy referencyjne lub postacie?
Seedream akceptuje image, additional_images. Seedream obsługuje zapisane postacie i referencje przez @handle w prompcie.
Czy mogę używać Seedream w Claude lub ChatGPT?
Tak. Podłącz serwer Mage MCP do Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Seedream po nazwie. Twój asystent odczyta jego opcje przez get_model i poda cenę, zanim wygeneruje wynik.
Jak długo przechowywane są wyniki Seedream?
Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

Zdobądź klucz APIWypróbuj Seedream w playgroundzie