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

Phota

التكامل

معرّف النموذج phota/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/phota/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",
    "images": [
      "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.09 $⁩ 90 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Open model تحرير الصور إخراج بدقة 4Kحتى 4K #edit#personalization#typography#phota

تحرير صور يحافظ على الهوية من 1 إلى 10 صور إدخال، مع ملفات تعريف مدرّبة اختيارية

Open model · صورة

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

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

إنشاء طلب

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

•مطلوب 88 / 8000

موجّه لتوليد الصور يمكن أن يتضمن مراجع لملفات التعريف مثل [[profile_id_1]] و[[profile_id_2]] إلى جانب وصف لما يجب إنشاؤه.

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

الصور المطلوب تعديلها، مقدّمة كعناوين URL أو معرّفات URI لبيانات Base64؛ يتم تجاهل الإدخالات التي تتجاوز أول 10. قدّم صورة واحدة على الأقل، أو استخدم نقطة النهاية `/` بدلاً من ذلك للتوليد من النص وحده.

resolution الافتراضي 1K

الدقة المستخدمة للصورة المُولّدة.

aspect_ratio الافتراضي auto

نسبة العرض إلى الارتفاع لصورة المخرج.

num_images الافتراضي 1

عدد الصور المطلوب إنتاجها.

متقدم output_format · base_model · enable_safety_checker · profile_ids
output_format الافتراضي jpeg

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

base_model الافتراضي nb2

اختيار نموذج العرض، مع إتاحة `4K` عبر `nb2` فقط. تضع طبقات الهوية فوق أي نموذج أساسي محدد، ما يجعل كل اختيار متوافقاً مع ملفات التعريف المدرّبة.

اختيار ملفات التعريف لتوليد الصور، مقدّمة كقائمة من المعرّفات؛ ويمكن للموجّه وسم هذه الملفات باستخدام @Profile1 و@Profile2 وما إلى ذلك.

POST /run/phota/edit?wait=20 عرض السعر → ⁨‏0.09 $⁩
# 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/phota/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",
    "images": [
      "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

حول Phota

يحرّر صورًا موجودة من `prompt` تصل إلى 8000 محرف و`image_urls` التي تتطلب صورة واحدة على الأقل؛ ولا يُستخدم أكثر من 10. مرّر `profile_ids` للحفاظ على إمكانية التعرّف على أشخاص محددين. يمكن أن تكون `base_model` هي nb2 أو qwen-image-2 أو flux-2 أو seedream-5-pro، ويعمل إخراج 4K مع nb2 فقط. يعيد من 1 إلى 4 صور بصيغة JPEG أو PNG.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
≤ 8,000 حرف
موجّه لتوليد الصور يمكن أن يتضمن مراجع لملفات التعريف مثل [[profile_id_1]] و[[profile_id_2]] إلى جانب وصف لما يجب إنشاؤه.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب إنتاجها.
profile_idsاختياري
النوعstring[]
اختيار ملفات التعريف لتوليد الصور، مقدّمة كقائمة من المعرّفات؛ ويمكن للموجّه وسم هذه الملفات باستخدام @Profile1 و@Profile2 وما إلى ذلك.
output_formatاختياري
النوعenum
الافتراضيjpeg
jpegpng
تنسيق ملف الصورة الناتجة.
resolutionاختياري
النوعenum
الافتراضي1K
1K4K
الدقة المستخدمة للصورة المُولّدة.
aspect_ratioاختياري
النوعenum
الافتراضيauto
auto1:116:94:33:49:16
نسبة العرض إلى الارتفاع لصورة المخرج.
base_modelاختياري
النوعenum
الافتراضيnb2
nb2qwen-image-2flux-2seedream-5-pro
اختيار نموذج العرض، مع إتاحة `4K` عبر `nb2` فقط. تضع طبقات الهوية فوق أي نموذج أساسي محدد، ما يجعل كل اختيار متوافقاً مع ملفات التعريف المدرّبة.
image_urlsمطلوب images
النوعurl[] · image
الصور المطلوب تعديلها، مقدّمة كعناوين URL أو معرّفات URI لبيانات Base64؛ يتم تجاهل الإدخالات التي تتجاوز أول 10. قدّم صورة واحدة على الأقل، أو استخدم نقطة النهاية `/` بدلاً من ذلك للتوليد من النص وحده.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "phota/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": 90,
    "usd": "0.09",
    "charged": 90,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "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
      }
    ]
  },
  "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}عنوان URL يشير إلى الصورة المعدّلة.

مزيد من النماذج: تحرير الصور

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