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

Bria Product Shot

אינטעגרירן

מאָדעל־id bria/product-shot
# 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/bria/product-shot?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.04⁩ 40 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Bria AI · בילד

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

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

בויען אַ בעטן

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

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

URL פֿונעם פּראָדוקט־פֿאָטאָ פֿאַר פּלוצירונג אין אַ לייפֿסטייל־סצענע; דאָס בילד מוז זײַן jpeg, jpg, png, webp און נישט גרעסער ווי 12 MB. אויב אַן `image_file` איז אויך צוגעשטעלט, האָט `image_url` פּריאָריטעט.

סטאַנדאַרט 1

צאָל לייפֿסטייל־פּראָדוקט־בילדער פּער פּלוצירונג (`num_results`). די גאַנצע צאָל איז די נומער פֿון נויטיקע פּלוצירונגען × `num_results` פֿאַר `placement_type=manual_placement`, אָדער `num_results` × 10 פֿאַר `placement_type=automatic`.

פֿאָרגעשריטן ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
סטאַנדאַרט
לייגט אַרײַן אַ טעקע, אָדער

URL פֿון אַ רעפֿערענץ־בילד פֿאַר גענערירן אַ נײַעם הינטערגרונט אָדער סצענע פֿאַר אַ פּראָדוקט־שאָס, מיט שטיצע פֿאַר jpeg, jpg, png און webp. צושטעל פּונקט איינס פֿון `scene_description` אָדער `ref_image_url`; אַן ליידיקער URL ווערט געשריבן ווי "". ווען `ref_image_file` איז אויך צוגעשטעלט, האָט `ref_image_url` פּריאָריטעט.

placement_type סטאַנדאַרט manual_placement

מאָדע פֿון פּראָדוקט־פּלוצירונג, מיט צוויי מאַנועלע אָפּציעס: 'manual_placement' ניצט פֿאָרגעשטימטע פּאָזיציעס אויסגעקליבן דורך 'manual_placement_selection', בשעת 'manual_padding' אַדזשאַסטירט בילד־פּאָזיציע און גרייס דורך פּיקסעל־פּאַדינג אַרום דעם פּראָדוקט. צו האַלטן די מקור־פּאָזיציע, קלײַב 'original'; צו גענערירן רעזולטאַטן איבער 10 רעקאָמענדירטע פּראָדוקט־פּאָזיציעס, קלײַב 'automatic'.

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

סטאַנדאַרט bottom_center

פֿאָרגעשטימטע פּאָזיציעס צו נוצן ווען placement_type=manual_placement איז אויסגעקליבן. קלײַב פֿון דער ליסטע; מען קען בעטן עטלעכע פּאָזיציעס צוזאַמען.

סטאַנדאַרט [1000,1000]

ציל־דימענסיעס פֿאַרן לעצטן פּראָדוקט־בילד, אָנווענדלעך בלויז מיט placement_type=automatic אָדער placement_type=manual_placement. פֿאַר בעסטע רעזולטאַטן ציל אויף בערך 1,000,000 פּיקסעלן בסך־הכּל.

פּיקסעל־פּאַדינג פֿאַר `placement_type=manual_padding`, צוגעשטעלט ווי [left, right, top, bottom]. צו אויסקלײַבן די ווערטן, באַקום קודם אַ פּראָדוקט־קאַטאַוט דורך דער פּראָדוקט־קאַטאַוט API און דורכקוק זײַנע דימענסיעס, דערנאָך שיק דעם קאַטאַוט צו דער API מיטן געוואונטשן פּאַדינג. פֿאַר אָפּטימאַלע רעזולטאַטן ציל אויף אַרום 1,000,000 פּיקסעלן נאָך פּאַדינג.

POST /run/bria/product-shot?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.com/v1/run/bria/product-shot?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 שליסל

וועגן Bria Product Shot

