Image Generation Model: ideogram

2024.08.27 This site now supports the image generation model ideogram
The official promotion claims that version V_2 outperforms Midjourney

Online Trial

Note 1. Visit https://ideogram.ddaiai.com (if blocked, try changing the subdomain prefix to any)

2. If it is blocked, you can change the address yourself: https://any.ddaiai.com — replace any with something else, e.g. https://2025.ddaiai.com, all of these work

Setup

Open https://ideogram.ddaiai.com
Configure the fields shown in the image below
Ideogram API endpoint: https://api.openai-hk.com
Ideogram KEY: hk-your-apiKey

ideogram

Result

ideogram

Pricing

One image per request
Different models have different prices

Model	Price	Notes
V_2	3000 credits/image
V_2_TURBO	2000 credits/image
V_1	2400 credits/image
V_1_TURBO	800 credits/image
upscale	2400 credits/image	Image upscale
describe	400 credits/image	Image to text

API Usage

Parameters are identical to the official API
Replace the official https://api.ideogram.ai with https://api.openai-hk.com/ideogram
Replace the official Api-Key header with Authorization

1. Text to Image

post https://api.openai-hk.com/ideogram/generate

shell

curl --request POST \
  --url https://api.openai-hk.com/ideogram/generate \
  --header 'Authorization: Bearer hk-your-api-key' \
  --header 'content-type: application/json' \
  --data '{
  "image_request": {
    "model": "V_2_TURBO",
    "magic_prompt_option": "AUTO",
    "prompt": "小花猫在刷牙",
    "aspect_ratio": "ASPECT_16_9",
    "seed": 889978,
    "negative_prompt": "food"
  }
}'

curl --request POST \
  --url https://api.openai-hk.com/ideogram/generate \
  --header 'Authorization: Bearer hk-your-api-key' \
  --header 'content-type: application/json' \
  --data '{
  "image_request": {
    "model": "V_2_TURBO",
    "magic_prompt_option": "AUTO",
    "prompt": "小花猫在刷牙",
    "aspect_ratio": "ASPECT_16_9",
    "seed": 889978,
    "negative_prompt": "food"
  }
}'

Response body

json

{
  "created": "2024-08-27T06:37:55.540681+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A photo of a kitten brushing its teeth. The kitten is sitting on a wooden surface and is wearing a tiny blue coat. A human hand is holding the kitten and a toothbrush. The background is blurred and contains a houseplant and a lamp.",
      "resolution": "1312x736",
      "seed": 889978,
      "url": "https://ideogram.ai/api/images/ephemeral/VpY8Fh3BReygMVQ91pVlcg.png?exp=1724827086&sig=5e699e2e7f0b1840603c33ba5188121c2afeceb58b1d07daf892da883e5c0ee7"
    }
  ]
}

{
  "created": "2024-08-27T06:37:55.540681+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A photo of a kitten brushing its teeth. The kitten is sitting on a wooden surface and is wearing a tiny blue coat. A human hand is holding the kitten and a toothbrush. The background is blurred and contains a houseplant and a lamp.",
      "resolution": "1312x736",
      "seed": 889978,
      "url": "https://ideogram.ai/api/images/ephemeral/VpY8Fh3BReygMVQ91pVlcg.png?exp=1724827086&sig=5e699e2e7f0b1840603c33ba5188121c2afeceb58b1d07daf892da883e5c0ee7"
    }
  ]
}

2. Image to Image

post https://api.openai-hk.com/ideogram/remix

shell

curl --request POST \
  --url https://api.openai-hk.com/ideogram/remix \
  --header 'Authorization: Bearer hk-your-api-key' \
  --header 'content-type: multipart/form-data' \
  --form image_file=@/your/dir/file/163-q.jpg \
  --form 'image_request={"model":"V_1_TURBO","magic_prompt_option":"AUTO","prompt":"狗","aspect_ratio":"ASPECT_16_9","seed":1234567,"negative_prompt":"花"}'

curl --request POST \
  --url https://api.openai-hk.com/ideogram/remix \
  --header 'Authorization: Bearer hk-your-api-key' \
  --header 'content-type: multipart/form-data' \
  --form image_file=@/your/dir/file/163-q.jpg \
  --form 'image_request={"model":"V_1_TURBO","magic_prompt_option":"AUTO","prompt":"狗","aspect_ratio":"ASPECT_16_9","seed":1234567,"negative_prompt":"花"}'

Response body

json

{
  "created": "2024-08-27T06:30:50.286536+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A playful and adorable Japanese Shiba Inu dog. The dog has a fluffy, red-brown coat and beaming, bright eyes. It is wagging its bushy tail and looking up with a mischievous grin. The background features cherry blossoms in full bloom, creating a beautiful, serene atmosphere.",
      "resolution": "1280x720",
      "seed": 1234567,
      "url": "https://ideogram.ai/api/images/ephemeral/UEcYRZecRpKR9ywbSUd6zg.png?exp=1724826654&sig=75450815e5acdc0a3192d4e3a6d8acf31a23cd96dddc4d4edef02bcc4407ee18"
    }
  ]
}

