تخطّي إلى المحتوى

Joyai Image Edit

التكامل

معرّف النموذج joyai-image-edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/joyai-image-edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ≈⁨‏0.10 $⁩ 100 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
JD تحرير الصور #image-to-image#image-editing

تحرير قائم على التعليمات لصورة واحدة، مع عناصر تحكم في المطالبة السلبية والخطوات والتوجيه

JD · صورة

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب

تعليمة التحرير التي تحدد التغييرات المطلوب تطبيقها على الصورة.

•مطلوب image_url
أفلت ملفًا، أو

عنوان URL الذي يشير إلى الصورة التي ستُحرر.

متقدم negative_prompt · output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker
الافتراضي

وصف المحتوى المراد استبعاده من صورة المخرج.

output_format الافتراضي jpeg

تنسيق الصورة الناتجة.

الافتراضي 30

عدد خطوات إزالة التشويش المطلوب تنفيذها.

الافتراضي 5

مدى الالتزام بتعليمة التحرير في المخرج.

بذرة تتحكم في العشوائية للحصول على نتائج قابلة لإعادة الإنتاج.

POST /run/joyai-image-edit?wait=20 عرض السعر → ⁨‏0.10 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/joyai-image-edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Joyai Image Edit

يحرر صورة إدخال واحدة (`image_url`) وفق مطالبة بلغة طبيعية `prompt` تصف التغيير. يوفر `negative_prompt` و`num_inference_steps` (من 1 إلى 50، والافتراضي 30) و`guidance_scale` (من 1 إلى 15، والافتراضي 5) و`seed`. يكون الخرج بصيغة jpeg أو png.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
تعليمة التحرير التي تحدد التغييرات المطلوب تطبيقها على الصورة.
image_urlمطلوب image
النوعurl · image
عنوان URL الذي يشير إلى الصورة التي ستُحرر.
negative_promptاختياري
النوعstring
الافتراضي
وصف المحتوى المراد استبعاده من صورة المخرج.
seedاختياري
النوعinteger | null
بذرة تتحكم في العشوائية للحصول على نتائج قابلة لإعادة الإنتاج.
num_inference_stepsاختياري
النوعinteger
الافتراضي30
1 – 50
عدد خطوات إزالة التشويش المطلوب تنفيذها.
guidance_scaleاختياري
النوعnumber
الافتراضي5
1 – 15
مدى الالتزام بتعليمة التحرير في المخرج.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكّن فحوصات الأمان للمدخلات والمخرجات.
output_formatاختياري
النوعenum
الافتراضيjpeg
jpegpng
تنسيق الصورة الناتجة.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "joyai-image-edit",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
images
array of object {url, content_type, file_name, file_size, width, height}صورة المخرج بعد التحرير.
timings
object
seed
integerبذرة توليد الصورة، بما في ذلك القيمة المختارة عشوائيًا إذا لم يتضمن المدخل بذرة؛ وإلا تكرر القيمة المقدمة.
has_nsfw_concepts
array of booleanيشير إلى ما إذا كانت مفاهيم NSFW تظهر في الصور المُولّدة.
prompt
stringالموجّه المستخدم أثناء توليد الصورة.

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/joyai-image-edit.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt