Add fancy text on your image
One POST request. Get the result back directly — as an image, video, or JSON depending on the tool.
curl -X POST https://apiai.me/api/workflow/fancy-text-on-images \
-H "X-API-Key: YOUR_API_KEY" \
-F "image=@input.jpg" \
-F "color_scheme=coral" \
-F "font_size=auto" \
-F "headline=VALUE" \
-F "margin=30" \
-F "opacity=1.0" \
-F "position=bottom-left" \
-F "rotation=0" \
-F "style=ribbon" \
-F "subline=VALUE" \
-F "text_padding=10"
--output result.png
Test this tool visually before writing any code. Upload an image, set parameters, and see the result live. When it looks right, copy the auto-generated curl command and paste it into your app.
Process hundreds of images at once without writing a loop. Upload a CSV with one row per item, set your parameters, and download the results as a ZIP when they're done.
| Name | Required | Description | Default / Options |
|---|---|---|---|
color_scheme |
optional | Colour palette: coral, midnight, lime, gold, pink, mono, sky | coralmidnightlimegoldpinkmonosky
|
font_size |
optional | Headline font size in pixels, or auto to scale with image | auto
|
headline |
required | Main promotional text, e.g. Summer Sale, Just In!, New Arrival | — |
margin |
optional | Gap from nearest edges in pixels | 30
|
opacity |
optional | Overall overlay opacity 0.0 (invisible) to 1.0 (fully opaque) | 1.0
|
position |
required | Where to place the badge on the image | top-lefttop-centertop-rightcenter-leftcenter-centercenter-rightbottom-leftbottom-centerbottom-right
|
rotation |
optional | Badge rotation in degrees (positive = clockwise) | 0
|
style |
optional | Visual treatment: ribbon, badge, sticker, pill, banner, tag | ribbonbadgestickerpillbannertag
|
subline |
optional | Optional smaller second line, e.g. Up to 50% off | — |
text_padding |
optional | Extra inner padding in pixels between the text and the badge edges | 10
|
Get an API key, test Fancy text on images in the dashboard, and copy the curl command.