Image APIActive

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.

Real routes1Real endpoint rows linked to this model.
Endpoint models12Live models sharing this endpoint.
Base cost2 credits$0.02 · 3–12 seconds
Endpoint familyImage API/api/v1/images/generations
Model IDideogram-v4-edit

Use this in the request body model field.

Endpoint/api/v1/images/generations

The currently implemented BFF route.

Outputimage

Input types: text, image

AuthBearer API key

Keys are managed by the shared dashboard.

WebhookNot required

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.

Live production route

This page only shows endpoints implemented under /api/v1. /api/v1/images/generations

Synchronous response

This model returns directly without creating a media task.

Shared billing system

Top-up, orders, credit balance, and profile continue through the existing shared console.

Managed provider credentials

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.one
Clients 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-edit
Send 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/credits
Uses 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.

Client request/api/v1/images/generationstask_id -> result
View usage logs

API Console

Switch between real models on this endpoint, choose a live route, and generate request examples from the current catalog payload.

Live model12 live models
Endpoint1 Routes
ProviderIdeogramhttps://n63.gogloai.com
Current cost2 credits · $0.022 credits per image (~$0.02); based on WaveSpeed $0.01 x200
RuntimeAsync taskAsync jobs return task_id, then use status polling.
Input / outputtext + image -> imageThis model returns directly without creating a media task.
Backend nodenode63Your browser only holds an API in One key; provider calls stay server-side.
Request previewPOST /api/v1/images/generations
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"
}'
Result path/api/v1/tasks/{task_id}
Open docs

Endpoint decision panel

Evaluate cost, provider coverage, and production integration behavior across live models on this implemented endpoint.

Endpoint models12These models share the same BFF route and switch through the model field.
Provider coverage10Real provider sources currently exposed by this endpoint.
Cost range2-25 credits$0.02-$0.25 · Based on the current live catalog base credit cost.
Webhook coverage5/12Models on this endpoint that support callback_url.
Current model position1/12

Sorted by base credits from low to high.

Lowest-cost route in this endpointideogram-v4-edit

Ideogram · 2 credits · $0.02

Production patternAsync task + status polling

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.

Parameters

promptstring

Text instruction describing how to edit the input image

Required
modelstring

Use "ideogram-v4-edit"

Required · Default ideogram-v4-edit
imagestring

Source image URL to edit

Required
strengthnumber

Edit strength from 0 to 1

Optional · Default 0.8
resolutionstring

Output resolution: 1k or 2k

Optional · Default 1k
aspect_ratiostring

Output aspect ratio, such as 1:1 or 3:4

Optional · Default 1:1
qualitystring

Quality tier: low, medium, or high

Optional · Default medium
output_formatstring

Output format: jpeg, png, or webp

Optional · Default jpeg

Example 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.

Endpoint model comparison

Compare real models behind this implemented route by cost, provider, runtime mode, input, output, and backend node.

Integration flow

These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.

01

Create a shared API key

Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.

02

Call the real endpoint

Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/images/generations

03

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

Base cost$0.02
Credits2
BillingSuccessful requests

Use cases

These workflows are supported by the current model and backend node.

01

Apply prompt-guided edits to product photos

02

Refine poster, logo, and marketing image designs

03

Build image-to-image editing workflows

04

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.

Related live models