Brug Seedream 3.0 via Rivya Public API v1 med model-id seedream-3-0, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APITekstinput klarBillede

API-model-id

seedream-3-0

Inputs

text

Files API

Ikke krævet for minimal anmodning

Basiscredits

Funktion

Billede

Fakturering

FIXED

Promptgrænse

5000 tegn

Anmodningskontrakt

Send model-id'et på øverste niveau. Modelspecifikke kontroller hører hjemme i params.

Nøgle	Type	Krævet	Standard	Beskrivelse
model	string	Ja	seedream-3-0	Brug API-model-id'et seedream-3-0.
prompt	string	Ja	-	Maksimalt 5000 tegn for denne model.
params	object	Nej	-	Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys.
client_request_id	string	Nej	-	Valgfrit klientside-id til at spore anmodninger i dit system.

Modelparametre

Nøgle	Type	Krævet	Standard	Interval	Valgmuligheder	Beskrivelse
image_size	select	Nej	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Styrer outputtets indramningsform. Kvadratisk HD er den aktuelle standard og fungerer godt til de fleste generelle kompositioner.
guidance_scale	number	Nej	2.5	min 1 / max 10 / step 0.1	-	Gyldige værdier går fra 1 til 10. Højere værdier følger normalt prompten tættere, men kan også få outputtet til at føles mere stift.
seed	number	Nej	-	min 0 / max 2147483647	-	Lad feltet stå tomt for et nyt tilfældigt resultat hver gang. Genbrug af det samme heltal gør det lettere at reproducere eller finjustere et tidligere resultat. Det holder sig kun tættere på, når prompten og andre vigtige indstillinger også forbliver nogenlunde ens, og det garanterer ikke et 1:1-match.

Minimal anmodning

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

Oprettelsessvar

Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.

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

Almindelige fejl

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found