Ideogram V3 接口
Ideogram V3 模型提供了高級的圖像生成和處理能力。V3 接口與之前版本在參數和使用方式上有所不同,本節將詳細介紹 V3 的各個接口及使用示例。V3 Generate
POST https://aihubmix.com/ideogram/v1/ideogram-v3/generate
根據給定提示詞生成圖像。V3 模型提供了更高质量的圖像生成能力,支持更豐富的風格和參數控制。
string
必填
用於生成圖像的提示詞
string
預設值:"DEFAULT"
渲染速度選項,可選
TURBO, DEFAULT, QUALITYinteger
預設值:"1"
單次出圖數量,範圍 1-8
增加圖片幾乎不會增加生圖耗時
增加圖片幾乎不會增加生圖耗時
string
預設值:"1x1"
用於圖像生成的宽高比,支持超多規格
可選 [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
和 V3 以下不同的模型使用的
可選 [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
和 V3 以下不同的模型使用的
ASPECT_10_16 類型的規範不同。string
預設值:"AUTO"
提示詞增強選項。可用參數:
AUTO, ON, OFFstring
預設值:"AUTO"
生成圖像的風格類型,可選
注意相對 V2 版本,類型更聚焦
AUTO, GENERAL, REALISTIC, DESIGN注意相對 V2 版本,類型更聚焦
string
描述不想在圖像中出現的内容
integer
隨機種子,範圍:0-2147483647
單次生成多張圖時不要使用 seed,否則會生成相同圖像
單次生成多張圖時不要使用 seed,否則會生成相同圖像
file
風格參考圖片,可用于風格引導
調用示例
V3 Remix
POST https://aihubmix.com/ideogram/v1/ideogram-v3/remix
在參考圖的基礎上,根據提示詞重新生成圖像。V3 的 Remix 功能對原始圖像的風格和內容有更好的保留能力。
string
必填
用於重繪圖像的提示詞
file
必填
原始圖像文件
integer
預設值:"50"
原圖的影響權重,範圍 1-100,數值越大,結果越像原圖。
string
預設值:"DEFAULT"
渲染速度選項,可選
TURBO, DEFAULT, QUALITYinteger
預設值:"1"
單次出圖數量,範圍 1-8
string
輸出圖像的宽高比,可選 [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
file
風格參考圖片,可用于風格引導
integer
隨機種子,範圍:0-2147483647
string
預設值:"AUTO"
提示詞增強選項,可用參數:
AUTO, ON, OFFstring
預設值:"AUTO"
生成圖像的風格類型,可選
AUTO, GENERAL, REALISTIC, DESIGNstring
描述不想在圖像中出現的内容
調用示例
V3 Edit
POST https://aihubmix.com/ideogram/v1/ideogram-v3/edit
V3 的局部編輯功能允許用戶通過提供原始圖像和蒙版,精確地編輯圖像的特定區域,同時保持其他區域不變。
string
必填
用於編輯圖像的提示詞
file
必填
原始圖像文件
file
必填
遮罩圖片,黑色區域表示需要編輯的部分,白色區域表示保持不變
string
預設值:"DEFAULT"
渲染速度選項,可選
TURBO, DEFAULT, QUALITYinteger
預設值:"1"
單次出圖數量,範圍 1-8
string
輸出圖像的宽高比
integer
隨機種子,範圍:0-2147483647
string
預設值:"AUTO"
提示詞增強選項,可用參數:
AUTO, ON, OFFstring
預設值:"AUTO"
生成圖像的風格類型,可選
AUTO, GENERAL, REALISTIC, DESIGNstring
描述不想在圖像中出現的内容
調用示例
V3 Replace Background
POST https://aihubmix.com/ideogram/v1/ideogram-v3/replace-background
V3 的背景替換功能可以智能地識別圖像的前景和背景,並根據提示詞替換背景,同時保持前景對象不變。
string
必填
用於替換背景的提示詞
file
必填
原始圖像文件
string
預設值:"DEFAULT"
渲染速度選項,可選
TURBO, DEFAULT, QUALITYinteger
預設值:"1"
單次出圖數量,範圍 1-8
file
風格參考圖片,可用于風格引導
integer
隨機種子,範圍:0-2147483647
string
預設值:"AUTO"
提示詞增強選項,可用參數:
AUTO, ON, OFFstring
預設值:"AUTO"
生成圖像的風格類型,可選
AUTO, GENERAL, REALISTIC, DESIGN調用示例
💰 V3 計價
V2-V1 接口說明
Ideogram AI V2-V1 繪圖接口,文字繪制能力強勁,支持生圖(generate)、混合(remix)、局部編輯(edit)、放大(upscale)和描述(describe)等。- 混合: 在參考圖的基礎上,根據提示詞進行重繪,生成新的圖片。
- 編輯: 在參考圖的基礎上,根據提示詞和蒙版進行局部編輯,生成新的圖片。
- 放大: 將低分辨率的圖片放大至高分辨率,會重繪細節(相似度和細節比例可控制)。
- 描述: 提示詞反推,用於描述圖片
- AUTO:默認的自動選定
- GENERAL:通用
- REALISTIC:寫實
- DESIGN:設計
- RENDER_3D:3D
- ANIME:動漫
Generate
POST https://aihubmix.com/ideogram/generate\ 根據給定提示詞和可選參數同步生成圖像。圖像鏈接的有效期有限;如果你想保留圖像,必須下載保存。
Request Parameters
object
必填
生成圖像的請求對象
string
必填
用於生圖的提示詞
string
預設值:"ASPECT_1_1"
用於圖像生成的宽高比,決定了圖像的分辨率。不能與分辨率參數同時使用。可用比例:
- 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
string
預設值:"V_2"
用於生成或編輯圖像的模型。/generate 和 /remix 支持所有模型類型,但 /edit 僅支持 V_2 和 V_2_TURBO。可用模型版本:
- V_1
- V_1_TURBO
- V_2
- V_2_TURBO
- V_2A
- V_2A_TURBO
string
預設值:"AUTO"
提示詞增強選項。可用參數:AUTO, ON, OFF
integer
隨機種子,範圍:0-2147483647
string
預設值:"AUTO"
生成圖像時使用的風格類型;此參數僅適用於 V_2 及更高版本的模型,不應在 V_1 版本中指定。可用風格:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
string
描述不想在圖像中出現的内容。僅適用於模型版本 V_1、V_1_TURBO、V_2 和 V_2_TURBO。提示詞中的描述優先級高於負面提示詞中的描述。
integer
預設值:"1"
單次出圖數量,範圍 1-8
string
用於圖像生成的分辨率(僅適用於模型版本 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
file
必填
原始圖像文件,支持 JPEG、PNG 和 WebP 格式
file
必填
遮罩圖片,黑色區域表示需要修改的部分,白色區域表示需要保持不變的部分
string
必填
用於局部編輯的提示詞
string
必填
用於生成或編輯圖像的模型。/generate 和 /remix 支持所有模型類型,但 /edit 僅支持 V_2 和 V_2_TURBO。可用模型版本:
- V_2
- V_2_TURBO
string
預設值:"AUTO"
提示詞增強選項。可用參數:AUTO, ON, OFF
integer
預設值:"1"
單次出圖數量,範圍 1-8
integer
隨機種子,範圍:0-2147483647
string
預設值:"AUTO"
生成圖像時使用的風格類型;此參數僅適用於 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
object
必填
使用提供的圖像和提示詞生成新圖像的請求,提供的圖像會被裁剪以匹配所選的輸出宽高比。
string
必填
用於生成圖像的提示詞
string
預設值:"ASPECT_1_1"
用於圖像生成的宽高比,決定了圖像的分辨率。不能與分辨率參數同時使用。可用比例:
- 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
integer
預設值:"50"
參考圖權重,範圍:1-100
string
預設值:"V_2"
用於生成或編輯圖像的模型。/generate 和 /remix 支持所有模型類型,但 /edit 僅支持 V_2 和 V_2_TURBO。
string
描述不想在圖像中出現的内容。僅適用於模型版本 V_1、V_1_TURBO、V_2 和 V_2_TURBO。提示詞中的描述優先級高於負面提示詞中的描述。
string
預設值:"AUTO"
提示詞增強選項。可用參數:AUTO, ON, OFF
integer
預設值:"1"
單次出圖數量,範圍:1-8
string
用於圖像生成的分辨率(僅適用於模型版本 2.0,不能與 aspect_ratio 同時使用),以寬 x 高表示。如果未指定,則默認使用 aspect_ratio。
integer
隨機種子,範圍:0-2147483647
string
預設值:"AUTO"
生成圖像的風格類型;僅適用於 V_2 及以上版本的模型,不應在 V_1 版本中指定。可用風格:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
file
必填
原始圖像文件,支持 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
object
必填
請求對象,用於使用可選提示詞放大提供的圖像
string
可選的提示詞,用於引導放大過程
integer
預設值:"50"
相似度,範圍:1-100
integer
預設值:"50"
細節,範圍:1-100
string
預設值:"AUTO"
提示詞增強選項。可用參數:AUTO, ON, OFF
integer
預設值:"1"
生成數量,範圍:1-8
integer
隨機種子,範圍:0-2147483647
file
必填
原始圖像文件,支持 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
file
必填
需要描述的圖像文件,支持 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