v1

latestOpenAPI 3.0.02026-07-248574216.0 KB

Text2Image

Text2Sticker

The Text2Sticker service helps generate a sticker based on the text introduced as input by the user. The result images can be as big as 1024x1024 pixels.

post/text2sticker

Request body

promptstring required

The prompt.

negative_promptstring

Deprecated. The negative prompt (don’t generate this type of images). Don't use the nagitve keywords such as 'no', e.g. don't use 'no distorted faces', use 'distorted faces'.

widthnumber

Desired width used to determine the aspect ratio and resolution tier. The actual output width is determined by the AI provider based on the closest matching supported aspect ratio. Supported ratios vary by model (common: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9).

heightnumber

Desired height used to determine the aspect ratio and resolution tier. The actual output height is determined by the AI provider based on the closest matching supported aspect ratio. Supported ratios vary by model (common: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9).

countnumber

The number of images to generate.

model'urn:air:sdxl:model:fluxai:flux_kontext_max@1' | 'urn:air:sdxl:model:fluxai:flux_kontext_pro@1' | 'urn:air:fluxai:model:fluxai:flux-2-flex@1' | 'urn:air:fluxai:model:fluxai:flux-2-pro@1' | 'urn:air:fluxai:model:fluxai:flux-2-max@1' | 'urn:air:google:model:google:gemini-2.5-flash-image@1' | 'urn:air:google:model:google:gemini-3-pro-image-preview@1' | 'urn:air:google:model:google:gemini-3.1-flash-image-preview@1' | 'urn:air:google:model:google:gemini-3.1-pro-preview@1' | 'urn:air:hunyuan:model:hunyuan:hunyuan-image@3' | 'urn:air:ideogram:model:ideogram:ideogram@1' | 'urn:air:ideogram:model:ideogram:ideogram@2' | 'urn:air:ideogram:model:ideogram:ideogram-turbo@1' | 'urn:air:ideogram:model:ideogram:ideogram-turbo@2' | 'urn:air:ideogram:model:ideogram:ideogram-2a@1' | 'urn:air:ideogram:model:ideogram:ideogram-2a-turbo@1' | 'urn:air:ideogram:model:ideogram:ideogram@3' | 'urn:air:google:model:google:imagen-4.0-generate-001@1' | 'urn:air:google:model:google:imagen-4.0-ultra-generate-001@1' | 'urn:air:google:model:google:imagen-4.0-fast-generate-001@1' | 'urn:air:openai:model:openai:dall-e-3@1' | 'urn:air:openai:model:openai:gpt-image-1@1' | 'urn:air:openai:model:openai:gpt-image-1.5@1' | 'urn:air:qwen:model:qwen:qwen-image-2.5@1' | 'urn:air:reve:model:reve:reve@1' | 'urn:air:runway:model:runway:gen4-image-ref@1' | 'urn:air:seedream:model:seedream:seedream@4.0' | 'urn:air:seedream:model:seedream:seedream@4.5' | 'urn:air:seedream:model:seedream:seedream@5.0-lite' nullable

Optionally choose a specific AI model to use for this request. If not specified, a default model will be applied. Please note that the default model may change over time as Picsart continues to improve performance and accuracy. Any change to the default will be made only after thorough testing and validation to ensure it delivers better results. If you require consistent behavior or wish to evaluate different models on your own, we recommend explicitly setting this parameter.

Example request

{
  "width": 512,
  "height": 512
}

Response

Accepted.

status'success' | 'error' | 'processing'

inference_idstring nullable