Seedream 5.0 Pro

Seedream 5.0 Pro to model obrazów od ByteDance. Jedno żądanie tworzy jeden obraz z promptu lub promptu z maksymalnie 10 obrazami referencyjnymi albo dzieli jeden obraz na obraz tła i do 16 przezroczystych warstw. Wyślij żądanie, zachowaj zwrócony identyfikator zadania i odczytaj gotowe obrazy z tego zadania. Obrazy referencyjne przekazujesz jako adresy URL.

ID modeli

Aktualne ceny znajdziesz na stronie modelu.

Krótki przykład

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "size": "1K",
    "watermark": false
  }'

Punkt końcowy

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

Odpowiedź to zadanie ({"id": "task_...", "status": "processing"}), a nie gotowy obraz. Wynik odczytasz, odpytując GET /v1/tasks/{task_id}. Klucze API trzymaj w kodzie po stronie serwera. Obrazy referencyjne i podział na warstwy przekazujesz w tym samym żądaniu przez image; /v1/images/edits nie jest używane dla tego modelu i zwraca 400.

Parametry

Pola spoza tej listy są usuwane przed przekazaniem żądania dalej; nigdy nie powodują błędu ani nie zmieniają wyniku. n, stream, seed, response_format i generowanie sekwencyjne nie są dostępne. callback_url nie jest dostępne; zamiast tego odpytuj zadanie.

Rozmiar wyjściowy

Poziom określa skalę, a prompt — format. Podaj proporcje obrazu w prompt (np. „poziomy kadr 16:9”), a model dobierze kadr:

Aby uzyskać stały kadr, wyślij dokładne wymiary w pikselach zamiast poziomu. 1K i 1.5K kosztują tyle samo; 2K i każdy rozmiar powyżej 2,61 miliona pikseli kosztują więcej (zobacz Czynniki wpływające na koszt).

Obrazy referencyjne

Przekaż jeden obraz, aby go edytować, lub 2–10, aby je połączyć, i napisz w prompt, co zachować, a co zmienić. Odwołuj się do nich według kolejności („kurtka z obrazu 1”).

{
  "model": "seedream-5-0-pro",
  "prompt": "Put the jacket from image 1 on the model from image 2, standing on a rainy street at night.",
  "image": ["https://example.com/jacket.png", "https://example.com/model.jpg"],
  "size": "1.5K"
}

Podział na warstwy

Wyślij dokładnie jeden obraz z layer_decomposition: true. Zadanie zwraca najpierw obraz tła, a następnie każdą warstwę jako przezroczysty PNG.