{
  "created": "2024-08-27T06:30:50.286536+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A playful and adorable Japanese Shiba Inu dog. The dog has a fluffy, red-brown coat and beaming, bright eyes. It is wagging its bushy tail and looking up with a mischievous grin. The background features cherry blossoms in full bloom, creating a beautiful, serene atmosphere.",
      "resolution": "1280x720",
      "seed": 1234567,
      "url": "https://ideogram.ai/api/images/ephemeral/UEcYRZecRpKR9ywbSUd6zg.png?exp=1724826654&sig=75450815e5acdc0a3192d4e3a6d8acf31a23cd96dddc4d4edef02bcc4407ee18"
    }
  ]
}

3. Image Upscale

post https://api.openai-hk.com/ideogram/upscale

shell

curl --request POST \
  --url https://api.openai-hk.com/ideogram/upscale \
  --header 'Authorization: Bearer hk-your-api-key' \
  --header 'content-type: multipart/form-data' \
  --form image_file=@/your/dir/file/6267944d-ce94-40d9-bc74-6b5aa9a3f971_0.png \
  --form 'image_request={"resemblance":50,"magic_prompt_option":"AUTO","prompt":"good new","seed":12345,"detail":50}'

curl --request POST \
  --url https://api.openai-hk.com/ideogram/upscale \
  --header 'Authorization: Bearer hk-your-api-key' \
  --header 'content-type: multipart/form-data' \
  --form image_file=@/your/dir/file/6267944d-ce94-40d9-bc74-6b5aa9a3f971_0.png \
  --form 'image_request={"resemblance":50,"magic_prompt_option":"AUTO","prompt":"good new","seed":12345,"detail":50}'

Response body

json

{
  "created": "2024-08-26T15:08:17.566361+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A joyful and heartwarming scene of a group of people celebrating good news. They are gathered around a large cake adorned with the words 'Happy News!' in frosting. The people are smiling and clapping, with some lifting champagne flutes in a toast. The room is decorated with colorful balloons and streamers, creating an atmosphere of happiness and excitement.",
      "resolution": "2048x2048",
      "seed": 12345,
      "url": "https://ideogram.ai/api/images/ephemeral/tf_hAJDDSAilGIKtGrzL3w.png?exp=1724771317&sig=c9dbaa8b0f9c0515d2d1d6a31adf9ecf06223e219b53f59b7cb9d7d3320bd18a"
    }
  ]
}

{
  "created": "2024-08-26T15:08:17.566361+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A joyful and heartwarming scene of a group of people celebrating good news. They are gathered around a large cake adorned with the words 'Happy News!' in frosting. The people are smiling and clapping, with some lifting champagne flutes in a toast. The room is decorated with colorful balloons and streamers, creating an atmosphere of happiness and excitement.",
      "resolution": "2048x2048",
      "seed": 12345,
      "url": "https://ideogram.ai/api/images/ephemeral/tf_hAJDDSAilGIKtGrzL3w.png?exp=1724771317&sig=c9dbaa8b0f9c0515d2d1d6a31adf9ecf06223e219b53f59b7cb9d7d3320bd18a"
    }
  ]
}

4. Image to Text

post https://api.openai-hk.com/ideogram/describe

shell

curl --request POST \
  --url https://api.openai-hk.com/ideogram/describe \
  --header 'Authorization: Bearer hk-your-api-key' \
  --header 'content-type: multipart/form-data' \
  --form image_file=@/your/dir/file/food.png

curl --request POST \
  --url https://api.openai-hk.com/ideogram/describe \
  --header 'Authorization: Bearer hk-your-api-key' \
  --header 'content-type: multipart/form-data' \
  --form image_file=@/your/dir/file/food.png

Response body

json

{
  "descriptions": [
    {
      "text": "A vibrant and abundant spread of food and drinks on a wooden table. There are various dishes, including a pot of pasta, slices of meat, fresh fruits like apples and grapes, and a bowl of soup. The table is adorned with wine glasses filled with red wine, and there are also some decorative items like a small Christmas tree. The lighting is warm, suggesting a cozy indoor setting, possibly during the holiday season."
    }
  ]
}

{
  "descriptions": [
    {
      "text": "A vibrant and abundant spread of food and drinks on a wooden table. There are various dishes, including a pot of pasta, slices of meat, fresh fruits like apples and grapes, and a bowl of soup. The table is adorned with wine glasses filled with red wine, and there are also some decorative items like a small Christmas tree. The lighting is warm, suggesting a cozy indoor setting, possibly during the holiday season."
    }
  ]
}

V3 API Usage

2025.05.08 This site now supports ideogram-v3
Official documentation: https://developer.ideogram.ai/api-reference/api-reference/generate-v3
Official pricing: https://about.ideogram.ai/api-pricing
This site pricing: exchange rate 1:3, e.g. if the official price is 0.06 USD, this site charges 0.18 CNY which equals 1800 credits
v3 1800 credits/image, v3_turbo 900 credits/image, v3_quality 2700 credits/image

