الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
images
/
edits
curl -X POST "https://api.lemondata.cc/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "image=@sunlit_lounge.png" \
  -F "[email protected]" \
  -F "prompt=A sunlit indoor lounge area with a pool" \
  -F "n=1" \
  -F "size=1024x1024"

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

​
نظرة عامة

إنشاء صورة معدلة أو موسعة من صورة أصلية ووصف نصي. يتطلب نوع المحتوى multipart/form-data.

​
جسم الطلب

​
image
file
مطلوب
الصورة المراد تعديلها. يجب أن تكون ملف PNG صالح، أقل من 4MB، ومربعة. يجب أن تحتوي الصورة على مناطق شفافة حيث يُراد التعديل.
​
prompt
string
مطلوب
وصف نصي للتعديل المطلوب.
​
mask
file
صورة إضافية تشير مناطقها الشفافة بالكامل إلى أماكن التعديل. يجب أن تكون ملف PNG صالح، أقل من 4MB، وبنفس أبعاد image.
​
model
string
افتراضي:"dall-e-2"
النموذج المستخدم لتعديل الصورة. حالياً يُدعم dall-e-2 فقط.
​
n
integer
افتراضي:"1"
عدد الصور المراد إنشاؤها. يجب أن يكون بين 1 و 10.
​
size
string
حجم الصور المُنشأة. يجب أن يكون أحد: 256x256، 512x512، أو 1024x1024.
​
response_format
string
افتراضي:"url"
تنسيق إرجاع الصور المُنشأة. يجب أن يكون url أو b64_json.
​
user
string
معرف فريد يمثل المستخدم النهائي لمراقبة سوء الاستخدام.

​
الاستجابة

​
created
integer
الطابع الزمني Unix لوقت إنشاء الصور.
​
data
array
مصفوفة الصور المُنشأة.كل عنصر يحتوي على:
  • url (string): رابط الصورة المعدلة (إذا كان response_format هو url)
  • b64_json (string): الصورة بترميز Base64 (إذا كان response_format هو b64_json)
curl -X POST "https://api.lemondata.cc/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "image=@sunlit_lounge.png" \
  -F "[email protected]" \
  -F "prompt=A sunlit indoor lounge area with a pool" \
  -F "n=1" \
  -F "size=1024x1024"

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

​
ملاحظات

تعديل الصور متاح فقط مع DALL-E 2. يجب أن تحتوي الصورة على مناطق شفافة تشير إلى أماكن التعديل، أو يمكنك توفير صورة قناع منفصلة.

الجسم

application/json
​
image
file
مطلوب

الصورة المراد تعديلها. يجب أن تكون ملف PNG صالح، أقل من 4MB، ومربعة. يجب أن تحتوي الصورة على مناطق شفافة حيث يُراد التعديل.

​
prompt
string
مطلوب

وصف نصي للتعديل المطلوب.

​
mask
file

صورة إضافية تشير مناطقها الشفافة بالكامل إلى أماكن التعديل. يجب أن تكون ملف PNG صالح، أقل من 4MB، وبنفس أبعاد image .

​
model
string

النموذج المستخدم لتعديل الصورة. حالياً يُدعم dall-e-2 فقط.

​
n
integer

عدد الصور المراد إنشاؤها. يجب أن يكون بين 1 و 10.

​
size
string

حجم الصور المُنشأة. يجب أن يكون أحد: 256x256 ، 512x512 ، أو 1024x1024 .

​
response_format
string

تنسيق إرجاع الصور المُنشأة. يجب أن يكون url أو b64_json .

​
user
string

معرف فريد يمثل المستخدم النهائي لمراقبة سوء الاستخدام.

الاستجابة

200 - application/json

Response 200

​
created
integer

الطابع الزمني Unix لوقت إنشاء الصور.

​
data
object[]

مصفوفة الصور المُنشأة. كل عنصر يحتوي على: url (string): رابط الصورة المعدلة (إذا كان response_format هو url ) b64_json (string): الصورة بترميز Base64 (إذا كان response_format هو b64_json )