---
title: "Bulk Generate From Source"
method: POST
path: "/api/v1/fashion-photoshoot/bulk/generate-from-source"
tags: ["fashionPhotoshoot"]
---

# Bulk Generate From Source

`POST /api/v1/fashion-photoshoot/bulk/generate-from-source`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/fashion-photoshoot/bulk/generate-from-source`
- Auth: HTTP bearer

Create a bulk job from a customer sheet or Drive folder, then detach.

Returns as soon as the rows are written; nothing per-row happens here (photos are
re-hosted on the worker). If this ever needs more than 120s, per-row work has leaked in.

Open to every user. The job cap and the credit pre-flight are enforced in
`_create_bulk_job`, which both creation paths go through.

## Request body `multipart/form-data`

- BodyBulkGenerateFromSourceApiV1FashionPhotoshootBulkGenerateFromSourcePost
  - `source_type` string, required
  - `file` string, binary, nullable
  - `sheet_url` string, nullable
  - `drive_folder_url` string, nullable
  - `column_mapping` string, nullable
  - `job_name` string, nullable
  - `engine` string
  - `image_resolution` string
  - `aspect_ratio` string
  - `style_prompt` string, nullable
  - `scene_preset_prompt` string, nullable
  - `custom_scene_prompt` string, nullable
  - `custom_style_source` string
  - `skip_wrong_flow_rows` boolean
  - `scene_verbatim` boolean
  - `model_seed` integer, nullable
  - `model_ids` string, nullable
  - `custom_models` string, nullable
  - `domain_id` string, nullable
  - `auto_retry_flagged` boolean
  - `subject_mode` string
  - `mannequin_form` string, nullable
  - `item_type` string: garment | accessory
  - `scene_by_type` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-09-21** `a6cea1834b97`: 1 info
  - the `engine` request property default value changed from `nano_banana_2` to `gpt_image_2_5_sunburst`
- **2026-09-16** `dda5cf04b73d`: 5 info
  - added the new optional request property `custom_scene_prompt`
  - added the new optional request property `custom_style_source`
  - added the new optional request property `item_type`
  - added the new optional request property `scene_by_type`
  - …1 more

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/fashion-photoshoot/bulk/generate-from-source/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)