Skip to main content

Ideogram V3 接口

Ideogram V3 模型提供了高級的圖像生成和處理能力。V3 接口與之前版本在參數和使用方式上有所不同,本節將詳細介紹 V3 的各個接口及使用示例。

V3 Generate

POST https://aihubmix.com/ideogram/v1/ideogram-v3/generate 根據給定提示詞生成圖像。V3 模型提供了更高质量的圖像生成能力,支持更豐富的風格和參數控制。
string
必填
用於生成圖像的提示詞
string
預設值:"DEFAULT"
渲染速度選項,可選 TURBO, DEFAULT, QUALITY
integer
預設值:"1"
單次出圖數量,範圍 1-8
增加圖片幾乎不會增加生圖耗時
string
預設值:"1x1"
用於圖像生成的宽高比,支持超多規格
可選 [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
和 V3 以下不同的模型使用的 ASPECT_10_16 類型的規範不同。
string
預設值:"AUTO"
提示詞增強選項。可用參數:AUTO, ON, OFF
string
預設值:"AUTO"
生成圖像的風格類型,可選 AUTO, GENERAL, REALISTIC, DESIGN
注意相對 V2 版本,類型更聚焦
string
描述不想在圖像中出現的内容
integer
隨機種子,範圍:0-2147483647
單次生成多張圖時不要使用 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, QUALITY
integer
預設值:"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, OFF
string
預設值:"AUTO"
生成圖像的風格類型,可選 AUTO, GENERAL, REALISTIC, DESIGN
string
描述不想在圖像中出現的内容

調用示例

V3 Edit

POST https://aihubmix.com/ideogram/v1/ideogram-v3/edit V3 的局部編輯功能允許用戶通過提供原始圖像和蒙版,精確地編輯圖像的特定區域,同時保持其他區域不變。
string
必填
用於編輯圖像的提示詞
file
必填
原始圖像文件
file
必填
遮罩圖片,黑色區域表示需要編輯的部分,白色區域表示保持不變
string
預設值:"DEFAULT"
渲染速度選項,可選 TURBO, DEFAULT, QUALITY
integer
預設值:"1"
單次出圖數量,範圍 1-8
string
輸出圖像的宽高比
integer
隨機種子,範圍:0-2147483647
string
預設值:"AUTO"
提示詞增強選項,可用參數:AUTO, ON, OFF
string
預設值:"AUTO"
生成圖像的風格類型,可選 AUTO, GENERAL, REALISTIC, DESIGN
string
描述不想在圖像中出現的内容

調用示例

V3 Replace Background

POST https://aihubmix.com/ideogram/v1/ideogram-v3/replace-background V3 的背景替換功能可以智能地識別圖像的前景和背景,並根據提示詞替換背景,同時保持前景對象不變。
string
必填
用於替換背景的提示詞
file
必填
原始圖像文件
string
預設值:"DEFAULT"
渲染速度選項,可選 TURBO, DEFAULT, QUALITY
integer
預設值:"1"
單次出圖數量,範圍 1-8
file
風格參考圖片,可用于風格引導
integer
隨機種子,範圍:0-2147483647
string
預設值:"AUTO"
提示詞增強選項,可用參數:AUTO, ON, OFF
string
預設值:"AUTO"
生成圖像的風格類型,可選 AUTO, GENERAL, REALISTIC, DESIGN

調用示例

更多可選參數可參考 Ideogram AI 官方指南

💰 V3 計價


V2-V1 接口說明

Ideogram AI V2-V1 繪圖接口,文字繪制能力強勁,支持生圖(generate)、混合(remix)、局部編輯(edit)、放大(upscale)和描述(describe)等。
  • 混合: 在參考圖的基礎上,根據提示詞進行重繪,生成新的圖片。
  • 編輯: 在參考圖的基礎上,根據提示詞和蒙版進行局部編輯,生成新的圖片。
  • 放大: 將低分辨率的圖片放大至高分辨率,會重繪細節(相似度和細節比例可控制)。
  • 描述: 提示詞反推,用於描述圖片
支持的風格:
  • AUTO:默認的自動選定
  • GENERAL:通用
  • REALISTIC:寫實
  • DESIGN:設計
  • RENDER_3D:3D
  • ANIME:動漫
  • 注意風格參數 style_type 僅適用於 V_2 及更高版本的模型。
  • V3 支持即將上線
  1. 支持通過 AiHubMix 官方接口調用或 Cherry Studio APP 使用,注意目前需要打開代理才能生圖。
  2. Cherry Studio 暫時只開放了 Ideogram 繪圖(generate)接口。

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 Error
  • 401 : Post Generate Image Request Unauthorized Error
  • 422 : Post Generate Image Request Unprocessable Entity Error
  • 429 : 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 Error
  • 401 : Post Edit Image Request Unauthorized Error
  • 422 : Post Edit Image Request Unprocessable Entity Error
  • 429 : 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 Error
  • 401 : Post Remix Image Request Unauthorized Error
  • 422 : Post Remix Image Request Unprocessable Entity Error
  • 429 : 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 Error
  • 401 : Post Upscale Image Request Unauthorized Error
  • 422 : Post Upscale Image Request Unprocessable Entity Error
  • 429 : 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 Error
  • 422 : Post Describe Request Unprocessable Entity Error
  • 429 : Post Describe Request Too Many Requests Error

💰 V2 & V1 計價

圖像生成

圖像編輯

圖像增強

更多詳情可見官方文件

最後更新:2026-06-01