{
  "model": "seedream-5-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

Każda warstwa zawiera z_index (obraz tła ma 0; wyższe liczby oznaczają warstwy powyżej), name, description i bounding_box. bounding_box.absolute to [left, top, right, bottom] w pikselach obrazu tła; bounding_box.normalized to ta sama ramka w tysięcznych częściach szerokości i wysokości obrazu tła. Aby odtworzyć obraz, przeskaluj każdą warstwę do jej ramki i umieść ją na obrazie tła w rosnącej kolejności z_index.

Przy size: "auto" obraz tła i każda warstwa zachowują swój rozmiar z obrazu wejściowego. Obraz wejściowy musi być w PNG lub JPEG i mieć łącznie od 262 144 (512 × 512) do 36 000 000 (6000 × 6000) pikseli (szerokość × wysokość).

Przezroczyste tło

Wyślij jeden PNG z kanałem alfa i background: "transparent", aby otrzymać PNG z przezroczystym tłem:

{
  "model": "seedream-5-0-pro",
  "prompt": "Turn this sticker into a glossy enamel pin, keep the outline.",
  "image": "https://example.com/sticker.png",
  "background": "transparent",
  "output_format": "png"
}

Dane wejściowe multimediów

Każdy obraz referencyjny to publiczny adres URL HTTP(S). Dane base64 (data URI) nie są przyjmowane: prześlij plik do własnego magazynu i przekaż jego adres URL. Akceptowane formaty to JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC i HEIF, do 30 MB każdy, w proporcjach od 1:16 do 16:1, o szerokości i wysokości większej niż 14 pikseli i łącznej liczbie najwyżej 36 000 000 pikseli. Podział na warstwy przyjmuje tylko PNG lub JPEG.

Czynniki wpływające na koszt

Aktualne stawki znajdziesz w sekcji cen modelu. Seedream 5.0 Pro jest rozliczany za obraz wyjściowy według scenariusza i progu liczby pikseli, z dopłatą za każdy obraz referencyjny po pierwszym:

generation:          cost = image price for its tier + extra references × reference price
layer decomposition: cost = images returned × per-image price for the request's tier

• Niższy próg cenowy obejmuje obrazy do 2,61 miliona pikseli (1.5K i mniej); większe trafiają do wyższego progu.
• Podział na warstwy rozlicza obraz tła i każdą warstwę. Całe żądanie korzysta z jednego progu cenowego: niższa cena obowiązuje tylko wtedy, gdy każdy zwrócony obraz mieści się w 2,61 miliona pikseli.
• Kwota zarezerwowana przy przyjęciu zadania pokrywa największy wynik: jeden obraz w żądanym progu cenowym lub 17 obrazów przy podziale na warstwy (auto liczy się jako wyższy próg). Zadanie jest następnie rozliczane za faktycznie zwrócone obrazy, a różnica zostaje zwolniona.

Ostateczne opłaty zobaczysz w historii zużycia swojego konta. Nieudane zadania nie są naliczane.

Schemat odpowiedzi

Wysłanie zwraca zadanie:

{"id": "task_...", "model": "seedream-5-0-pro", "status": "processing", "created_at": 1789689600}

Pobieranie zadania

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Odpytuj co 10–20 sekund, aż status przyjmie wartość completed lub failed. Przekroczenie limitu czasu sieci podczas odpytywania nie oznacza, że generowanie się nie powiodło: zachowaj identyfikator zadania i wznów sprawdzanie. Nie twórz kolejnego zadania, aby sprawdzić postęp.

Zadanie zakończone

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689653,
  "output": {
    "created": 1789689650,
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg",
        "size": "1024x1024",
        "output_format": "jpeg"
      }
    ],
    "usage": { "output_tokens": 4096, "total_tokens": 4096 }
  }
}

Zadanie podziału na warstwy wylicza najpierw obraz tła, a potem każdą warstwę:

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg", "size": "832x1248", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "527x1044",
      "output_format": "png",
      "z_index": 1,
      "name": "Ceramic coffee cup",
      "description": "White ceramic cup with a matte glaze, extracted without the table.",
      "bounding_box": { "absolute": [212, 418, 610, 1206], "normalized": [255, 335, 733, 966] }
    }
  ]
}

W naszych testach obraz 1K powstawał w około 35–55 sekund, a podział na warstwy w 1K, który zwrócił obraz tła i 13 warstw, trwał około 140 sekund.

Błędy

Żądania odrzucone przed utworzeniem zadania zwracają błąd HTTP wraz z obiektem error i nie są naliczane. Zadanie, które zawiodło po przyjęciu, przy odpytaniu zwraca HTTP 200 z status: "failed" i obiektem error.

Kody, statusy HTTP i wskazówki dotyczące ponawiania znajdziesz we wspólnym katalogu błędów.

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Jeśli limit czasu został przekroczony przy samym wysyłaniu, przed ponownym wysłaniem sprawdź swoje zadania: pierwsze żądanie mogło już zostać przyjęte.

Wskazówki

• Zacznij od 1K lub 1.5K przy kolejnych próbach; 1.5K kosztuje tyle samo co 1K.
• Gdy używasz poziomu rozdzielczości, podaj format w prompcie lub wyślij dokładne wymiary w pikselach dla stałego układu.
• Przy kilku obrazach referencyjnych określ wkład każdego i odwołuj się do nich według kolejności.
• Ustaw watermark: false, gdy potrzebujesz obrazu bez oznaczenia; domyślnie jest ono dodawane.
• Przy podziale na warstwy wymień elementy do wydzielenia, aby ograniczyć liczbę warstw.

Powiązane

• Playground i ceny Seedream 5.0 Pro
• Pobierz OpenAPI
• Markdown do skopiowania