Käytä mallia Seedream 3.0 Rivya Public API v1:n kautta malli-ID:llä seedream-3-0; mukana ovat tuetut syötteet, parametrit, Files API -säännöt, krediitit ja vastausesimerkit.

Saatavilla API:n kauttaTekstisyöte valmisImage

API-malli-ID

seedream-3-0

Syötteet

text

Files API

Ei vaadita minimipyynnössä

Peruskrediitit

Kyvykkyys

Image

Laskutus

FIXED

Prompt-raja

5000 merkkiä

Pyyntösopimus

Lähetä malli-ID ylätason kentässä. Mallikohtaiset ohjaimet kuuluvat params-objektiin.

Avain	Tyyppi	Pakollinen	Oletus	Kuvaus
model	string	Kyllä	seedream-3-0	Käytä seedream-3-0-arvoa API-malli-ID:nä.
prompt	string	Kyllä	-	Enintään 5000 merkkiä tälle mallille.
params	object	Ei	-	Mallikohtainen parametriobjekti. Käytä alla olevia rivejä sallittuihin avaimiin.
client_request_id	string	Ei	-	Valinnainen asiakaspuolen ID pyyntöjen jäljittämiseen omassa järjestelmässäsi.

Malliparametrit

Avain	Tyyppi	Pakollinen	Oletus	Alue	Vaihtoehdot	Kuvaus
image_size	select	Ei	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Säätää tulosteen rajausmuotoa. Square HD on nykyinen oletus ja toimii hyvin useimmissa yleissommitelmissa.
guidance_scale	number	Ei	2.5	min 1 / max 10 / step 0.1	-	Sallitut arvot ovat 1-10. Suuremmat arvot seuraavat yleensä promptia tarkemmin, mutta voivat myös tehdä tuloksesta jäykemmän.
seed	number	Ei	-	min 0 / max 2147483647	-	Jätä tyhjäksi, jos haluat joka kerta uuden satunnaisen tuloksen. Saman kokonaisluvun käyttäminen uudelleen helpottaa aiemman tuloksen toistamista tai hienosäätöä. Tulos pysyy lähempänä vain silloin, kun kehote ja muut keskeiset asetukset ovat myös samankaltaisia, eikä se takaa täsmälleen samaa lopputulosta.

Minimipyyntö

{
  "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
  }
}

Create-vastaus

Create-endpoint palauttaa julkisen tehtävä-ID:n. Pollaa status-endpointia, kunnes tehtävä onnistuu tai epäonnistuu.

{
  "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
}

Yleiset virheet

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found