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

API üzerinden kullanılabilirMetin veya URL hazır; referans modları Files API kullanırGörsel

API model kimliği

seedream-5-pro

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

per_image_plus_reference_image · basic=7 · high=14 · additional_input_image=0.5 · ⌈total⌉

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-5-pro	seedream-5-pro API model kimliği 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
aspect_ratio	select	Hayır	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9	En-boy oranı
quality	select	Hayır	basic	-	basic, high	Kalite
output_format	select	Hayır	png	-	png, jpeg	Çıktı biçimi
nsfw_checker	select	Hayır	false	-	false, true	Modelin isteğe bağlı içerik filtresini etkinleştirin. Hiçbir otomatik filtre eksiksiz kapsama garantisi veremez.

Yükleme politikası

Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.

Referans kuralı

Referans görseller: Her biri en fazla 10 MB olan, 10 adede kadar JPEG, PNG veya WebP görsel yükleyin.

Maks. dosya

Kabul edilen dosya türleri

image

Süre belirteci

Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.

kind	Maks. boyut	MIME türleri
image	10 MB	image/jpeg, image/png, image/webp

Minimal istek

{
  "model": "seedream-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "quality": "basic",
    "output_format": "png",
    "nsfw_checker": "false"
  }
}

Referans dosyalı istek

{
  "model": "seedream-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "quality": "basic",
    "output_format": "png",
    "nsfw_checker": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

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_5_pro_example",
  "status": "queued",
  "model": "seedream-5-pro",
  "reserved_credits": 7,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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

Bazı modlar Files API referans yüklemeleri gerektirir.

Seedream 5.0 Pro API Entegrasyonu