Ugrás a tartalomhoz

Bria Product Shot

Integráció

Modellazonosító 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"

Ez a kérés: 0,04 $ 40 API-jóváírás Futtatás ezen az oldalon

API-kulcs beszerzése
Bria AI · Kép

Az első eredményed itt jelenik meg

Állíts össze egy kérést alább, majd futtasd az API-kulcsoddal. A kimeneteket a tárhelyünkre másoljuk, és örökre vagy 7 nap ideig ingyenesen őrizzük meg.

Kérés összeállítása

A vezérlők a modell sémájából jönnek létre. A kód és az ár a módosításokkal együtt frissül.

•kötelező image_url
Húzz egy fájlt ide, vagy

Termékfotó URL-je életképszerű jelenetben való elhelyezéshez; a kép formátuma jpeg, jpg, png vagy webp lehet, mérete pedig legfeljebb 12 MB. Ha `image_file` is meg van adva, az `image_url` élvez elsőbbséget.

alapértelmezett: 1

Az elhelyezésenkénti életképszerű termékképek száma (`num_results`). A teljes mennyiség a szükséges elhelyezések száma × `num_results` `placement_type=manual_placement` esetén, illetve `num_results` × 10 `placement_type=automatic` esetén.

Speciális ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
alapértelmezett:
Húzz egy fájlt ide, vagy

Referencia-kép URL-je egy termékkép új hátterének vagy jelenetének generálásához; a jpeg, jpg, png és webp támogatott. Pontosan az egyik adható meg: `scene_description` vagy `ref_image_url`; az üres URL értéke "". Ha `ref_image_file` is meg van adva, a `ref_image_url` élvez elsőbbséget.

placement_type alapértelmezett: manual_placement

Termékelhelyezési mód, két manuális lehetőséggel: a 'manual_placement' az előre definiált, a 'manual_placement_selection' segítségével kiválasztott pozíciókat használja, míg a 'manual_padding' a termék körüli pixeles kitöltéssel módosítja a kép pozícióját és méretét. A forrás pozíciójának megtartásához válaszd az 'original' értéket; a 10 ajánlott termékpozícióban történő eredménygeneráláshoz válaszd az 'automatic' értéket.

Csak angol nyelvű, speciális karakterek nélküli prompt, amely leírja a megadott termékfotóhoz létrehozandó jelenetet vagy hátteret.

alapértelmezett: bottom_center

Használandó előre beállított pozíciók, ha a placement_type=manual_placement van kiválasztva. A listából válassz; több pozíció együtt is kérhető.

alapértelmezett: [1000,1000]

A végső termékkép célméretei, csak placement_type=automatic vagy placement_type=manual_placement esetén alkalmazhatók. A legjobb eredményhez a teljes méret körülbelül 1,000,000 pixel legyen.

A `placement_type=manual_padding` pixelben megadott kitöltése [left, right, top, bottom] sorrendben. Az értékek kiválasztásához először szerezz be termékkivágást a termékkivágási API-val, vizsgáld meg a méreteit, majd add át ezt a kivágást ennek az API-nak a kívánt kitöltéssel. Az optimális eredményhez a kitöltés utáni teljes méret körülbelül 1,000,000 pixel legyen.

POST /run/bria/product-shot?wait=20 ár → 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"

Kérés futtatása

A kulcsod ebben a böngészőben marad: csak a Doitong API-nak küldjük el, és csak akkor mentjük a localStorage-ba, ha bejelölöd az Emlékezz rám lehetőséget. API-kulcs igénylése

A(z) Bria Product Shot bemutatása

A `image_url` URL-címen megadott terméket a `scene_description` által leírt vagy a `ref_image_url` URL-címen megadott jelenetbe helyezi, de a kettő nem használható egyszerre. A `placement_type` értéke lehet original, automatic, manual_placement vagy manual_padding; a `manual_placement_selection` tíz pozíciót támogat, a `shot_size` pedig körülbelül 1 000 000 pixel. A `num_results` értéke 1 és 4 között lehet, és elérhető a `fast` mód.

Paraméterek

Küldd el a kanonikus nevet vagy a natív nevet, de ne mindkettőt. Kanonikus nevek

