שפּרינגען צו אינהאַלט

Pixelcut Product Photo

אינטעגרירן

מאָדעל־id pixelcut/product-photo
# 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/pixelcut/product-photo?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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.024⁩ 24 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Pixelcut בילד־עדיטירונג #utility#editing

פּראָדוקט־בילדער־קאָמפּאָזיטאָר: שניידט אויס דעם אָביעקט און לייגט אים אויף אַ נײַעם לייַוונט מיט הינטערגרונט, ראַנדן און שאָטן

Pixelcut · בילד

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

•פארלאנגט image_url
לייגט אַרײַן אַ טעקע, אָדער

פּראָדוקט־בילד־URL פֿאַר פּראַסעסירונג.

image_size סטאַנדאַרט square_hd

דימענסיעס פֿונעם רעזולטאַט־קאַנוואַס, ספּעציפֿיצירט ווי custom {width, height} אָדער אַ פּריסעט: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. דער סטאַנדאַרט איז square_hd (1024x1024).

פֿאָרגעשריטן output_format · background · margin · shadow · watermark
output_format

רעזולטאַט־בילד־קאָדירונג, אויסגעקליבן פֿון PNG אָדער JPEG; JPEG איז נישט בנימצא פֿאַר דורכזיכטיקע הינטערגרונטן. אויב מען לאזט די אויסוואל אויס, בלײַבט דער פֿאָרמאַט פֿון דער אַרײַנגעבונג.

הינטערגרונט פֿאַרן רעזולטאַט: אַ בילד, דורכזיכטיקייט, אָדער אַ פֿעסטע קאָליר וואָס איז סטאַנדאַרט ווײַס.

פּלאַץ צווישן דעם פּראָדוקט און די ראַנדן פֿונעם קאַנוואַס. ניצט `all` צו שטעלן יעדן ראַנד, מיט אָפּציאָנעלע איבערשרײַבונגען פֿאַר יחיד־זייטן; דער סטאַנדאַרט איז 20% פּער זייט.

שאָטן־קאָנפֿיגוראַציע: קלײַבט 'Generative' אָדער 'Drop' און קאָנפֿיגורירט די באַשטעטיקונגען. לאָזט נישט באַשטימט צו צולייגן קיין שאָטן.

לאָגאָ אָדער וואַטערמאַרק־איבערלאַג דערמעגלעכט דורך צושטעלן אַ בילד; דאָס אויסלאָזן עס לאָזט דעם רעזולטאַט אָן וואַטערמאַרק, ווי עס איז סטאַנדאַרט.

POST /run/pixelcut/product-photo?wait=20 פּרײַז → ⁨$ 0.024⁩
# 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/pixelcut/product-photo?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Pixelcut Product Photo

