Simple RESTful Integration
Two endpoints, Bearer token auth, JSON in/out. Get started in minutes with cURL, JavaScript, or Python. No SDK required.
One model, flat $0.05 per request. No difference between text-to-image and image-to-image pricing.
text-to-imageGenerate images from text descriptions. Describe what you want and the AI creates it.
image-to-imageEdit existing images with text instructions. Upload a photo and describe the changes.
1:116:99:16Custom Size1K2K310 MBJPEG, PNG, WebP2,000 chars{ "aspect_ratio": "1:1" // 1:1, 16:9, 9:16 "resolution": "2K" // 1K, 2K "width": 1024 // custom width "height": 1024 // custom height "sub_scene": "watermark_removal" }
Everything you need to integrate AI image editing into your product, with simple APIs and transparent pricing.
Two endpoints, Bearer token auth, JSON in/out. Get started in minutes with cURL, JavaScript, or Python. No SDK required.
Transparent pay-as-you-go pricing. No monthly minimums, no hidden fees, no surprise charges. Scale from prototype to production.
Submit editing tasks and poll for results. Average response under 10 seconds. Built for production workloads with automatic retries.
API key authentication, rate limiting, CORS protection, and request validation. Your data is processed securely and never stored.
Background removal, style transfer, virtual try-on, photo restoration, object removal, portrait enhancement, colorization, and more — all from a single API endpoint.
Submit an editing task, then poll for the result. That's it.
Create an AI image editing task using the FireRed Image Edit model.
| Parameter | Type | Required | Description |
|---|---|---|---|
| mediaType | string | optional | Media type (defaults to "image") |
| model | string | optional | Model name (defaults to "firered-image-edit") |
| prompt | string | required | Editing instruction (e.g. "remove the background", "change hair color") |
| scene | string | required | Scene type: image-to-image or text-to-image |
| options | object | optional | Additional options: resolution, aspect_ratio, etc. |
mediaTypestringMedia type (defaults to "image")
modelstringModel name (defaults to "firered-image-edit")
promptstringrequiredEditing instruction (e.g. "remove the background", "change hair color")
scenestringrequiredScene type: image-to-image or text-to-image
optionsobjectAdditional options: resolution, aspect_ratio, etc.
Success Response
{ "code": 0, "data": { "taskId": "..." } }Copy-paste ready examples in your favorite language. Just replace the API key and you're good to go.
| 1 | curl -X POST https://firered-image.com/api/v1/generate \ |
| 2 | -H "Authorization: Bearer sk-xxxxx" \ |
| 3 | -H "Content-Type: application/json" \ |
| 4 | -d '{ |
| 5 | "mediaType": "image", |
| 6 | "model": "firered-image-edit", |
| 7 | "prompt": "remove the background and replace with a sunset beach", |
| 8 | "scene": "image-to-image", |
| 9 | "options": { "aspect_ratio": "1:1", "resolution": "2K" } |
| 10 | }' |
| 11 | |
| 12 | # Poll result |
| 13 | curl https://firered-image.com/api/v1/task/{taskId}?refresh=1 \ |
| 14 | -H "Authorization: Bearer sk-xxxxx" |
Create your API key and start building. Need custom volume pricing or have questions? Reach out to us.
Tell us about your use case and we'll set up your API access.