Ideogram AI Drawing
Ideogram V3 Interface
Ideogram V3 model provides advanced image generation and processing capabilities. The V3 interface differs from previous versions in parameters and usage, and this section will detail the V3 interfaces and usage examples.
V3 Generate
POST
https://aihubmix.com/ideogram/v1/ideogram-v3/generate
Generate images based on given prompts. The V3 model provides higher quality image generation capabilities, supporting more diverse styles and parameter controls.
Prompt for image generation
Rendering speed options, available TURBO
, DEFAULT
, QUALITY
Number of images to generate, range 1-8
Generating more images will not significantly increase the generation time
Aspect ratio for image generation, supports a wide range of specifications
Available [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
The aspect ratios used in different models are different.
Prompt enhancement. Available parameters: AUTO
, ON
, OFF
Style type for image generation, available AUTO
, GENERAL
, REALISTIC
, DESIGN
Note: Compared to V2 version, the type is more focused
Description of content you do not want to appear in the image
Random seed, range: 0-2147483647
Do not use seed when generating multiple images, otherwise the same image will be generated
Style reference image, can be used for style guidance
Usage Examples
V3 Remix
POST
https://aihubmix.com/ideogram/v1/ideogram-v3/remix
Remix images based on a reference image and prompt. The Remix function of V3 has better retention of the style and content of the original image.
Prompt for image remixing
Original image file
The weight of the original image, range 1-100, the larger the value, the more similar the result to the original image.
Rendering speed options, available TURBO
, DEFAULT
, QUALITY
Number of images to generate, range 1-8 Generating more images will not significantly increase the generation time
Aspect ratio of the output image, available [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
Style reference image, can be used for style guidance
Random seed, range: 0-2147483647
Prompt enhancement. Available parameters: AUTO
, ON
, OFF
Style type for image generation, available AUTO
, GENERAL
, REALISTIC
, DESIGN
Description of content you do not want to appear in the image
Usage Examples
V3 Edit
POST
https://aihubmix.com/ideogram/v1/ideogram-v3/edit
The local editing function of V3 allows users to precisely edit specific areas of an image by providing the original image and mask, while keeping other areas unchanged.
Prompt for image editing
Original image file
Mask image, black area represents the part to be edited, white area represents the part to be kept unchanged
Rendering speed options, available TURBO
, DEFAULT
, QUALITY
Number of images to generate, range 1-8 Generating more images will not significantly increase the generation time
Aspect ratio of the output image, available [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
Random seed, range: 0-2147483647
Prompt enhancement. Available parameters: AUTO
, ON
, OFF
Style type for image generation, available AUTO
, GENERAL
, REALISTIC
, DESIGN
Description of content you do not want to appear in the image
Usage Examples
V3 Replace Background
POST
https://aihubmix.com/ideogram/v1/ideogram-v3/replace-background
V3 的背景替换功能可以智能地识别图像的前景和背景,并根据提示词替换背景,同时保持前景对象不变。
Prompt for background replacement
Original image file
Rendering speed options, available TURBO
, DEFAULT
, QUALITY
Number of images to generate, range 1-8 Generating more images will not significantly increase the generation time
Style reference image, can be used for style guidance
Random seed, range: 0-2147483647
Prompt enhancement. Available parameters: AUTO
, ON
, OFF
Style type for image generation, available AUTO
, GENERAL
, REALISTIC
, DESIGN
Usage Examples
For more optional parameters, please refer to Ideogram AI
💰 V3 Pricing
Ideogram v3 | Generate | Remix | Edit | Reframe | Replace BG |
---|---|---|---|---|---|
3.0 Turbo | US $0.03 | US $0.03 | US $0.03 | US $0.03 | US $0.03 |
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 Interface Description
Ideogram AI V2 & V1 drawing interface with strong text-to-image capabilities, including generate, remix, edit, upscale, and describe functionalities.
- Remix: Create new images based on a reference image and prompt.
- Edit: Make local edits to specific areas of a reference image using prompts and masks.
- Upscale: Enhance low-resolution images to high-resolution, with control over similarity and detail levels.
- Describe: Reverse-engineering prompts to describe images.
Supported Styles:
- AUTO: Default automatic selection
- GENERAL: General purpose
- REALISTIC: Realistic
- DESIGN: Design-oriented
- RENDER_3D: 3D rendering
- ANIME: Anime style
- Available through the official AiHubMix API or Cherry Studio APP. Note that currently a proxy is required for image generation; direct connection within China will be supported in the future.
- Cherry Studio currently only offers the Ideogram drawing (generate) interface.
Generate
POST
https://aihubmix.com/ideogram/generate
Synchronously generates images based on given prompts and optional parameters. Image links have a limited validity period; if you want to keep the images, you must download and save them.
Request Parameters
Request object for image generation
Prompt for image generation
Aspect ratio for image generation, determines the resolution. Cannot be used with resolution parameter.
Available ratios:
- 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
Model for generating or editing images. /generate and /remix support all model types, but /edit only supports V_2 and V_2_TURBO.
Available model versions:
- V_1
- V_1_TURBO
- V_2
- V_2_TURBO
- V_2A
- V_2A_TURBO
Prompt enhancement option. Available parameters: AUTO, ON, OFF
Random seed, range: 0-2147483647
Style type used for generating images; this parameter only applies to V_2 and higher versions of the model and should not be specified in V_1 versions.
Available styles:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
Describes what you don’t want to appear in the image. Only applicable to model versions V_1, V_1_TURBO, V_2, and V_2_TURBO. Descriptions in the prompt take precedence over descriptions in the negative prompt.
Number of images to generate, range 1-8
Resolution for image generation (only applicable to model version 2.0, cannot be used with aspect_ratio), expressed as width x height. If not specified, aspect_ratio is used by default.
Example Calls
Response
Image(s) generated successfully.
Error Codes
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
Synchronously edits a specified image using the provided mask. The mask indicates which parts of the image should be edited, while the prompt and selected style type can further guide the editing direction. Supported image formats include JPEG, PNG, and WebP. Image links have a limited validity period; if you want to keep the images, you must download and save them.
Request Parameters
Original image file, supports JPEG, PNG, and WebP formats
Mask image, must meet the following requirements:
- Contains only black and white pixels, supports RGB, RGBA, or grayscale image formats
- Exactly the same dimensions as the original image
- Black areas represent parts that need to be modified, white areas represent parts that need to remain unchanged
- Cannot be pure white
- The modified area (black part) should occupy at least 10% of the image area
Prompt for local editing
Model for generating or editing images. /generate and /remix support all model types, but /edit only supports V_2 and V_2_TURBO.
Available model versions:
- V_2
- V_2_TURBO
Prompt enhancement option. Available parameters: AUTO, ON, OFF
Number of images to generate, range 1-8
Random seed, range: 0-2147483647
Style type used for generating images; this parameter only applies to V_2 and higher versions of the model.
Available styles:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
Example Calls
Response
Image edits generated successfully.
Error Codes
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
Fuses the provided image with given prompts and optional parameters. Input images are cropped to the selected aspect ratio before remixing. Supported image formats include JPEG, PNG, and WebP. Image links have a limited validity period; if you want to keep the images, you must download and save them.
Request Parameters
Request to generate new images using the provided image and prompt. The provided image will be cropped to match the selected output aspect ratio.
Prompt for image generation
Aspect ratio for image generation, determines the resolution. Cannot be used with resolution parameter.
Available ratios:
- 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
Reference image weight, range: 1-100
Model for generating or editing images. /generate and /remix support all model types, but /edit only supports V_2 and V_2_TURBO.
Describes what you don’t want to appear in the image. Only applicable to model versions V_1, V_1_TURBO, V_2, and V_2_TURBO. Descriptions in the prompt take precedence over descriptions in the negative prompt.
Prompt enhancement option. Available parameters: AUTO, ON, OFF
Number of images to generate, range: 1-8
Resolution for image generation (only applicable to model version 2.0, cannot be used with aspect_ratio), expressed as width x height. If not specified, aspect_ratio is used by default.
Random seed, range: 0-2147483647
Style type for generated images; only applicable to V_2 and higher versions of models, should not be specified in V_1 versions.
Available styles:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
Original image file, supports JPEG, PNG, and WebP formats
Example Calls
Response
Image(s) generated successfully.
Error Codes
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
Synchronously upscales the provided image with optional prompts. Supported image formats include JPEG, PNG, and WebP. Image links have a limited validity period; if you want to keep the images, you must download and save them.
Request Parameters
Request object for upscaling the provided image with optional prompts
Optional prompt to guide the upscaling process
Resemblance, range: 1-100
Detail, range: 1-100
Prompt enhancement option. Available parameters: AUTO, ON, OFF
Number of images to generate, range: 1-8
Random seed, range: 0-2147483647
Original image file, supports JPEG, PNG, and WebP formats
Example Calls
Response
Image(s) generated successfully.
Error Codes
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
Analyzes and describes the uploaded image. Supported image formats include JPEG, PNG, and WebP.
Request Parameters
Image file to describe, supports JPEG, PNG, and WebP formats
Example Calls
Response
Description(s) created successfully.
Error Codes
400
: Post Describe Request Bad Request Error422
: Post Describe Request Unprocessable Entity Error429
: Post Describe Request Too Many Requests Error
💰 V2 & V1 Pricing
Image Generation
Model | Feature | Cost per Image |
---|---|---|
2a | Text to image, or text + reference image to image | US $0.04 |
2a Turbo | Text to image, or text + reference image to image (faster but slightly lower quality) | US $0.025 |
2.0 | Text to image, or text + reference image to image | US $0.08 |
2.0 Turbo | Text to image, or text + reference image to image (faster but slightly lower quality) | US $0.05 |
1.0 | Text to image, or text + reference image to image | US $0.06 |
1.0 Turbo | Text to image, or text + reference image to image (faster but slightly lower quality) | US $0.02 |
Image Editing
Model | Feature | Cost per Image |
---|---|---|
2.0 Edit | Regenerate images using text prompts, reference images, and binary masks | US $0.08 |
2.0 Turbo Edit | Regenerate images using text prompts, reference images, and binary masks (faster but slightly lower quality) | US $0.05 |
Image Enhancement
Model | Feature | Cost per Image |
---|---|---|
Upscale | Increase reference image resolution by 2x, possibly enhancing image quality | US $0.06 |
For more details, see the official documentation