Documentation

Product photography

Place a product image onto a background scene with a text prompt.

Composite a product cutout onto a background image using a text prompt for lighting and scene. Built for e‑commerce and marketing pipelines.

URL: POST https://api.thefluxtrain.com/api/v1/image-generate/product-photography/generate

Authentication: x-api-key

Request body

Field	Type	Required	Default	Description
`product_photo`	string	Yes	—	Product image URL or data URI
`background_photo`	string	Yes	—	Background image URL or data URI
`prompt`	string	Yes	—	Scene / lighting description
`lora_strength`	number	No	`0.70`	LoRA strength (0.0–1.0)
`guidance_scale`	number	No	`4.5`	Guidance scale
`output_format`	string	No	`png`	`jpg` or `png`
`folder_id`	string	No	—	Folder UUID in your account
`message_id`	string	No	—	Your own tracking ID

Example

{
  "product_photo": "https://example.com/product.png",
  "background_photo": "https://example.com/studio-bg.jpg",
  "prompt": "soft studio lighting, subtle shadow under product",
  "folder_id": "your-folder-uuid"
}

Response

Field	Type	Description
`id`	string	Job ID
`url`	string	Composited product photo URL
`status`	string	Generation status
`media_type`	string	`IMAGE`
`meta`	object	Metadata
`folder_id`	string \| null	Folder UUID
`created_at`	string \| null	ISO 8601 timestamp
`message_id`	string \| null	Your tracking ID if sent

Example

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "url": "https://storage.example/product-shot.png",
    "status": "SUCCESS",
    "media_type": "IMAGE",
    "meta": {},
    "folder_id": "your-folder-uuid"
  },
  "error": null
}