Percify APIAdd headline text to ad images
Ad images get clean headline text in every size and language. For performance marketers.
How it works
Send an image and the change you want in words
One POST to /run with the model id and your input. It answers at once with an id.
We run Flux Kontext Pro
$0.08 each. Charged when it starts, refunded by itself if it fails.
Collect an edited image
GET /generations/{id}?wait=55 returns the same image with the change applied, as a file URL. Or pass a webhook and we call you.
3 models for this, by price
Prices are read from the live catalog. Each one opens the playground with this use case filled in.
The request
Filled in with sample files from our CDN, so it runs as it is. Swap in your own URLs.
curl https://api.percify.io/v3/playground/v1/run \
-H "Authorization: Bearer $PERCIFY_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"modelId": "flux-kontext-pro",
"input": {
"prompt": "Add the headline Summer Sale in bold white letters at the top",
"input_image": "https://cdn.percify.io/media-assets/web-v3/products/uc-product.jpg"
}
}'Full reference in the docs. Every field Flux Kontext Pro takes is on its model page.
Questions
What do I send to add headline text to ad images?
Send an image and the change you want in words in one POST to https://api.percify.io/v3/playground/v1/run. You get the same image with the change applied.
What does it cost?
With Flux Kontext Pro it is $0.08 each (4 credits each). The picks on this page range from $0.06 each to from $0.18 an image. The estimate call returns the exact price of your input before you run it, and a run that fails is refunded.
Which model should I use?
Budget: Qwen Image 2.0 Edit ($0.06 each). Balanced: Flux Kontext Pro ($0.08 each). Premium: Google Nano Banana 2 (Edit) (from $0.18 an image). Switching is one string in the request: the model id.
Can an AI agent do this for me?
Yes. Connect your agent to the MCP server at https://mcp.percify.io/mcp and ask for it in plain words. The agent calls the generate tool with the same model id and input shown on this page, and the call spends the same credits.
Edit an image with words
Put a product on a new background
Change the outfit in a photo