Używaj Seedream 3.0 przez Rivya Public API v1 z identyfikatorem modelu seedream-3-0, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APIWejście tekstowe gotoweObraz

Identyfikator modelu API

seedream-3-0

Wejścia

text

Files API

Niewymagane dla żądania minimalnego

Kredyty bazowe

Możliwość

Obraz

Rozliczenia

FIXED

Limit promptu

5000 znaków

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

Klucz	Typ	Wymagane	Domyślnie	Opis
model	string	Tak	seedream-3-0	Użyj seedream-3-0 jako identyfikatora modelu API.
prompt	string	Tak	-	Maksymalnie 5000 znaków dla tego modelu.
params	object	Nie	-	Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_id	string	Nie	-	Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

Klucz	Typ	Wymagane	Domyślnie	Zakres	Opcje	Opis
image_size	select	Nie	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Kontroluje kształt kadru wyjściowego. Square HD jest obecnym ustawieniem domyślnym i dobrze działa dla większości ogólnych kompozycji.
guidance_scale	number	Nie	2.5	min 1 / max 10 / step 0.1	-	Prawidłowe wartości mieszczą się od 1 do 10. Wyższe wartości zwykle dokładniej podążają za promptem, ale mogą też sprawić, że wynik będzie bardziej sztywny.
seed	number	Nie	-	min 0 / max 2147483647	-	Pozostaw puste, aby za każdym razem uzyskać nowy losowy wynik. Ponowne użycie tej samej liczby całkowitej ułatwia odtworzenie albo dopracowanie poprzedniego wyniku. Wynik pozostaje bliższy tylko wtedy, gdy prompt i inne kluczowe ustawienia również pozostają podobne; nie jest to gwarantowane dopasowanie 1:1.

Żądanie minimalne

{
  "model": "seedream-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "guidance_scale": 2.5,
    "seed": 0
  }
}

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się sukcesem albo błędem.

{
  "id": "task_seedream_3_0_example",
  "status": "queued",
  "model": "seedream-3-0",
  "reserved_credits": 5,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found