Generate AI Image Draft

post

https://{APP_DOMAIN}/api/3.2/asset-drafts

Generates an image candidate with AI and stores it as a draft Asset that is hidden from listings until applied. Pass source_asset_id (a committed asset or an earlier draft) to use its bytes as the edit reference, which is how iterative refinement chains candidates together. Drafts expire automatically after 24 hours unless applied via POST /asset-drafts/{id}/apply.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Body Params (mirrors POST /assets/generate plus source_asset_id)

prompt

string

required

source_asset_id

integer

Optional asset (committed or draft) whose bytes are the edit reference

model

string

enum

Allowed:

size

string

enum

Allowed:

quality

string

enum

Allowed:

keywords

string

tag_ids

array of integers

tag_ids

publication_id

integer

context

string

market_mode

string

enum

auto (default) reads tickers and range out of the prompt via AI; manual uses market_symbols; off disables market data

Allowed:

market_symbols

array of strings

Up to 5 tickers whose daily prices (via the Finviz integration) are folded into the prompt as the exact values to plot; several are aligned by session and indexed to 100

market_symbols

market_range

string

enum

Allowed:

accept_ai_billing_terms

boolean

Responses

202

The draft generation task has been queued; poll /tasks/{id} until data.asset is present

403

AI billing terms must be accepted before generation

422

Validation failed or the source asset is not an image