استخدم Recraft Remove Background عبر Rivya Public API v1 مع معرف النموذج recraft-remove-background، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والأرصدة، وأمثلة الاستجابة.

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

معرف نموذج API

recraft-remove-background

المدخلات

file

Files API

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

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

per_image · default=1 · ⌈total⌉

القدرة

صورة

الفوترة

FIXED

حد prompt

لا يوجد حد prompt موثق

عقد الطلب

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

المفتاح	النوع	مطلوب	الافتراضي	الوصف
model	string	نعم	recraft-remove-background	استخدم معرف نموذج API وهو recraft-remove-background.
prompt	string	لا	-	نص prompt للنماذج التي تدعم إدخال النص.
params	object	لا	-	كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_id	string	لا	-	معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

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

لا يحتاج هذا النموذج إلى params إضافية بعد model وprompt وclient_request_id الاختياري.

سياسة الرفع

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

قاعدة المرجع

صورة مصدر: ارفع صورة واحدة فقط بصيغة JPG أو PNG أو WebP، بحد أقصى 5 MB و16 MP، ويجب أن يكون كل بُعد بين 256 و4096 بكسل.

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

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

image

Duration token

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

kind	الحد الأقصى للحجم	أنواع MIME
image	5 MB	image/jpeg, image/png, image/webp

الطلب الأدنى

{
  "model": "recraft-remove-background"
}

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

{
  "model": "recraft-remove-background",
  "params": {
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_recraft_remove_background_example",
  "status": "queued",
  "model": "recraft-remove-background",
  "reserved_credits": 1,
  "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.

دمج API لنموذج Recraft Remove Background