NévTípus AlapértelmezettEngedélyezett Leírás
image_urlkötelező image
Típusurl · image
Termékfotó URL-je életképszerű jelenetben való elhelyezéshez; a kép formátuma jpeg, jpg, png vagy webp lehet, mérete pedig legfeljebb 12 MB. Ha `image_file` is meg van adva, az `image_url` élvez elsőbbséget.
scene_descriptionnem kötelező
Típusstring | null
Csak angol nyelvű, speciális karakterek nélküli prompt, amely leírja a megadott termékfotóhoz létrehozandó jelenetet vagy hátteret.
ref_image_urlnem kötelező
Típusurl · image
Alapértelmezett
Referencia-kép URL-je egy termékkép új hátterének vagy jelenetének generálásához; a jpeg, jpg, png és webp támogatott. Pontosan az egyik adható meg: `scene_description` vagy `ref_image_url`; az üres URL értéke "". Ha `ref_image_file` is meg van adva, a `ref_image_url` élvez elsőbbséget.
optimize_descriptionnem kötelező
Típusboolean
Alapértelmezetttrue
Engedélyezve van-e a jelenetleírás optimalizálása.
num_resultsnem kötelező
Típusinteger
Alapértelmezett1
1 – 4
Az elhelyezésenkénti életképszerű termékképek száma (`num_results`). A teljes mennyiség a szükséges elhelyezések száma × `num_results` `placement_type=manual_placement` esetén, illetve `num_results` × 10 `placement_type=automatic` esetén.
fastnem kötelező
Típusboolean
Alapértelmezetttrue
A gyors modell kiválasztását szabályozza.
placement_typenem kötelező
Típusenum
Alapértelmezettmanual_placement
originalautomaticmanual_placementmanual_padding
Termékelhelyezési mód, két manuális lehetőséggel: a 'manual_placement' az előre definiált, a 'manual_placement_selection' segítségével kiválasztott pozíciókat használja, míg a 'manual_padding' a termék körüli pixeles kitöltéssel módosítja a kép pozícióját és méretét. A forrás pozíciójának megtartásához válaszd az 'original' értéket; a 10 ajánlott termékpozícióban történő eredménygeneráláshoz válaszd az 'automatic' értéket.
original_qualitynem kötelező
Típusboolean
Alapértelmezettfalse
Csak `placement_type=original` mellett használt kimenetméretezési beállítás: false esetén a kép 1 megapixelre (1MP) méreteződik a képarány módosítása nélkül, true esetén pedig a bemeneti méretek maradnak meg.
shot_sizenem kötelező
Típusinteger[]
Alapértelmezett[1000,1000]
A végső termékkép célméretei, csak placement_type=automatic vagy placement_type=manual_placement esetén alkalmazhatók. A legjobb eredményhez a teljes méret körülbelül 1,000,000 pixel legyen.
manual_placement_selectionnem kötelező
Típusenum
Alapértelmezettbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Használandó előre beállított pozíciók, ha a placement_type=manual_placement van kiválasztva. A listából válassz; több pozíció együtt is kérhető.
padding_valuesnem kötelező
Típusinteger[]
A `placement_type=manual_padding` pixelben megadott kitöltése [left, right, top, bottom] sorrendben. Az értékek kiválasztásához először szerezz be termékkivágást a termékkivágási API-val, vizsgáld meg a méreteit, majd add át ezt a kivágást ennek az API-nak a kívánt kitöltéssel. Az optimális eredményhez a kitöltés utáni teljes méret körülbelül 1,000,000 pixel legyen.
kötelező Kanonikus név, szintén elfogadva

A fájlparaméterek nyilvános https:// URL-t, legfeljebb 10 MB-os data: URI-t vagy egy feltöltés file_url értékét fogadják el. Fájlok

Kimenet

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"
  }
}
Az Ön fájljai, az Ön döntéseMinden outputs[].url a tárhelyünkön lévő másolat: örökre megőrizve (GB-hónaponként fizetve) vagy 7 nap ideig ingyenesen, a fiókbeállításod vagy a ?storage= alapján.
Azonos struktúra minden modellentype, url, content_type, width, height és duration képekhez, videókhoz és hanganyagokhoz egyaránt. Az output a modell saját eredményobjektuma.
A kimenet mezői
images
array of object {url, content_type, file_name, file_size, width, height}A modell által létrehozott képek.

További modellek: Képszerkesztés

AI-ügynököknek: ez az oldal Markdown formátumban itt található: https://doitong.com/hu/developers/models/bria/product-shot.md. Minden modell és útmutató: https://doitong.com/developers/llms.txt