Använd Seedream 3.0 via Rivyas publika API v1 med modell-ID seedream-3-0, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.

Tillgänglig via APITextinmatning klarBild

API-modell-ID

seedream-3-0

Inmatningar

text

Files API

Krävs inte för minimal begäran

Baskrediter

Förmåga

Bild

Fakturering

FIXED

Promptgräns

5000 tecken

Kontrakt för begäran

Skicka modell-ID:t på toppnivå. Modellspecifika kontroller hör hemma i params.

Nyckel	Typ	Obligatoriskt	Standard	Beskrivning
model	string	Ja	seedream-3-0	Använd API-modell-ID:t seedream-3-0.
prompt	string	Ja	-	Högst 5000 tecken för den här modellen.
params	object	Nej	-	Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_id	string	Nej	-	Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

Nyckel	Typ	Obligatoriskt	Standard	Intervall	Alternativ	Beskrivning
image_size	select	Nej	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Styr resultatets inramningsformat. Square HD är nuvarande standard och fungerar bra för de flesta allmänna kompositioner.
guidance_scale	number	Nej	2.5	min 1 / max 10 / step 0.1	-	Giltiga värden går från 1 till 10. Högre värden följer vanligtvis prompten närmare men kan också få resultatet att kännas stelare.
seed	number	Nej	-	min 0 / max 2147483647	-	Lämna fältet tomt för ett nytt slumpmässigt resultat varje gång. Om du återanvänder samma heltal blir det enklare att återskapa eller finjustera ett tidigare resultat. Det blir bara mer likt när prompten och andra viktiga inställningar också förblir liknande, och en identisk 1:1-matchning garanteras inte.

Minimal begäran

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

Skapa-svar

Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.

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

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found