وثائق Rivya AI
صفحات API للنماذج

دمج API لنموذج Seedream 5.0 Pro Layer Decomposition

استخدم Seedream 5.0 Pro Layer Decomposition عبر Rivya Public API v1 مع معرف النموذج seedream-5-pro-layer-decomposition، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والأرصدة، وأمثلة الاستجابة.

متاح عبر APIالجاهزيةصورة
معرف نموذج API

seedream-5-pro-layer-decomposition

المدخلات

file

Files API

مطلوب لأوضاع المراجع

الأرصدة الأساسية

per_image · 1K=7 · 1.5K=7 · 2K=14 · auto_reserve=14 · ⌈total⌉

القدرة

صورة

الفوترة

FIXED

حد prompt

5000 أحرف

عقد الطلب

أرسل معرف النموذج في المستوى الأعلى. توضع عناصر التحكم الخاصة بالنموذج داخل params.

المفتاحالنوعمطلوبالافتراضيالوصف
modelstringنعمseedream-5-pro-layer-decompositionاستخدم معرف نموذج API وهو seedream-5-pro-layer-decomposition.
promptstringلا-الحد الأقصى لهذا النموذج هو 5000 حرفًا.
paramsobjectلا-كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_idstringلا-معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

معلمات النموذج

المفتاحالنوعمطلوبالافتراضيالنطاقالخياراتالوصف
sizeselectلاauto-auto, 1K, 1.5K, 2Kحجم الإخراج
output_formatselectلاjpeg-jpeg, pngيتحكم هذا الإعداد في الصورة الأساسية. تعاد الطبقات المفصولة في ملفات PNG.

سياسة الرفع

ارفع ملفات المراجع أولا، ثم ضع URL وduration token اللذين تم إرجاعهما داخل params.referenceMediaItems.

قاعدة المرجع

صورة المصدر: ارفع صورة واحدة بالضبط بتنسيق PNG أو JPEG أو WebP أو BMP أو TIFF أو GIF وبحجم يصل إلى 30 MB؛ لا يدعم التنسيقان HEIC وHEIF.

الحد الأقصى للملفات

1

أنواع الملفات المقبولة

image

Duration token

ينبغي أن تحمل مراجع الفيديو والصوت durationToken من /api/v1/files عندما يكون التحقق من المدة مطلوبا.

kindالحد الأقصى للحجمأنواع MIME
image30 MBimage/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

الطلب الأدنى

{
  "model": "seedream-5-pro-layer-decomposition",
  "params": {
    "size": "auto",
    "output_format": "jpeg"
  }
}

طلب بملف مرجعي

{
  "model": "seedream-5-pro-layer-decomposition",
  "params": {
    "size": "auto",
    "output_format": "jpeg",
    "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"
      }
    ]
  }
}

استجابة الإنشاء

تعيد نقطة نهاية الإنشاء معرف مهمة عامًا. استعلم عن نقطة نهاية الحالة حتى تنجح المهمة أو تفشل.

{
  "id": "task_seedream_5_pro_layer_decomposition_example",
  "status": "queued",
  "model": "seedream-5-pro-layer-decomposition",
  "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
}

الأخطاء الشائعة

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

تتطلب بعض الأوضاع رفع مراجع عبر Files API.