PIpicsart
Text2Image

Text2Sticker with Laser Engraving Effect

This service generates stickers similar to the standard /text2sticker service, and in addition to that it adds a laser engraving effect. The result images can be as big as 1024x1024 pixels.

post/text2sticker/laserengraving

Request

  • Base URL
    https://genai-api.picsart.io/v1
  • URL
    https://genai-api.picsart.io/v1/text2sticker/laserengraving
  • 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.

engrave_colorstring

Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87). (If this parameter is present, the other bg_ parameters must be empty).

background_colorstring

Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87). (If this parameter is present, the other bg_ parameters must be empty).

format'JPG' | 'PNG' | 'WEBP' | 'SVG'

Optionally select one of the output image formats (JPG is chosen if left blank). Options are as follows:

  • JPG
  • PNG
  • WEBP
  • SVG
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.