1. Text to Image (generate)

For more parameters, refer to the official docs

shell

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/generate \
 -H 'Authorization: Bearer hk-your-api-key' \
 -H "Content-Type: multipart/form-data" \
 -F prompt="A photo of a cat sleeping on a couch." \
 -F rendering_speed="TURBO"

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/generate \
 -H 'Authorization: Bearer hk-your-api-key' \
 -H "Content-Type: multipart/form-data" \
 -F prompt="A photo of a cat sleeping on a couch." \
 -F rendering_speed="TURBO"

With character consistency

shell

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/generate \
 -H 'Authorization: Bearer hk-your-api-key' \
 -H "Content-Type: multipart/form-data" \
 -F prompt="A photo of a cat sleeping on a couch." \
 -F character_reference_images[]=@<file1> \
 -F character_reference_images[]=@<file2> \
 -F rendering_speed="TURBO"

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/generate \
 -H 'Authorization: Bearer hk-your-api-key' \
 -H "Content-Type: multipart/form-data" \
 -F prompt="A photo of a cat sleeping on a couch." \
 -F character_reference_images[]=@<file1> \
 -F character_reference_images[]=@<file2> \
 -F rendering_speed="TURBO"

Response body

json

{
  "created": "2000-01-23 04:56:07+00:00",
  "data": [
    {
      "prompt": "A photo of a cat sleeping on a couch.",
      "resolution": "1024x1024",
      "is_image_safe": true,
      "seed": 12345,
      "url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89",
      "style_type": "GENERAL"
    }
  ]
}

{
  "created": "2000-01-23 04:56:07+00:00",
  "data": [
    {
      "prompt": "A photo of a cat sleeping on a couch.",
      "resolution": "1024x1024",
      "is_image_safe": true,
      "seed": 12345,
      "url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89",
      "style_type": "GENERAL"
    }
  ]
}

2. Image Edit (edit)

For more parameters, refer to the official docs

shell

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/edit \
  -H 'Authorization: Bearer hk-your-api-key' \
  -H "Content-Type: multipart/form-data" \
  -F image=@<file1> \
  -F mask=@<file1> \
  -F prompt="A photo of a cat wearing a hat." \
  -F rendering_speed="DEFAULT"

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/edit \
  -H 'Authorization: Bearer hk-your-api-key' \
  -H "Content-Type: multipart/form-data" \
  -F image=@<file1> \
  -F mask=@<file1> \
  -F prompt="A photo of a cat wearing a hat." \
  -F rendering_speed="DEFAULT"

With character consistency

shell

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/edit \
 -H 'Authorization: Bearer hk-your-api-key' \
 -H "Content-Type: multipart/form-data" \
 -F image=@<file1> \
 -F mask=@<file1> \
 -F prompt="A photo of a cat wearing a hat." \
 -F character_reference_images[]=@<file1> \
 -F character_reference_images[]=@<file2> \
 -F rendering_speed="DEFAULT"

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/edit \
 -H 'Authorization: Bearer hk-your-api-key' \
 -H "Content-Type: multipart/form-data" \
 -F image=@<file1> \
 -F mask=@<file1> \
 -F prompt="A photo of a cat wearing a hat." \
 -F character_reference_images[]=@<file1> \
 -F character_reference_images[]=@<file2> \
 -F rendering_speed="DEFAULT"

3. Reframe

For more parameters, refer to the official docs

shell

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/reframe \
  -H 'Authorization: Bearer hk-your-api-key' \
  -H "Content-Type: multipart/form-data" \
  -F image=@<file1> \
  -F resolution="512x1536"

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/reframe \
  -H 'Authorization: Bearer hk-your-api-key' \
  -H "Content-Type: multipart/form-data" \
  -F image=@<file1> \
  -F resolution="512x1536"

4. Remove Background / Replace Background

For more parameters, refer to the official docs

shell

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/replace-background \
  -H 'Authorization: Bearer hk-your-api-key' \
  -H "Content-Type: multipart/form-data" \
  -F image=@<file1> \
  -F prompt="Add a forest in the background"

curl -X POST https://api.openai-hk.com/ideogram/v1/ideogram-v3/replace-background \
  -H 'Authorization: Bearer hk-your-api-key' \
  -H "Content-Type: multipart/form-data" \
  -F image=@<file1> \
  -F prompt="Add a forest in the background"

Image Generation Model: ideogram ​

Online Trial ​

Setup ​

Result ​

Pricing ​

API Usage ​

1. Text to Image ​

2. Image to Image ​

3. Image Upscale ​

4. Image to Text ​

V3 API Usage ​

1. Text to Image (generate) ​

2. Image Edit (edit) ​

3. Reframe ​

4. Remove Background / Replace Background ​

Image Generation Model: ideogram

Online Trial

Setup

Result

Pricing

API Usage

1. Text to Image

2. Image to Image

3. Image Upscale

4. Image to Text

V3 API Usage

1. Text to Image (generate)

2. Image Edit (edit)

3. Reframe

4. Remove Background / Replace Background