Ideogram V3 接口
Ideogram V3 模型提供了高級的圖像生成和處理能力。V3 接口與之前版本在參數和使用方式上有所不同,本節將詳細介紹 V3 的各個接口及使用示例。V3 Generate
POST https://aihubmix.com/ideogram/v1/ideogram-v3/generate
根據給定提示詞生成圖像。V3 模型提供了更高质量的圖像生成能力,支持更豐富的風格和參數控制。
用於圖像生成的宽高比,支持超多規格
可選 [‘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 類型的規範不同。調用示例
V3 Remix
POST https://aihubmix.com/ideogram/v1/ideogram-v3/remix
在參考圖的基礎上,根據提示詞重新生成圖像。V3 的 Remix 功能對原始圖像的風格和內容有更好的保留能力。
輸出圖像的宽高比,可選 [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
調用示例
V3 Edit
POST https://aihubmix.com/ideogram/v1/ideogram-v3/edit
V3 的局部編輯功能允許用戶通過提供原始圖像和蒙版,精確地編輯圖像的特定區域,同時保持其他區域不變。
調用示例
V3 Replace Background
POST https://aihubmix.com/ideogram/v1/ideogram-v3/replace-background
V3 的背景替換功能可以智能地識別圖像的前景和背景,並根據提示詞替換背景,同時保持前景對象不變。
調用示例
💰 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
用於圖像生成的宽高比,決定了圖像的分辨率。不能與分辨率參數同時使用。可用比例:
- 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
生成圖像時使用的風格類型;此參數僅適用於 V_2 及更高版本的模型,不應在 V_1 版本中指定。可用風格:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
調用示例
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
生成圖像時使用的風格類型;此參數僅適用於 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
生成圖像的風格類型;僅適用於 V_2 及以上版本的模型,不應在 V_1 版本中指定。可用風格:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
調用示例
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
調用示例
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
調用示例
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