Public API
Public API - Generation

Generate Photo

Generate styled product photo(s) from reference images.

post/api/v1/public/generate/photo

Request

  • Base URL: https://api.aidentika.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.aidentika.com/api/v1/public/generate/photo
  • Auth: HTTP bearer

Headers

authorizationstring nullable

Request body

project_idinteger nullable

Append the generated Card to an existing Project. If omitted, the destination is decided by the API key's default_grouping (new keys default to a per-key 'API Inbox' project).

client_group_idstring nullable

Arbitrary correlation tag echoed back in /results and webhook payloads. Does not group on the server side.

category_idstring nullable

Omit for auto-detection from images

concept_idstring nullable

Omit to use default concept for category

product_namestring nullable
commentstring nullable

User wishes/additional description

photo_stylestring

'classic' or 'home'

aspect_ratiostring

9:16, 4:3, 1:1, 16:9, or 3:4

resolutionstring

Output resolution: 1K, 2K (default), or 4K. 1K and 2K use the base generation price; 4K costs 2 additional sparks.

webhook_urlstring nullable

Ad-hoc webhook URL for this request

localestring nullable

UI locale (ru/en/es) for auto-detected name/qualities + any on-image text

Response

Successful Response

action_idinteger required
statusstring
poll_urlstring required
project_idinteger nullable
card_idinteger nullable
client_group_idstring nullable
stylestring nullable
first_check_after_secinteger

Changes

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