Rivya AI Docs
Model API Pages

Seedance 1.5 Pro API Integration

Seedance 1.5 Pro کو Rivya Public API v1 کے ذریعے model id seedance-1-5-pro، supported inputs، parameters، Files API rules، credits اور response examples کے ساتھ استعمال کریں۔

API کے ذریعے availableText یا URL ready؛ reference modes Files API استعمال کرتے ہیںویڈیو
API model id

seedance-1-5-pro

Inputs

text, file

Files API

Reference modes کے لیے required

Base credits

28

Capability

ویڈیو

Billing

FIXED

Prompt limit

2500 characters

Request contract

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

KeyTypeRequiredDefaultDescription
modelstringYesseedance-1-5-proseedance-1-5-pro API model id استعمال کریں۔
promptstringYes-اس model کے لیے زیادہ سے زیادہ 2500 characters۔
paramsobjectNo-Model-specific parameter object۔ allowed keys کے لیے نیچے والی rows استعمال کریں۔
client_request_idstringNo-آپ کے system میں requests trace کرنے کے لیے optional client-side id۔

Model parameters

KeyTypeRequiredDefaultRangeOptionsDescription
resolutionselectNo720p-480p, 720p, 1080pریزولوشن
durationselectNo8-4, 8, 12دورانیہ
generate_audioselectNofalse-false, trueAudio بنائیں
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 21:9فریم تناسب
fixed_lensselectNofalse-false, trueیہ control کرتا ہے کہ shot کو زیادہ fixed camera جیسا behave کرنا چاہیے یا نہیں۔ آن کرنے سے camera motion زیادہ restrained رہتا ہے؛ آف کرنے سے movement زیادہ واضح ہو سکتی ہے۔

Upload policy

Reference files پہلے upload کریں، پھر returned URL اور duration token کو params.referenceMediaItems کے اندر رکھیں۔

Reference rule

ریفرنس تصویر: Image projects کے لیے 2 image files تک upload کریں۔

Max files

2

Accepted file kinds

image

Duration token

duration verification required ہو تو video اور audio references کو /api/v1/files سے durationToken ساتھ رکھنا چاہیے۔

kindMax sizeMIME types
image10 MBimage/jpeg, image/png, image/webp

Minimal request

{
  "model": "seedance-1-5-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "8",
    "generate_audio": "false",
    "aspectRatio": "1:1",
    "fixed_lens": "false"
  }
}

Reference-file request

{
  "model": "seedance-1-5-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "8",
    "generate_audio": "false",
    "aspectRatio": "1:1",
    "fixed_lens": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Create response

create endpoint ایک public task id واپس کرتا ہے۔ task succeeded یا failed ہونے تک status endpoint poll کریں۔

{
  "id": "task_seedance_1_5_pro_example",
  "status": "queued",
  "model": "seedance-1-5-pro",
  "reserved_credits": 28,
  "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

کچھ modes کو Files API reference uploads درکار ہوتے ہیں۔