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

PhotoMaker

التكامل

معرّف النموذج photomaker
# 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/photomaker?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_archive_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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.022 $⁩ 22 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Tencent تحرير الصور #editing#customization#realism#personalization

إنشاء صور شخصية مخصصة من أرشيف صور مرجعية، مع إعدادات أنماط ودعم img2img اختياري

Tencent · صورة

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

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

إنشاء طلب

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

•مطلوب

صِف الصورة التي تريد توليدها بأكبر قدر ممكن من التفصيل للحصول على أفضل النتائج.

•مطلوب

قدّم الصور المطلوب استخدامها في أرشيف، مع تحديدها بعنوان URL.

num_images الافتراضي 1

حدد عدد الصور التي ينتجها طلب واحد، مع إتاحة وقت توليد أطول للدفعات الأكبر.

متقدم negative_prompt · initial_image_url · base_pipeline · style · initial_image_strength · num_inference_steps · style_strength · guidance_scale · seed · enable_safety_checker
الافتراضي

موجّه سلبي يحدد تفاصيل الصورة غير المرغوبة. يمكنه استبعاد الألوان والعناصر والمشهد أو السمات والصفات الدقيقة، مثل الشارب أو الضبابية أو الدقة المنخفضة.

أفلت ملفًا، أو

صورة بداية اختيارية لمعالجة img2img.

base_pipeline الافتراضي photomaker

خط الأنابيب الأساسي المستخدم لتوليد الصور.

الافتراضي Photographic
الافتراضي 0.5

مستوى تشويش الصورة الكامنة، من دون تشويش مضاف عند O إلى الحد الأقصى عند 1.

الافتراضي 50

يتحكم في عدد خطوات التوليد التي ينفذها Stable Diffusion؛ وقد تنتج الخطوات الإضافية صورة نهائية أكثر تفصيلاً.

الافتراضي 20
الافتراضي 5

قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).

بذرة لإعادة إنتاج الصور في Stable Diffusion. يمكن إعادة إنتاج الصورة تمامًا في كل تشغيل بالحفاظ على إصدار النموذج والموجّه والبذرة دون تغيير.

POST /run/photomaker?wait=20 عرض السعر → ⁨‏0.022 $⁩
# 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/photomaker?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_archive_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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

حول PhotoMaker

ينشئ صورًا جديدة لشخص من أرشيف يشبه zip لصورهم (`image_archive_url`) إضافة إلى مطالبة نصية مطلوبة `prompt`. اختر خط الأنابيب الأساسي `photomaker` أو `photomaker-style`، وانتقِ من 11 نمطًا مثل Cinematic أو Comic book أو Line art. يدعم من 1 إلى 4 صور لكل طلب، و20 إلى 100 خطوة استدلال، وتوجيهًا من 1 إلى 10، وصورة أولية اختيارية مع `initial_image_strength` بين 0 و1.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_archive_urlمطلوب
النوعstring
قدّم الصور المطلوب استخدامها في أرشيف، مع تحديدها بعنوان URL.
promptمطلوب
النوعstring
صِف الصورة التي تريد توليدها بأكبر قدر ممكن من التفصيل للحصول على أفضل النتائج.
base_pipelineاختياري
النوعenum
الافتراضيphotomaker
photomakerphotomaker-style
خط الأنابيب الأساسي المستخدم لتوليد الصور.
initial_image_urlاختياري
النوعurl · image
صورة بداية اختيارية لمعالجة img2img.
initial_image_strengthاختياري
النوعnumber
الافتراضي0.5
0 – 1
مستوى تشويش الصورة الكامنة، من دون تشويش مضاف عند O إلى الحد الأقصى عند 1.
styleاختياري
النوعenum
الافتراضيPhotographic
(No style)CinematicDisney CharacterDigital ArtPhotographicFantasy artNeonpunkEnhanceComic bookLowpolyLine art
negative_promptاختياري
النوعstring
الافتراضي
موجّه سلبي يحدد تفاصيل الصورة غير المرغوبة. يمكنه استبعاد الألوان والعناصر والمشهد أو السمات والصفات الدقيقة، مثل الشارب أو الضبابية أو الدقة المنخفضة.
num_inference_stepsاختياري
النوعinteger
الافتراضي50
20 – 100
يتحكم في عدد خطوات التوليد التي ينفذها Stable Diffusion؛ وقد تنتج الخطوات الإضافية صورة نهائية أكثر تفصيلاً.
style_strengthاختياري
النوعinteger
الافتراضي20
15 – 50
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
حدد عدد الصور التي ينتجها طلب واحد، مع إتاحة وقت توليد أطول للدفعات الأكبر.
guidance_scaleاختياري
النوعnumber
الافتراضي5
1 – 10
قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).
seedاختياري
النوعinteger | null
بذرة لإعادة إنتاج الصور في Stable Diffusion. يمكن إعادة إنتاج الصورة تمامًا في كل تشغيل بالحفاظ على إصدار النموذج والموجّه والبذرة دون تغيير.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "photomaker",
  "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": 22,
    "usd": "0.022",
    "charged": 22,
    "refunded": 0
  },
  "input": {
    "image_archive_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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
      }
    ],
    "seed": 42
  },
  "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}
seed
integer

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