Generation

Create Generation

Queue a new HomeDecor image generation request.

post/api/v1/generate

Request

  • Base URL: https://foto.damdafa.com/dreamhome
  • URL: https://foto.damdafa.com/dreamhome/api/v1/generate
  • Auth: HTTP bearer

Headers

ProviderId'firebase' | 'google' | 'apple'
X-Provider-Id'firebase' | 'google' | 'apple'
X-Device-Idstring nullable

Request body

categoryId'interior' | 'exterior' | 'garden' | 'floor' | 'paint' required
generationIdstring nullable

Existing generation ID to retry in-place. Allowed only when retrying a failed generation.

originalImageUrlstring nullable

URL of the uploaded image

referenceImageUrlsstring[]

Reference image URL list

selectedSegmentsinteger[] nullable

List of selected segment IDs

segmentationJobIdstring nullable

The job ID of the segmentation

segmentationResultUrlstring nullable

Direct URL for segmentation result payload (preferred over segmentationJobId when provided)

paletteIdstring nullable

Palette ID. Ignored for garden category.

promptstring nullable

User's AI instruction text

qualityTier'cheap' | 'fast' | 'best'

Response

Successful Response

generationIdstring required
statusstring required

Changes

No recorded changes to this operation across all 1 revision of this API.