PIpicsart
Text2Image

Text2Image

The Text2Image service helps generate an image based on the text introduced as input by the user. The result images can be as big as 1024x1024 pixels.

post/text2image

Request

  • Base URL
    https://genai-api.picsart.io/v1
  • URL
    https://genai-api.picsart.io/v1/text2image
  • Auth
    API key in header X-Picsart-API-Key

Request body

promptstring required

The prompt.

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:fluxai:model:fluxai:flux-2-pro-preview@1' | 'urn:air:openai:model:openai:gpt-image-1@1' | 'urn:air:openai:model:openai:gpt-image-1.5@1' | 'urn:air:openai:model:openai:gpt-image-2@1' | 'urn:air:openai:model:openai:gpt-image-2.5-flare@1' | 'urn:air:openai:model:openai:gpt-image-2.5-sunburst@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-pro-image@1' | 'urn:air:google:model:google:gemini-3.1-flash-image@1' | 'urn:air:google:model:google:gemini-3.1-flash-lite-image@1' | 'urn:air:google:model:google:gemini-nano-banana-2.1@1' | 'urn:air:seedream:model:seedream:seedream@4.0' | 'urn:air:seedream:model:seedream:seedream@4.5' | 'urn:air:seedream:model:seedream:seedream@4.7' | 'urn:air:seedream:model:seedream:seedream@5.0-lite' | 'urn:air:seedream:model:seedream:seedream@5.0-pro' | 'urn:air:seedream:model:seedream:seedream@5.0-flash' | 'urn:air:ideogram:model:ideogram:ideogram@2' | '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:ideogram:model:ideogram:p-image-very-low@1' | 'urn:air:ideogram:model:ideogram:p-image-low@1' | 'urn:air:ideogram:model:ideogram:p-image-medium@1' | 'urn:air:ideogram:model:ideogram:p-image-high@1' | 'urn:air:ideogram:model:ideogram:ideogram@4' | 'urn:air:ideogram:model:ideogram:ideogram-turbo@4' | 'urn:air:qwen:model:qwen:qwen-image-2.5@1' | 'urn:air:qwen:model:qwen:qwen-image-2@1' | 'urn:air:qwen:model:qwen:qwen-image-2.0-pro@1' | 'urn:air:qwen:model:qwen:qwen-image-3.0@1' | 'urn:air:qwen:model:qwen:qwen-image-3.0-pro@1' | 'urn:air:picsart:model:picsart:flux-2-klein@1' | 'urn:air:picsart:model:picsart:sana-sprint-v1@1' | 'urn:air:recraft:model:recraft:recraftv2@1' | 'urn:air:recraft:model:recraft:recraftv3@1' | 'urn:air:recraft:model:recraft:recraftv4@1' | 'urn:air:recraft:model:recraft:recraftv4_pro@1' | 'urn:air:recraft:model:recraft:recraftv4_1@1' | 'urn:air:recraft:model:recraft:recraftv4_1_pro@1' | 'urn:air:recraft:model:recraft:recraftv4_1_utility@1' | 'urn:air:recraft:model:recraft:recraftv4_1_utility_pro@1' | 'urn:air:recraft:model:recraft:recraftv4_1_flash@1' | 'urn:air:xai:model:xai:grok-imagine-image@1' | 'urn:air:xai:model:xai:grok-imagine-image-quality@1' | 'urn:air:xai:model:xai:grok-imagine-image-2.0@1' | 'urn:air:reve:model:reve:reve@1' | 'urn:air:hunyuan:model:hunyuan:hunyuan-image@3' | 'urn:air:runway:model:runway:gen4-image-ref@1' | 'urn:air:kling:model:kling:kling-v3@1' | 'urn:air:kling:model:kling:kling-image-o1@1' | 'urn:air:kling:model:kling:kling-v3-omni@1' | 'urn:air:meta:model:meta:muse-image-1.0@1' | 'urn:air:fluxai:model:fluxai:flux-3-image@1' | 'urn:air:fluxai:model:fluxai:flux-3-image-klein@1' | 'urn:air:ideogram:model:ideogram:ideogram@4.5' | 'urn:air:luma:model:luma:uni-1@1' | 'urn:air:luma:model:luma:uni-1-max@1' | 'urn:air:wan:model:wan:wan-2.6-image@1' 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

Changes

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