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

Recraft V3 · Image to Image

التكامل

معرّف النموذج recraft/v3/image-to-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/recraft/v3/image-to-image?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ⁨‏0.04 $⁩ 40 رصيد API · ≈ ⁨‏4.30 ₽⁩ تشغيله في هذه الصفحة

الحصول على مفتاح API
Recraft تحرير الصور #vector#typography#style

تحرير Recraft V3 من صورة إلى صورة مع تحكم في الشدة و85 خيارًا للنمط وتفضيلات الألوان

Recraft · صورة

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

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

إنشاء طلب

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

•مطلوب 88 / 1000

نص يحدد المناطق التي ينبغي تغييرها.

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

عنوان URL للصورة المراد تعديلها؛ يجب أن يكون كل بُعد في الصورة المقدمة أقل من 4096 بكسل. ويجب أن تكون دقتها أيضًا أقل من 16 MP وحجم ملفها أقل من 5 MB.

الافتراضي realistic_image

النمط المرئي المطبق على الصور المُولَّدة.

متقدم negative_prompt · style_id · strength · enable_safety_checker · colors
0 / 1000

نص يحدد العناصر التي ينبغي ألا تظهر في الصورة.

معرّف اختياري لمرجع نمط مخصص.

الافتراضي 0.5

درجة التغيير من المصدر، من 0 إلى 1. عند 1 لا تشبه النتيجة الأصل إلا قليلًا؛ وعند 0 تكاد تكون مطابقة له.

الافتراضي []

مصفوفة تحتوي على الألوان المفضلة.

POST /run/recraft/v3/image-to-image?wait=20 عرض السعر → ⁨‏0.04 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/recraft/v3/image-to-image?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Recraft V3 · Image to Image

يعدّل الصورة الموجودة في `image_url` وفقًا لـ `prompt` يصل إلى 1000 حرف. تتحكم `strength` من 0 إلى 1 في مدى ابتعاد النتيجة عن الأصل. يجب أن يكون الإدخال أقل من 5 MB وأقل من 16 MP وألا يتجاوز أي جانب فيه 4096 بكسل. اختر `style`، أو قدّم `colors` أو `style_id`، واستبعد العناصر غير المرغوبة باستخدام `negative_prompt`.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
≤ 1,000 حرف
نص يحدد المناطق التي ينبغي تغييرها.
image_urlمطلوب image
النوعurl · image
عنوان URL للصورة المراد تعديلها؛ يجب أن يكون كل بُعد في الصورة المقدمة أقل من 4096 بكسل. ويجب أن تكون دقتها أيضًا أقل من 16 MP وحجم ملفها أقل من 5 MB.
strengthاختياري
النوعnumber
الافتراضي0.5
0 – 1
درجة التغيير من المصدر، من 0 إلى 1. عند 1 لا تشبه النتيجة الأصل إلا قليلًا؛ وعند 0 تكاد تكون مطابقة له.
styleاختياري
النوعenum
الافتراضيrealistic_image
anyrealistic_imagedigital_illustrationvector_illustrationrealistic_image/b_and_wrealistic_image/hard_flashrealistic_image/hdrrealistic_image/natural_lightrealistic_image/studio_portraitrealistic_image/enterpriserealistic_image/motion_blurrealistic_image/evening_lightrealistic_image/faded_nostalgiarealistic_image/forest_liferealistic_image/mystic_naturalismrealistic_image/natural_tones
+69 أخرىrealistic_image/organic_calmrealistic_image/real_life_glowrealistic_image/retro_realismrealistic_image/retro_snapshotrealistic_image/urban_dramarealistic_image/village_realismrealistic_image/warm_folkdigital_illustration/pixel_artdigital_illustration/hand_drawndigital_illustration/graindigital_illustration/infantile_sketchdigital_illustration/2d_art_posterdigital_illustration/handmade_3ddigital_illustration/hand_drawn_outlinedigital_illustration/engraving_colordigital_illustration/2d_art_poster_2digital_illustration/antiquariandigital_illustration/bold_fantasydigital_illustration/child_bookdigital_illustration/child_booksdigital_illustration/coverdigital_illustration/crosshatchdigital_illustration/digital_engravingdigital_illustration/expressionismdigital_illustration/freehand_detailsdigital_illustration/grain_20digital_illustration/graphic_intensitydigital_illustration/hard_comicsdigital_illustration/long_shadowdigital_illustration/modern_folkdigital_illustration/multicolordigital_illustration/neon_calmdigital_illustration/noirdigital_illustration/nostalgic_pasteldigital_illustration/outline_detailsdigital_illustration/pastel_gradientdigital_illustration/pastel_sketchdigital_illustration/pop_artdigital_illustration/pop_renaissancedigital_illustration/street_artdigital_illustration/tablet_sketchdigital_illustration/urban_glowdigital_illustration/urban_sketchingdigital_illustration/vanilla_dreamsdigital_illustration/young_adult_bookdigital_illustration/young_adult_book_2vector_illustration/bold_strokevector_illustration/chemistryvector_illustration/colored_stencilvector_illustration/contour_pop_artvector_illustration/cosmicsvector_illustration/cutoutvector_illustration/depressivevector_illustration/editorialvector_illustration/emotional_flatvector_illustration/infographicalvector_illustration/marker_outlinevector_illustration/mosaicvector_illustration/naivectorvector_illustration/roundish_flatvector_illustration/segmented_colorsvector_illustration/sharp_contrastvector_illustration/thinvector_illustration/vector_photovector_illustration/vivid_shapesvector_illustration/engravingvector_illustration/line_artvector_illustration/line_circuitvector_illustration/linocut
النمط المرئي المطبق على الصور المُولَّدة.
colorsاختياري
النوعobject[]
الافتراضي[]
مصفوفة تحتوي على الألوان المفضلة.
colors[].rاختياري
النوعinteger
الافتراضي0
0 – 255
قيمة المكوّن الأحمر.
colors[].gاختياري
النوعinteger
الافتراضي0
0 – 255
قيمة المكوّن الأخضر.
colors[].bاختياري
النوعinteger
الافتراضي0
0 – 255
قيمة المكوّن الأزرق.
style_idاختياري
النوعstring | null
معرّف اختياري لمرجع نمط مخصص.
negative_promptاختياري
النوعstring | null
≤ 1,000 حرف
نص يحدد العناصر التي ينبغي ألا تظهر في الصورة.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "recraft/v3/image-to-image",
  "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": 40,
    "usd": "0.04",
    "charged": 40,
    "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
      }
    ]
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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}الصور الناتجة عن النموذج.

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

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