ideogram-v4-edit API
Edit images with the Ideogram V4 Edit API via API in One. Provide an image URL, prompt, strength, and output format. Pricing is 2 credits per image.
Use this in the request body model field.
The currently implemented BFF route.
Input types: text, image
Keys are managed by the shared dashboard.
This route does not require webhook handling.
Service highlights
Marketplace-style signals backed by the current live route, without copying external SLA, discount, login, or payment claims.
This page only shows endpoints implemented under /api/v1. /api/v1/images/generations
This model returns directly without creating a media task.
Top-up, orders, credit balance, and profile continue through the existing shared console.
Your browser only holds an API in One key; provider calls stay server-side.
Call contract
Use these fields to integrate the current live model route.
- Base URL
https://apiin.oneClients call same-origin APIs; the server BFF forwards to the Worker.- Authorization
Authorization: Bearer <API_KEY>Managed by the existing Dashboard API Keys page.- Model field
ideogram-v4-editSend this value in the request body model field.- Result path
/api/v1/tasks/{task_id}Async jobs return task_id, then use status polling.- Billing path
/billing/creditsUses the existing credits, orders, and top-up logic.
Runtime behavior
This model creates an async task, returns a task_id, then resolves through the real status route.
API Console
Switch between real models on this endpoint, choose a live route, and generate request examples from the current catalog payload.
curl --request POST \
--url https://apiin.one/api/v1/images/generations \
--header 'Authorization: Bearer <API_KEY>'
--header 'Content-Type: application/json' \
--data-raw '{
"model": "ideogram-v4-edit",
"prompt": "Change the person into a black suit while keeping the same pose and background",
"image": "https://example.com/input.jpg",
"strength": 0.8,
"resolution": "1k",
"aspect_ratio": "1:1",
"quality": "medium",
"output_format": "jpeg"
}'/api/v1/tasks/{task_id}Endpoint decision panel
Evaluate cost, provider coverage, and production integration behavior across live models on this implemented endpoint.
Sorted by base credits from low to high.
Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.
Live capabilities
These capabilities come from the current model config and backend route. Unreleased APIs are not listed.
Prompt
Prompt-guided image editing
Adjustable edit strength
Adjustable edit strength
Preserves source image structure
Preserves source image structure
JPEG
JPEG, PNG, and WEBP output
Request format
Clients call same-origin API routes; the server BFF forwards to the matching Worker.
POST/api/v1/images/generations2 creditsIdeogram V4 Edit — prompt-guided image editing that transforms an input image while preserving its structure.
Parameters
promptstringText instruction describing how to edit the input image
RequiredmodelstringUse "ideogram-v4-edit"
Required · Default ideogram-v4-editimagestringSource image URL to edit
RequiredstrengthnumberEdit strength from 0 to 1
Optional · Default 0.8resolutionstringOutput resolution: 1k or 2k
Optional · Default 1kaspect_ratiostringOutput aspect ratio, such as 1:1 or 3:4
Optional · Default 1:1qualitystringQuality tier: low, medium, or high
Optional · Default mediumoutput_formatstringOutput format: jpeg, png, or webp
Optional · Default jpegExample request
curl -X POST https://apiin.one/api/v1/images/generations \
-H "Authorization: Bearer aio_your_api_key" \
-H "Content-Type: application/json" \
--data-raw '{
"model": "ideogram-v4-edit",
"prompt": "Change the person into a black suit while keeping the same pose and background",
"image": "https://example.com/input.jpg",
"strength": 0.8,
"resolution": "1k",
"aspect_ratio": "1:1",
"quality": "medium",
"output_format": "jpeg"
}'Models on the same endpoint
These live models use the same implemented BFF endpoint and can be switched by changing the model field.
/api/v1/images/generations/api/v1/images/generations
grok-imagineimage · 5 credits/api/v1/images/generations
kling-image-o1image · 6 credits/api/v1/images/generations✦ideogram-v3image · 8 credits/api/v1/images/generations🌐imagen-4image · 8 credits/api/v1/images/generationsEndpoint model comparison
Compare real models behind this implemented route by cost, provider, runtime mode, input, output, and backend node.
node63🧠cogview-4Zhipu AI / WaveSpeedAsync tasktext -> image4 credits$0.04node48node41
grok-imaginexAIAsync tasktext -> image5 credits$0.05node31
kling-image-o1Kuaishou / WaveSpeedAsync tasktext + image -> image6 credits$0.06node49✦ideogram-v3IdeogramAsync tasktext + image -> image8 credits$0.08node63🌐imagen-4GoogleAsync tasktext -> image8 credits$0.08node47🤖gpt-image-1.5-officialOpenAIAsync tasktext + image -> image10 credits$0.10node42🎨recraft-v4RecraftAsync tasktext -> image10 credits$0.10node78✦ideogram-v4IdeogramAsync tasktext -> image12 credits$0.12node63node30🏔️hunyuan-image-3Tencent / WaveSpeedAsync tasktext + image -> image25 credits$0.25node68Integration flow
These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.
Create a shared API key
Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.
Call the real endpoint
Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/images/generations
Poll task status
Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.
Task status route
After creating image, video, audio, or tool tasks, poll the real task endpoint for results.
GET/api/v1/tasks/{task_id}Check generation task status and result.Pricing
2 credits per image (~$0.02); based on WaveSpeed $0.01 x200
Use cases
These workflows are supported by the current model and backend node.
Apply prompt-guided edits to product photos
Refine poster, logo, and marketing image designs
Build image-to-image editing workflows
Retouch brand visuals while preserving source composition
FAQ
How much does Ideogram V4 Edit cost?
WaveSpeed lists Ideogram V4 Edit at $0.01 per generated image, so API in One prices it at 2 credits per image using the requested USD x200 rule.
Which inputs are required?
Both prompt and image are required. The image field should be a URL to the source image to edit.
What does strength do?
Strength controls how strongly the edit transforms the input image. It ranges from 0 to 1 and defaults to 0.8.
Which output formats are supported?
JPEG, PNG, and WEBP are supported. The default output_format is jpeg.