Seedream 3.0 کو Rivya Public API v1 کے ذریعے model id seedream-3-0، supported inputs، parameters، Files API rules، credits اور response examples کے ساتھ استعمال کریں۔

API کے ذریعے availableText input readyتصویر

API model id

seedream-3-0

Inputs

text

Files API

Minimal request کے لیے required نہیں

Base credits

Capability

تصویر

Billing

FIXED

Prompt limit

5000 characters

Request contract

model id کو top level پر بھیجیں۔ Model-specific controls params میں رہتے ہیں۔

Key	Type	Required	Default	Description
model	string	Yes	seedream-3-0	seedream-3-0 API model id استعمال کریں۔
prompt	string	Yes	-	اس model کے لیے زیادہ سے زیادہ 5000 characters۔
params	object	No	-	Model-specific parameter object۔ allowed keys کے لیے نیچے والی rows استعمال کریں۔
client_request_id	string	No	-	آپ کے system میں requests trace کرنے کے لیے optional client-side id۔

Model parameters

Key	Type	Required	Default	Range	Options	Description
image_size	select	No	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 compositions کے لیے اچھا کام کرتا ہے۔
guidance_scale	number	No	2.5	min 1 / max 10 / step 0.1	-	Valid values 1 سے 10 تک ہیں۔ Higher values عموما prompt کو زیادہ closely follow کرتی ہیں، مگر output کو زیادہ rigid بھی بنا سکتی ہیں۔
seed	number	No	-	min 0 / max 2147483647	-	ہر بار نیا random result چاہیے ہو تو اسے empty چھوڑیں۔ اسی integer کو دوبارہ use کرنے سے previous result reproduce یا fine-tune کرنا آسان ہوتا ہے۔ Result صرف اسی وقت زیادہ قریب رہتا ہے جب prompt اور دوسرے key settings بھی similar رہیں، اور یہ guaranteed 1:1 match نہیں ہوتا۔

Minimal 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
}

Common errors

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found