ideogram-v4-edit API
Ideogram V4 Edit 已通过 API in One 接入真实生产路由 /api/v1/images/generations,后端节点为 node63。一个 API Key 即可调用并按成功请求计费。
请求体中的 model 字段。
当前已实现的 BFF 路由。
输入类型:text, image
密钥由共享 Dashboard 管理。
该路由不依赖 webhook。
服务亮点
用市场页形式展示真实已接入能力,不复用外部平台的 SLA、折扣或账号流程。
当前页面只展示已在 /api/v1 中实现的端点。 /api/v1/images/generations
该模型直接返回响应,不需要创建媒体任务。
充值、订单、积分余额和个人资料继续使用现有共享控制台与旧逻辑。
浏览器只持有 API in One Key,上游 Provider 调用由服务端处理。
调用契约
复制这些字段即可接入当前真实模型路由。
- Base URL
https://apiin.one客户端调用同源 API,服务端 BFF 转发到 Worker。- 鉴权
Authorization: Bearer <API_KEY>由现有 Dashboard API Keys 页面管理。- Model 字段
ideogram-v4-edit放在请求体 model 字段中。- 结果查询
/api/v1/tasks/{task_id}异步任务返回 task_id 后查询。- 计费入口
/billing/credits使用现有积分、订单和充值旧逻辑。
运行方式
该模型创建异步任务,返回 task_id 后通过真实状态接口取回结果。
API Console
像模型市场一样直接切换同端点真实模型、端点和语言,右侧示例由当前 live 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 下的已上线模型,快速判断成本、供应商覆盖和生产接入方式。
按基础积分从低到高排序。
异步媒体和工具任务使用 /api/v1/tasks/{task_id} 查询结果;对话模型直接返回响应。
真实能力
以下能力来自当前已接入的模型配置和后端路由,不展示未上线 API。
稳定生产路由
Prompt-guided image editing
统一接口
Adjustable edit strength
透明计费
Preserves source image structure
快速接入
JPEG, PNG, and WEBP output
请求方式
浏览器端只调用同源 API,服务端 BFF 再转发到对应 Worker。
参数
promptstringText instruction describing how to edit the input image
必填modelstringUse "ideogram-v4-edit"
必填 · 默认 ideogram-v4-editimagestringSource image URL to edit
必填strengthnumberEdit strength from 0 to 1
可选 · 默认 0.8resolutionstringOutput resolution: 1k or 2k
可选 · 默认 1kaspect_ratiostringOutput aspect ratio, such as 1:1 or 3:4
可选 · 默认 1:1qualitystringQuality tier: low, medium, or high
可选 · 默认 mediumoutput_formatstringOutput format: jpeg, png, or webp
可选 · 默认 jpeg示例请求
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"
}'同端点可切换模型
这些模型使用同一个已实现 BFF endpoint,可通过请求体中的 model 字段切换。
同端点模型对比
同一个真实路由下的模型差异,便于按成本、输入输出和后端节点选择。
node63🧠cogview-4Zhipu AI / WaveSpeed异步任务text -> image4 积分$0.04node48node41
grok-imaginexAI异步任务text -> image5 积分$0.05node31
kling-image-o1Kuaishou / WaveSpeed异步任务text + image -> image6 积分$0.06node49✦ideogram-v3Ideogram异步任务text + image -> image8 积分$0.08node63🌐imagen-4Google异步任务text -> image8 积分$0.08node47🤖gpt-image-1.5-officialOpenAI异步任务text + image -> image10 积分$0.10node42🎨recraft-v4Recraft异步任务text -> image10 积分$0.10node78✦ideogram-v4Ideogram异步任务text -> image12 积分$0.12node63node30🏔️hunyuan-image-3Tencent / WaveSpeed异步任务text + image -> image25 积分$0.25node68接入流程
这些步骤基于当前真实路由和共享账号体系,不新增独立登录、支付或订单流程。
创建共享 API Key
在现有 Dashboard 创建密钥,充值、订单、积分和个人信息仍走共享控制台。
调用真实端点
使用当前页面列出的 endpoint、model id 和参数发送请求。 /api/v1/images/generations
查询任务状态
异步媒体和工具任务使用 /api/v1/tasks/{task_id} 查询结果;对话模型直接返回响应。
任务状态查询
图像、视频、音频和工具任务创建后,使用真实任务端点查询结果。
GET/api/v1/tasks/{task_id}查询生成任务状态和结果。价格
2 credits per image (~$0.02); based on WaveSpeed $0.01 x200
使用场景
这些场景可通过当前模型和对应后端节点实现。
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
常见问题
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.