באַאַרבעט אַ פּראָדוקט־פֿאָטאָ אין אַ בילד אין קאַטאַלאָג־סטיל. איר קענט באַשטימען דעם קנוואַס מיט `image_size` פּריסעטן אָדער אייגענע דימענסיעס, אויסקלײַבן אַ פֿעסטן, דורכזיכטיקן אָדער בילד־`background`, און פּאַסן `margin` צו. אַן גענעראַטיווער אָדער אַראָפּפֿאַלנדיקער `shadow` און אַן אָפּציאָנאַלע `watermark` overlay זענען בנימצא. דער רעזולטאַט איז png אָדער jpeg, און jpeg קען נישט ווערן גענוצט מיט אַ דורכזיכטיקן הינטערגרונט.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
פּראָדוקט־בילד־URL פֿאַר פּראַסעסירונג.
image_sizeאָפּציאָנעל
טיפּobject
סטאַנדאַרטsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
דימענסיעס פֿונעם רעזולטאַט־קאַנוואַס, ספּעציפֿיצירט ווי custom {width, height} אָדער אַ פּריסעט: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. דער סטאַנדאַרט איז square_hd (1024x1024).
backgroundאָפּציאָנעל
טיפּobject
הינטערגרונט פֿאַרן רעזולטאַט: אַ בילד, דורכזיכטיקייט, אָדער אַ פֿעסטע קאָליר וואָס איז סטאַנדאַרט ווײַס.
background.modeאָפּציאָנעל
טיפּenum
סטאַנדאַרטColor
TransparentColorImage
הינטערגרונט־מאָדע: 'Color' ניצט `color`, מיט סטאַנדאַרט ווײַס; 'Transparent' שאַפֿט דורכזיכטיקייט און ניצט שטענדיק PNG; 'Image' לייגט דעם רעזולטאַט איבער `image_url`.
background.colorאָפּציאָנעל
טיפּobject
סטאַנדאַרט{"b":255,"g":255,"r":255}
פֿעסטע הינטערגרונט־פֿילונג פֿאַר 'Color' מאָדע, סטאַנדאַרט ווײַס, ספּעציפֿיצירט דורך R/G/B קאָמפּאָנענטן פֿון 0 ביז 255.
background.color.rפארלאנגט
טיפּinteger
0 – 255
background.color.gפארלאנגט
טיפּinteger
0 – 255
background.color.bפארלאנגט
טיפּinteger
0 – 255
background.image_urlאָפּציאָנעל
טיפּurl · image
URL פֿאַרן הינטערגרונט־בילד; נייטיק אין 'Image' מאָדע.
background.image_fitאָפּציאָנעל
טיפּenum
סטאַנדאַרטCover
CoverContainStretch
קלײַבט ווי צו פּאַסן דאָס הינטערגרונט־בילד צום קאַנוואַס. 'Contain' האַלט אַן צוגעפּאַסט בילד מיט לעטערבאָקסינג איבער `color`, בעת 'Stretch' ניצט פֿאַרקרימונג צו פּאַסן; 'Cover' פֿילט דעם קאַנוואַס דורך אָפּשנײַדן.
marginאָפּציאָנעל
טיפּobject
פּלאַץ צווישן דעם פּראָדוקט און די ראַנדן פֿונעם קאַנוואַס. ניצט `all` צו שטעלן יעדן ראַנד, מיט אָפּציאָנעלע איבערשרײַבונגען פֿאַר יחיד־זייטן; דער סטאַנדאַרט איז 20% פּער זייט.
margin.allאָפּציאָנעל
טיפּstring
סטאַנדאַרט20%
איינהייטלעכער ראַנד אויף יעדן זייט, ספּעציפֿיצירט ווי '%' פֿון דער קאַנוואַס־דימענסיע, פֿון 0 ביז 49%, אָדער אין 'px' מיט אַ מינימום פֿון 0px.
margin.leftאָפּציאָנעל
טיפּstring | null
לינקער ראַנד וואָס ערזעצט `all` אויף יענער זייט. נעמט '%' פֿון 0 ביז 49%, אָדער 'px' בײַ 0px און העכער.
margin.rightאָפּציאָנעל
טיפּstring | null
רעכטער ראַנד וואָס ערזעצט `all` אויף יענער זייט. נעמט '%' פֿון 0 ביז 49%, אָדער 'px' בײַ 0px און העכער.
margin.topאָפּציאָנעל
טיפּstring | null
אויבערשטער ראַנד וואָס ערזעצט `all` אויף יענער זייט. נעמט '%' פֿון 0 ביז 49%, אָדער 'px' בײַ 0px און העכער.
margin.bottomאָפּציאָנעל
טיפּstring | null
אונטערשטער ראַנד וואָס ערזעצט `all` אויף יענער זייט. נעמט '%' פֿון 0 ביז 49%, אָדער 'px' בײַ 0px און העכער.
shadowאָפּציאָנעל
טיפּobject
שאָטן־קאָנפֿיגוראַציע: קלײַבט 'Generative' אָדער 'Drop' און קאָנפֿיגורירט די באַשטעטיקונגען. לאָזט נישט באַשטימט צו צולייגן קיין שאָטן.
shadow.typeאָפּציאָנעל
טיפּenum
GenerativeDrop
אָפּציאָנעלער שאָטן־סטיל, אָן שאָטן ווען נישט באַשטימט. קלײַבט 'Generative' פֿאַר AI־סינטעז אָדער 'Drop' פֿאַר אַ דיטערמיניסטישן שאָטן.
shadow.generativeאָפּציאָנעל
טיפּobject
באַשטעטיקונגען פֿאַרן AI־גענערירטן שאָטן, געווענדט ווען דער טיפּ איז 'Generative'.
shadow.generative.opacityאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.2
0 – 1
אָפּאַסיטעט פֿונעם גאָר קאָמפּאָזיטירטן שאָטן, פֿון 0 ביז 1.
shadow.generative.light_sourceאָפּציאָנעל
טיפּobject
עקספּליציטער ווירטועלער ליכט־קוואַל פֿאַר שאָטן־סינטעז, וואָס ערזעצט די אויטאָמאַטישע אָפּשאַצונג פֿון ליכט־ריכטונג פֿונעם בילד ווען צוגעשטעלט.
shadow.dropאָפּציאָנעל
טיפּobject
באַשטעטיקונגען פֿאַרן Drop־שאָטן, געווענדט ווען דער טיפּ איז 'Drop'.
shadow.drop.colorאָפּציאָנעל
טיפּobject
סטאַנדאַרט{"b":0,"g":0,"r":0}
RGB קאָליר פֿאַרן שאָטן; שוואַרץ איז דער סטאַנדאַרט.
shadow.drop.horizontalאָפּציאָנעל
טיפּnumber
סטאַנדאַרט50
-100 – 100
האָריזאָנטאַלע שאָטן־פֿאַררוקונג, וווּ די מאַקסימום באַשטעטיקונג פֿון 100 רעפּרעזענטירט 10% פֿון דער קאַנוואַס־ברייט. ווערטן לויפן פֿון -100 ביז 100, מיט נעגאַטיווע באַשטעטיקונגען וואָס רוקן לינקס און פּאָזיטיווע וואָס רוקן רעכטס.
shadow.drop.verticalאָפּציאָנעל
טיפּnumber
סטאַנדאַרט8
-100 – 100
ווערטיקאַלע שאָטן־פֿאַררוקונג, וווּ די מאַקסימום באַשטעטיקונג פֿון 100 רעפּרעזענטירט 10% פֿון דער קאַנוואַס־הייך. ווערטן לויפן פֿון -100 ביז 100, מיט נעגאַטיווע באַשטעטיקונגען וואָס רוקן אַרויף און פּאָזיטיווע וואָס רוקן אַראָפּ.
shadow.drop.blurאָפּציאָנעל
טיפּnumber
סטאַנדאַרט24
0 – 100
שאָטן־בלער־באַשטעטיקונג, מיט מאַקסימום ווייכקייט בײַ 100 וואָס קאָרעספּאָנדירט צו אַ ראַדיוס פֿון 5% פֿון דער קירצערער קאַנוואַס־דימענסיע. דער ראַנג הייבט זיך אָן בײַ 0, וואָס לאָזט די ראַנדן האַרט.
shadow.drop.opacityאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.25
0 – 1
אָפּאַסיטעט פֿונעם שאָטן, פֿון 0 ביז 1.
watermarkאָפּציאָנעל
טיפּobject
לאָגאָ אָדער וואַטערמאַרק־איבערלאַג דערמעגלעכט דורך צושטעלן אַ בילד; דאָס אויסלאָזן עס לאָזט דעם רעזולטאַט אָן וואַטערמאַרק, ווי עס איז סטאַנדאַרט.
watermark.image_urlאָפּציאָנעל
טיפּurl · image
URL פֿאַרן לאָגאָ אָדער וואַטערמאַרק־בילד. אַן ליידיקער ווערט לאָזט דעם רעזולטאַט אָן וואַטערמאַרק.
watermark.remove_backgroundאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
צי צו באַזײַטיקן דעם וואַטערמאַרק־הינטערגרונט מיט הינטערגרונט־באַזײַטיקונג, כּדי דער איבערלאַג זאָל אים נישט אַרײַננעמען.
watermark.positionאָפּציאָנעל
טיפּenum
סטאַנדאַרטbottom_right
top_lefttop_rightbottom_leftbottom_rightcenter
פּלאַץ פֿונעם וואַטערמאַרק.
watermark.scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.1
0.01 – 1
ברייט פֿונעם וואַטערמאַרק, אויסגעדריקט ווי אַ פֿראַקציע פֿון דער קאַנוואַס־ברייט.
watermark.opacityאָפּציאָנעל
טיפּnumber
סטאַנדאַרט1
0 – 1
אָפּאַסיטעט פֿונעם וואַטערמאַרק, פֿון 0 ביז 1.
watermark.marginאָפּציאָנעל
טיפּstring
סטאַנדאַרט3%
דיסטאַנץ אַרײַנווייניק פֿונעם קאַנוואַס־ראַנד, אויסגעדריקט ווי '%' פֿונעם קאַנוואַס (0–49%) אָדער אין 'px'.
output_formatאָפּציאָנעל
טיפּenum
pngjpeg
רעזולטאַט־בילד־קאָדירונג, אויסגעקליבן פֿון PNG אָדער JPEG; JPEG איז נישט בנימצא פֿאַר דורכזיכטיקע הינטערגרונטן. אויב מען לאזט די אויסוואל אויס, בלײַבט דער פֿאָרמאַט פֿון דער אַרײַנגעבונג.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixelcut/product-photo",
  "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": 24,
    "usd": "0.024",
    "charged": 24,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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 איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
image
object {url, content_type, file_name, file_size, width, height} | nullפּראָדוקטפֿאָטאָגראַפֿיע, צוגעגרייט פֿאַר קאַטאַלאָג־באַניץ.

מער מאָדעלן: בילד־עדיטירונג

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/pixelcut/product-photo.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt