Seedream 3.0 modelini Rivya Public API v1 üzerinden model id seedream-3-0, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirMetin girişi hazırGörsel

API model id

seedream-3-0

Girişler

text

Files API

Minimal istek için gerekli değil

Temel krediler

Yetenek

Görsel

Faturalandırma

FIXED

Prompt limiti

5000 karakter

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

Anahtar	Tür	Gerekli	Varsayılan	Açıklama
model	string	Evet	seedream-3-0	seedream-3-0 API model id değerini kullanın.
prompt	string	Evet	-	Bu model için en fazla 5000 karakter.
params	object	Hayır	-	Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_id	string	Hayır	-	Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Anahtar	Tür	Gerekli	Varsayılan	Aralık	Seçenekler	Açıklama
image_size	select	Hayır	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Çıktının kadraj şeklini kontrol eder. Kare HD mevcut varsayılandır ve çoğu genel kompozisyon için iyi çalışır.
guidance_scale	number	Hayır	2.5	min 1 / max 10 / step 0.1	-	Geçerli değerler 1 ile 10 arasındadır. Daha yüksek değerler genellikle komutu daha yakından izler, ancak çıktıyı daha katı da hissettirebilir.
seed	number	Hayır	-	min 0 / max 2147483647	-	Her seferinde yeni bir rastgele sonuç için boş bırakın. Aynı tam sayıyı yeniden kullanmak, önceki bir sonucu yeniden üretmeyi veya ince ayar yapmayı kolaylaştırır. Yalnızca istem ve diğer temel ayarlar da benzer kaldığında sonuca daha yakın durur; bire bir eşleşme garanti değildir.

Minimal istek

{
  "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 yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

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

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found