Ideogram AI 绘图支持
Ideogram V3 接口
Ideogram V3 模型提供了高级的图像生成和处理能力。V3 接口与之前版本在参数和使用方式上有所不同,本节将详细介绍 V3 的各个接口及使用示例。
V3 Generate
POST
https://aihubmix.com/ideogram/v1/ideogram-v3/generate
根据给定提示词生成图像。V3 模型提供了更高质量的图像生成能力,支持更丰富的风格和参数控制。
用于生成图像的提示词
渲染速度选项,可选 TURBO
, DEFAULT
, QUALITY
单次出图数量,范围 1-8
增加图片几乎不会增加生图耗时
用于图像生成的宽高比,支持超多规格
可选 [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
和 V3 以下不同的模型使用的 ASPECT_10_16
类型的规范不同。
提示词增强选项。可用参数:AUTO
, ON
, OFF
生成图像的风格类型,可选 AUTO
, GENERAL
, REALISTIC
, DESIGN
注意相对 V2 版本,类型更聚焦
描述不想在图像中出现的内容
随机种子,范围:0-2147483647
单次生成多张图时不要使用 seed,否则会生成相同图像
风格参考图片,可用于风格引导
调用示例
V3 Remix
POST
https://aihubmix.com/ideogram/v1/ideogram-v3/remix
在参考图的基础上,根据提示词重新生成图像。V3 的 Remix 功能对原始图像的风格和内容有更好的保留能力。
用于重绘图像的提示词
原始图像文件
原图的影响权重,范围 1-100,数值越大,结果越像原图。
渲染速度选项,可选 TURBO
, DEFAULT
, QUALITY
单次出图数量,范围 1-8
输出图像的宽高比,可选 [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
风格参考图片,可用于风格引导
随机种子,范围:0-2147483647
提示词增强选项,可用参数:AUTO
, ON
, OFF
生成图像的风格类型,可选 AUTO
, GENERAL
, REALISTIC
, DESIGN
描述不想在图像中出现的内容
调用示例
V3 Edit
POST
https://aihubmix.com/ideogram/v1/ideogram-v3/edit
V3 的局部编辑功能允许用户通过提供原始图像和蒙版,精确地编辑图像的特定区域,同时保持其他区域不变。
用于编辑图像的提示词
原始图像文件
遮罩图片,黑色区域表示需要编辑的部分,白色区域表示保持不变
渲染速度选项,可选 TURBO
, DEFAULT
, QUALITY
单次出图数量,范围 1-8
输出图像的宽高比
随机种子,范围:0-2147483647
提示词增强选项,可用参数:AUTO
, ON
, OFF
生成图像的风格类型,可选 AUTO
, GENERAL
, REALISTIC
, DESIGN
描述不想在图像中出现的内容
调用示例
V3 Replace Background
POST
https://aihubmix.com/ideogram/v1/ideogram-v3/replace-background
V3 的背景替换功能可以智能地识别图像的前景和背景,并根据提示词替换背景,同时保持前景对象不变。
用于替换背景的提示词
原始图像文件
渲染速度选项,可选 TURBO
, DEFAULT
, QUALITY
单次出图数量,范围 1-8
风格参考图片,可用于风格引导
随机种子,范围:0-2147483647
提示词增强选项,可用参数:AUTO
, ON
, OFF
生成图像的风格类型,可选 AUTO
, GENERAL
, REALISTIC
, DESIGN
调用示例
更多可选参数可参考 Ideogram AI 官方指南
💰 V3 计价
Ideogram 模型 | Generate | Remix | Edit | Reframe | Replace BG |
---|---|---|---|---|---|
3.0 Turbo | US $0.03 | US $0.03 | US $0.06 | US $0.06 | US $0.06 |
3.0 Default | US $0.06 | US $0.06 | US $0.06 | US $0.06 | US $0.06 |
3.0 Quality | US $0.09 | US $0.09 | US $0.09 | US $0.09 | US $0.09 |
V2-V1 接口说明
Ideogram AI V2-V1 绘图接口,文字绘制能力强劲,支持生图(generate)、混合(remix)、局部编辑(edit)、放大(upscale)和描述(describe)等。
- 混合: 在参考图的基础上,根据提示词进行重绘,生成新的图片。
- 编辑: 在参考图的基础上,根据提示词和蒙版进行局部编辑,生成新的图片。
- 放大: 将低分辨率的图片放大至高分辨率,会重绘细节(相似度和细节比例可控制)。
- 描述: 提示词反推,用于描述图片
支持的风格:
- AUTO:默认的自动选定
- GENERAL:通用
- REALISTIC:写实
- DESIGN:设计
- RENDER_3D:3D
- ANIME:动漫
- 注意风格参数
style_type
仅适用于 V_2 及更高版本的模型。 - V3 支持即将上线
- 支持通过 AiHubMix 官方接口调用或 Cherry Studio APP 使用,注意目前需要打开代理才能生图,后续会支持国内直连,敬请期待。
- Cherry Studio 暂时只开放了 Ideogram 绘图(generate)接口。
Generate
POST
https://aihubmix.com/ideogram/generate\ 根据给定提示词和可选参数同步生成图像。图像链接的有效期有限;如果你想保留图像,必须下载保存。
Request Parameters
生成图像的请求对象
用于生图的提示词
用于图像生成的宽高比,决定了图像的分辨率。不能与分辨率参数同时使用。
可用比例:
- ASPECT_1_1
- ASPECT_3_1
- ASPECT_1_3
- ASPECT_3_2
- ASPECT_2_3
- ASPECT_4_3
- ASPECT_3_4
- ASPECT_16_9
- ASPECT_9_16
- SPECT_16_10
- ASPECT_10_16
用于生成或编辑图像的模型。/generate 和 /remix 支持所有模型类型,但 /edit 仅支持 V_2 和 V_2_TURBO。
可用模型版本:
- V_1
- V_1_TURBO
- V_2
- V_2_TURBO
- V_2A
- V_2A_TURBO
提示词增强选项。可用参数:AUTO, ON, OFF
随机种子,范围:0-2147483647
生成图像时使用的风格类型;此参数仅适用于 V_2 及更高版本的模型,不应在 V_1 版本中指定。
可用风格:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
描述不想在图像中出现的内容。仅适用于模型版本 V_1、V_1_TURBO、V_2 和 V_2_TURBO。提示词中的描述优先级高于负面提示词中的描述。
单次出图数量,范围 1-8
用于图像生成的分辨率(仅适用于模型版本 2.0,不能与 aspect_ratio 同时使用),以宽 x 高表示。如果未指定,则默认使用 aspect_ratio。
调用示例
Response
Image(s) generated successfully.
错误代码
400
: Post Generate Image Request Bad Request Error401
: Post Generate Image Request Unauthorized Error422
: Post Generate Image Request Unprocessable Entity Error429
: Post Generate Image Request Too Many Requests Error
Edit
POST
https://aihubmix.com/ideogram/edit
使用提供的蒙版同步编辑指定图像。蒙版标示出应被编辑的图像部分,而提示词和所选风格类型可进一步引导编辑方向。支持的图像格式包括 JPEG、PNG 和 WebP。图像链接的有效期有限;如果你想保留图像,必须下载保存。
Request Parameters
原始图像文件,支持 JPEG、PNG 和 WebP 格式
遮罩图片,必须符合以下要求:
- 仅包含黑色和白色像素,支持 RGB、RGBA 或灰度图像格式
- 与原图尺寸完全一致
- 黑色区域表示需要修改的部分,白色区域表示需要保持不变的部分
- 不能是纯白色
- 建议修改区域(黑色部分)面积至少占据图片的 10% 以上
用于局部编辑的提示词
用于生成或编辑图像的模型。/generate 和 /remix 支持所有模型类型,但 /edit 仅支持 V_2 和 V_2_TURBO。
可用模型版本:
- V_2
- V_2_TURBO
提示词增强选项。可用参数:AUTO, ON, OFF
单次出图数量,范围 1-8
随机种子,范围:0-2147483647
生成图像时使用的风格类型;此参数仅适用于 V_2 及更高版本的模型。
可用风格:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
调用示例
Response
Image edits generated successfully.
错误代码
400
: Post Edit Image Request Bad Request Error401
: Post Edit Image Request Unauthorized Error422
: Post Edit Image Request Unprocessable Entity Error429
: Post Edit Image Request Too Many Requests Error
Remix
POST
https://aihubmix.com/ideogram/remix
根据给定提示词和可选参数来融合提供的图像。输入图像会在重混前裁剪至所选宽高比。支持的图像格式包括 JPEG、PNG 和 WebP。图像链接的有效期有限;如果你想保留图像,必须下载保存。
Request Parameters
使用提供的图像和提示词生成新图像的请求,提供的图像会被裁剪以匹配所选的输出宽高比。
用于生成图像的提示词
用于图像生成的宽高比,决定了图像的分辨率。不能与分辨率参数同时使用。
可用比例:
- ASPECT_1_1
- ASPECT_3_1
- ASPECT_1_3
- ASPECT_3_2
- ASPECT_2_3
- ASPECT_4_3
- ASPECT_3_4
- ASPECT_16_9
- ASPECT_9_16
- SPECT_16_10
- ASPECT_10_16
参考图权重,范围:1-100
用于生成或编辑图像的模型。/generate 和 /remix 支持所有模型类型,但 /edit 仅支持 V_2 和 V_2_TURBO。
描述不想在图像中出现的内容。仅适用于模型版本 V_1、V_1_TURBO、V_2 和 V_2_TURBO。提示词中的描述优先级高于负面提示词中的描述。
提示词增强选项。可用参数:AUTO, ON, OFF
单次出图数量,范围:1-8
用于图像生成的分辨率(仅适用于模型版本 2.0,不能与 aspect_ratio 同时使用),以宽 x 高表示。如果未指定,则默认使用 aspect_ratio。
随机种子,范围:0-2147483647
生成图像的风格类型;仅适用于 V_2 及以上版本的模型,不应在 V_1 版本中指定。
可用风格:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
原始图像文件,支持 JPEG、PNG 和 WebP 格式
调用示例
Response
Image(s) generated successfully.
错误代码
400
: Post Remix Image Request Bad Request Error401
: Post Remix Image Request Unauthorized Error422
: Post Remix Image Request Unprocessable Entity Error429
: Post Remix Image Request Too Many Requests Error
Upscale
POST
https://aihubmix.com/ideogram/upscale
使用可选提示词同步放大提供的图像(超分)。支持的图像格式包括 JPEG、PNG 和 WebP。图像链接的有效期有限;如果你想保留图像,必须下载保存。
Request Parameters
请求对象,用于使用可选提示词放大提供的图像
可选的提示词,用于引导放大过程
相似度,范围:1-100
细节,范围:1-100
提示词增强选项。可用参数:AUTO, ON, OFF
生成数量,范围:1-8
随机种子,范围:0-2147483647
原始图像文件,支持 JPEG、PNG 和 WebP 格式
调用示例
Response
Image(s) generated successfully.
错误代码
400
: Post Upscale Image Request Bad Request Error401
: Post Upscale Image Request Unauthorized Error422
: Post Upscale Image Request Unprocessable Entity Error429
: Post Upscale Image Request Too Many Requests Error
Describe
POST
https://aihubmix.com/ideogram/describe
对上传的图像进行描述分析。支持的图像格式包括 JPEG、PNG 和 WebP。
Request Parameters
需要描述的图像文件,支持 JPEG、PNG 和 WebP 格式
调用示例
Response
Description(s) created successfully.
错误代码
400
: Post Describe Request Bad Request Error422
: Post Describe Request Unprocessable Entity Error429
: Post Describe Request Too Many Requests Error
💰 V2 & V1 计价
图像生成
型号 | 功能 | 每张图片费用 |
---|---|---|
2a | 文字生图,或文字 + 参考图生图 | US $0.04 |
2a Turbo | 文字生图,或文字 + 参考图生图(更快速但质量略低) | US $0.025 |
2.0 | 文字生图,或文字 + 参考图生图 | US $0.08 |
2.0 Turbo | 文字生图,或文字 + 参考图生图(更快速但质量略低) | US $0.05 |
1.0 | 文字生图,或文字 + 参考图生图 | US $0.06 |
1.0 Turbo | 文字生图,或文字 + 参考图生图(更快速但质量略低) | US $0.02 |
图像编辑
型号 | 功能 | 每张图片费用 |
---|---|---|
2.0 Edit | 通过文字提示、参考图片和二进制蒙版重新生成图像 | US $0.08 |
2.0 Turbo Edit | 通过文字提示、参考图片和二进制蒙版重新生成图像(更快速但质量略低) | US $0.05 |
图像增强
型号 | 功能 | 每张图片费用 |
---|---|---|
Upscale | 将参考图片分辨率提升至 2 倍,并可能增强图片效果 | US $0.06 |
更多详情可见官方文档