Image generation

Generate, edit or fill an image for review

post/image-generations

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/image-generations
  • Auth: one of:
    • HTTP bearer
    • API key in cookie openpost_session

Headers

Idempotency-Keystring required

Request body

$schemastring uri

A URL to the JSON Schema for this object.

background'auto' | 'opaque' | 'transparent' required
mask_pngstring

Base64 PNG; transparent pixels are selected. Fill only.

model'gpt-image-2.5-flare' | 'gpt-image-2.5-sunburst' required
operation'generate' | 'edit' | 'fill' required
page_idstring required
project_idstring required
promptstring required
quality'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto' required
size'square_hd' | 'portrait_4_3' | 'portrait_16_9' | 'landscape_4_3' | 'landscape_16_9' | 'auto' required
source_media_idstring
target_fingerprintstring

Browser snapshot fingerprint used to prevent stale application

target_layer_idstring
workspace_idstring required

Example request

{
  "$schema": "https://example.com/api/v1/schemas/ImageGenerationRequest.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

billing_statestring required
cost_microusdinteger nullable required
created_atstring date-time required
error_messagestring required
idstring required
modelstring required
operationstring required
page_idstring required
project_idstring required
promptstring required
result_media_idstring required
source_media_idstring required
statestring required
target_fingerprintstring required
target_layer_idstring required
workspace_idstring required

Example response

{
  "$schema": "https://example.com/api/v1/schemas/ImageGenerationRun.json"
}

Changes

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