Rivya Public API v1 দিয়ে Seedream 3.0 ব্যবহার করুন: model id seedream-3-0, সমর্থিত ইনপুট, প্যারামিটার, Files API নিয়ম, ক্রেডিট এবং response উদাহরণসহ।

API দিয়ে উপলভ্যটেক্সট ইনপুট প্রস্তুতছবি

API model id

seedream-3-0

ইনপুট

text

Files API

minimal request-এর জন্য প্রয়োজন নেই

বেস ক্রেডিট

ক্ষমতা

ছবি

বিলিং

FIXED

প্রম্পট সীমা

5000 অক্ষর

রিকোয়েস্ট contract

model id top level-এ পাঠান। Model-specific control params-এ থাকবে।

Key	ধরন	প্রয়োজনীয়	ডিফল্ট	বিবরণ
model	string	হ্যাঁ	seedream-3-0	seedream-3-0 API model id ব্যবহার করুন।
prompt	string	হ্যাঁ	-	এই model-এর জন্য সর্বোচ্চ 5000 অক্ষর।
params	object	না	-	মডেল-নির্দিষ্ট প্যারামিটার object। অনুমোদিত key-এর জন্য নিচের row ব্যবহার করুন।
client_request_id	string	না	-	আপনার সিস্টেমে request trace করার ঐচ্ছিক client-side id।

মডেল প্যারামিটার

Key	ধরন	প্রয়োজনীয়	ডিফল্ট	পরিসর	বিকল্প	বিবরণ
image_size	select	না	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	output framing shape control করে। Square HD current default এবং বেশিরভাগ general composition-এর জন্য ভালো।
guidance_scale	number	না	2.5	min 1 / max 10 / step 0.1	-	valid value 1 থেকে 10। higher value সাধারণত prompt আরও closely follow করে, তবে output বেশি rigid লাগতে পারে।
seed	number	না	-	min 0 / max 2147483647	-	প্রতিবার নতুন random result চাইলে empty রাখুন। একই integer reuse করলে আগের result reproduce বা fine-tune করা সহজ হয়। Prompt এবং অন্য key setting একই রকম থাকলেই শুধু result কাছাকাছি থাকে, এবং এটি guaranteed 1:1 match নয়।

ন্যূনতম request

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

create endpoint public task id ফেরত দেয়। task succeeded বা failed না হওয়া পর্যন্ত status endpoint poll করুন।

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

সাধারণ ত্রুটি

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found