לייגט דעם פּראָדוקט פֿון `image_url` אין אַ סצענע באַשריבן דורך `scene_description` אָדער געוויזן אין `ref_image_url`, אָבער נישט ביידע. `placement_type` קען זײַן original, automatic, manual_placement אָדער manual_padding, מיט צען פּאָזיציעס פֿאַר `manual_placement_selection` און אַ `shot_size` פֿון בערך 1,000,000 פּיקסעלן. `num_results` גייט פֿון 1 ביז 4, און אַ `fast`־מאָדע איז בנימצא.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
URL פֿונעם פּראָדוקט־פֿאָטאָ פֿאַר פּלוצירונג אין אַ לייפֿסטייל־סצענע; דאָס בילד מוז זײַן jpeg, jpg, png, webp און נישט גרעסער ווי 12 MB. אויב אַן `image_file` איז אויך צוגעשטעלט, האָט `image_url` פּריאָריטעט.
scene_descriptionאָפּציאָנעל
טיפּstring | null
פּראָמפּט בלויז אויף ענגליש, אָן ספּעציעלע צייכנס, וואָס באַשרײַבט די סצענע אָדער הינטערגרונט צו שאַפֿן פֿאַר דעם צוגעשטעלטן פּראָדוקט־פֿאָטאָ.
ref_image_urlאָפּציאָנעל
טיפּurl · image
סטאַנדאַרט
URL פֿון אַ רעפֿערענץ־בילד פֿאַר גענערירן אַ נײַעם הינטערגרונט אָדער סצענע פֿאַר אַ פּראָדוקט־שאָס, מיט שטיצע פֿאַר jpeg, jpg, png און webp. צושטעל פּונקט איינס פֿון `scene_description` אָדער `ref_image_url`; אַן ליידיקער URL ווערט געשריבן ווי "". ווען `ref_image_file` איז אויך צוגעשטעלט, האָט `ref_image_url` פּריאָריטעט.
optimize_descriptionאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
צי אָפּטימיזירונג פֿון דער סצענע־באַשרײַבונג איז אַקטיווירט.
num_resultsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט1
1 – 4
צאָל לייפֿסטייל־פּראָדוקט־בילדער פּער פּלוצירונג (`num_results`). די גאַנצע צאָל איז די נומער פֿון נויטיקע פּלוצירונגען × `num_results` פֿאַר `placement_type=manual_placement`, אָדער `num_results` × 10 פֿאַר `placement_type=automatic`.
fastאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קאָנטראָלירט צי דער שנעלער מאָדעל ווערט אויסגעקליבן.
placement_typeאָפּציאָנעל
טיפּenum
סטאַנדאַרטmanual_placement
originalautomaticmanual_placementmanual_padding
מאָדע פֿון פּראָדוקט־פּלוצירונג, מיט צוויי מאַנועלע אָפּציעס: 'manual_placement' ניצט פֿאָרגעשטימטע פּאָזיציעס אויסגעקליבן דורך 'manual_placement_selection', בשעת 'manual_padding' אַדזשאַסטירט בילד־פּאָזיציע און גרייס דורך פּיקסעל־פּאַדינג אַרום דעם פּראָדוקט. צו האַלטן די מקור־פּאָזיציע, קלײַב 'original'; צו גענערירן רעזולטאַטן איבער 10 רעקאָמענדירטע פּראָדוקט־פּאָזיציעס, קלײַב 'automatic'.
original_qualityאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
אָפּציע פֿאַר רעזולטאַט־גרייס, ניצלעך בלויז מיט `placement_type=original`: false סקיילט דאָס בילד צו 1 מעגאַפּיקסעל (1MP) אָן ענדערן זײַן אַספּעקט־ראַציע, בשעת true האַלט די אַרײַנגעבונג־דימענסיעס.
shot_sizeאָפּציאָנעל
טיפּinteger[]
סטאַנדאַרט[1000,1000]
ציל־דימענסיעס פֿאַרן לעצטן פּראָדוקט־בילד, אָנווענדלעך בלויז מיט placement_type=automatic אָדער placement_type=manual_placement. פֿאַר בעסטע רעזולטאַטן ציל אויף בערך 1,000,000 פּיקסעלן בסך־הכּל.
manual_placement_selectionאָפּציאָנעל
טיפּenum
סטאַנדאַרטbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
פֿאָרגעשטימטע פּאָזיציעס צו נוצן ווען placement_type=manual_placement איז אויסגעקליבן. קלײַב פֿון דער ליסטע; מען קען בעטן עטלעכע פּאָזיציעס צוזאַמען.
padding_valuesאָפּציאָנעל
טיפּinteger[]
פּיקסעל־פּאַדינג פֿאַר `placement_type=manual_padding`, צוגעשטעלט ווי [left, right, top, bottom]. צו אויסקלײַבן די ווערטן, באַקום קודם אַ פּראָדוקט־קאַטאַוט דורך דער פּראָדוקט־קאַטאַוט API און דורכקוק זײַנע דימענסיעס, דערנאָך שיק דעם קאַטאַוט צו דער API מיטן געוואונטשן פּאַדינג. פֿאַר אָפּטימאַלע רעזולטאַטן ציל אויף אַרום 1,000,000 פּיקסעלן נאָך פּאַדינג.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/product-shot",
  "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": {
    "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,
        "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 איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
images
array of object {url, content_type, file_name, file_size, width, height}בילדער געשאַפֿן דורך דעם מאָדעל.

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

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