Pixazo APIModelsIdeogram
Pixazo APIModelsIdeogram

Ideogram RMBG API, Ideogram 2.0 API, Ideogram Turbo API - AI Image Generation APIs

by Ideogram

Ideogram RMBG API, developers can create images containing logos, signs, typography, and text elements that render correctly. The API offers both standard and turbo variants, plus features like image editing, remixing, and description generation.

Get API Key
Ideogram AI API

Models Version

LIMITED TIME OFFER

Get $5 Free Credit on First Payment

No strings attached — add funds and get $5 bonus instantly

Claim Your $5 →

Ideogram Remove Background Image to Image (Image Background Removal) API Documentation

https://gateway.pixazo.ai/ideogram-remove-background/v1

Authentication

All requests require an API key passed via header.

Header Type Required Description
Ocp-Apim-Subscription-Key string Yes Your API subscription key

Ideogram Remove Background generate request - Ideogram Remove Background

Request Code

POST https://gateway.pixazo.ai/ideogram-remove-background/v1/ideogram-remove-background-request
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/Image.jpeg"
}
import requests

url = "https://gateway.pixazo.ai/ideogram-remove-background/v1/ideogram-remove-background-request"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
    "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/Image.jpeg"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())
fetch('https://gateway.pixazo.ai/ideogram-remove-background/v1/ideogram-remove-background-request', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Cache-Control': 'no-cache',
    'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
  },
  body: JSON.stringify({
    image_url: 'https://pub-582b7213209642b9b995c96c95a30381.r2.dev/Image.jpeg'
  })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -X POST "https://gateway.pixazo.ai/ideogram-remove-background/v1/ideogram-remove-background-request" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  --data-raw '{
    "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/Image.jpeg"
  }'

Output

{
  "images": [
    {
      "file_name": "nano-banana-pro-edit-output.png",
      "content_type": "image/png",
      "url": "[RESPONSE_URL]"
    }
  ],
  "description": ""
}

Request Parameters - Ideogram Remove Background generate request

Field Type Required Default Description
image_url string Yes Source image URL. Supported formats: JPEG, PNG, WebP. Max file size 10MB.
sync_mode boolean No false If true, returns the result as a data URI inline instead of storing it in request history.

Minimum Request

{
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/Image.jpeg"
}

Full Request (all options)

{
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/Image.jpeg",
  "sync_mode": false
}

Response

{
  "request_id": "ideogram-remove-background_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/ideogram-remove-background_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Response Fields - Ideogram Remove Background generate request

Field Type Description
request_id string Unique identifier for the job submission.
status string Current status of the request (QUEUED, PROCESSING, etc.).
polling_url string URL to use for checking the job status.

Request Headers

Header Value
Content-Type application/json
Cache-Control no-cache
Ocp-Apim-Subscription-Key Your subscription key

Response Handling

Common status codes for Ideogram Remove Background generate request.

Code Meaning
200 Success
Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
Too Many Requests
500 Internal Server Error

Error Responses

400: Bad Request

{
  "error": "Invalid image_url",
  "message": "The provided image_url is malformed or unreachable."
}

401: Unauthorized

{
  "error": "Unauthorized",
  "message": "Missing or invalid Ocp-Apim-Subscription-Key header."
}

Status Workflow

Check status of your request using the polling_url returned in the response.

Status Values

Status Description
QUEUED Request accepted, waiting to be processed
PROCESSING Being processed by the model
COMPLETED Done — output contains the result
FAILED Failed — check error field
ERROR System error — not charged

Status Flow

Submitted
    ↓
  QUEUED
    ↓
PROCESSING
    ↓
COMPLETED or FAILED or ERROR

Typical Workflow

  1. Submit request to /ideogram-remove-background-request
  2. Receive response with request_id and polling_url
  3. Make GET requests to polling_url every 2–3 seconds
  4. When status is COMPLETED, extract output from the response
  5. Handle FAILED or ERROR states as appropriate

Ideogram Remove Background check status - Ideogram Remove Background

Request Code

POST https://gateway.pixazo.ai/v2/requests/status/ideogram-remove-background_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
import requests

url = "https://gateway.pixazo.ai/v2/requests/status/ideogram-remove-background_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())
fetch('https://gateway.pixazo.ai/v2/requests/status/ideogram-remove-background_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx', {
  method: 'GET',
  headers: {
    'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  "https://gateway.pixazo.ai/v2/requests/status/ideogram-remove-background_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Output

{
  "images": [
    {
      "file_name": "nano-banana-pro-edit-output.png",
      "content_type": "image/png",
      "url": "[RESPONSE_URL]"
    }
  ],
  "description": ""
}

Request Parameters - Ideogram Remove Background check status

Field Type Required Default Description
request_id string Yes The unique request ID returned from the initial submission endpoint.

Minimum Request

{
  "request_id": "ideogram-remove-background_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Full Request (all options)

{
  "request_id": "ideogram-remove-background_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Response

{
  "request_id": "ideogram-remove-background_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "ideogram-remove-background",
  "error": null,
  "output": {
    "media_url": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/ideogram-remove-background_019dxxxx/output.png"],
    "media_type": "image/png"
  },
  "created_at": "2026-03-31T10:00:00.000Z",
  "updated_at": "2026-03-31T10:00:15.000Z",
  "completed_at": "2026-03-31T10:00:15.000Z"
}

Response Fields - Ideogram Remove Background check status

Field Type Description
request_id string Unique identifier for the request.
status string Current status of the job (QUEUED, PROCESSING, COMPLETED, FAILED, ERROR).
model_id string The model used for processing.
error null|string null if successful, error details if failed.
output object Contains media_url and media_type for the generated result.
output.media_url array Array of URLs pointing to the generated media.
output.media_type string MIME type of the output (e.g., image/png).
created_at string Timestamp when the request was received.
updated_at string Timestamp when the request status was last updated.
completed_at string Timestamp when the request was completed.

Request Headers

Header Value
Ocp-Apim-Subscription-Key Your subscription key

Response Handling

Common status codes for Ideogram Remove Background check status.

Code Meaning
200 Success
400 Bad Request - Invalid request_id
401 Unauthorized
404 Not Found - Request ID not found
Too Many Requests
500 Internal Server Error

Notes & Tips

  • Pricing is $0.01 per request.
  • Use sync_mode: true if you need the output as a data URI directly in the submission response (not recommended for production).
  • Wait 2–3 seconds between polling requests for optimal performance.
  • Implement exponential backoff for retrying failed or system error responses.
  • Image must be under 10MB and in JPEG, PNG, or WebP format.
  • The output is always a transparent PNG, suitable for compositing.
  • Responses from the polling endpoint are not cached — each poll counts toward your usage limits.
  • Use the polling URL returned in the initial response — do not construct it manually.

Ideogram Remove Background Image to Image (Image Background Removal) API Pricing

ResolutionPrice (USD)
Per generation$0.01
2. Ideogram v2

Ideogram v2 Text to Image API Documentation

Request Code

POST https://gateway.pixazo.ai/ideogramV_2/v1/generate
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
    "image_request": {
        "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
        "negative_prompt": "blur",
        "model": "V_2",
        "aspect_ratio": "ASPECT_10_16",
        "magic_prompt_option": "AUTO",
        "seed": 212,
        "style_type": "AUTO",
        "color_palette": {
            "name": "JUNGLE"
        }
    }
}
import requests
import json

url = "https://gateway.pixazo.ai/ideogramV_2/v1/generate"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
    "image_request": {
        "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
        "negative_prompt": "blur",
        "model": "V_2",
        "aspect_ratio": "ASPECT_10_16",
        "magic_prompt_option": "AUTO",
        "seed": 212,
        "style_type": "AUTO",
        "color_palette": {
            "name": "JUNGLE"
        }
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
const url = 'https://gateway.pixazo.ai/ideogramV_2/v1/generate';
const headers = {
  'Content-Type': 'application/json',
  'Cache-Control': 'no-cache',
  'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
};

const data = {
  image_request: {
    prompt: 'A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.',
    negative_prompt: 'blur',
    model: 'V_2',
    aspect_ratio: 'ASPECT_10_16',
    magic_prompt_option: 'AUTO',
    seed: 212,
    style_type: 'AUTO',
    color_palette: {
      name: 'JUNGLE'
    }
  }
};

fetch(url, {
  method: 'POST',
  headers: headers,
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -v -X POST "https://gateway.pixazo.ai/ideogramV_2/v1/generate" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
--data-raw '{
    "image_request": {
        "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
        "negative_prompt": "blur",
        "model": "V_2",
        "aspect_ratio": "ASPECT_10_16",
        "magic_prompt_option": "AUTO",
        "seed": 212,
        "style_type": "AUTO",
        "color_palette": {
            "name": "JUNGLE"
        }
    }
}'

Output

{
  "created": "2024-11-01T10:06:14.744267+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A serene tropical beach scene...",
      "resolution": "800x1280",
      "seed": 212,
      "style_type": "REALISTIC",
      "url": "https://ideogram.ai/api/images/ephemeral/4p6cIwykSjaWcUUavtwuMw.png?exp=1730541994&sig=ef2b2872a29327783454a41061d1e890361cb6a5c77c358c6190793095428b59"
    }
  ]
}

Request Parameters - Create Image

Parameter Required Type Description
promptYesstringText describing the scene or image to be generated.
negative_promptNostringSpecifies elements or features to avoid in the image generation.
modelYesstringThe version of the model to use. Currently supported value: V_2.
aspect_ratioNoenumDetermines the image resolution. Default: ASPECT_1_1. Other values: ASPECT_10_16, ASPECT_16_10, ASPECT_9_16, ASPECT_16_9, ASPECT_3_2, ASPECT_2_3, ASPECT_4_3, ASPECT_3_4, ASPECT_1_1, ASPECT_1_3, ASPECT_3_1
seedNointegerProvides a random seed for reproducibility. Allowed range: 1 to 9999999999.
magic_prompt_optionNoenumControls use of MagicPrompt. Default: AUTO. Other values: ON, OFF.
style_typeNoenumSpecifies the style type for the image. Default: AUTO. Other values include GENERAL, REALISTIC, DESIGN, RENDER_3D, ANIME
color_paletteNoobjectDefines a color palette using a preset name. Available presets: EMBER, FRESH, JUNGLE, MAGIC, MELON, MOSAIC, PASTEL, ULTRAMARINE

Example Request

{
    "image_request": {
        "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
        "negative_prompt": "blur",
        "model": "V_2",
        "aspect_ratio": "ASPECT_10_16",
        "magic_prompt_option": "AUTO",
        "seed": 212,
        "style_type": "AUTO",
        "color_palette": {
            "name": "JUNGLE"
        }
    }
}

Response

{
    "created": "2024-11-01T10:06:14.744267+00:00",
    "data": [
        {
            "is_image_safe": true,
            "prompt": "A serene tropical beach scene with tall palm trees, a sandy beach, and azure waters...",
            "resolution": "800x1280",
            "seed": 212,
            "style_type": "REALISTIC",
            "url": "https://ideogram.ai/api/images/ephemeral/4p6cIwykSjaWcUUavtwuMw.png?exp=1730541994&sig=ef2b2872a29327783454a41061d1e890361cb6a5c77c358c6190793095428b59"
        }
    ]
}

Request Headers

Header Value
Content-Typeapplication/json
Cache-Controlno-cache
Ocp-Apim-Subscription-KeyYOUR_SUBSCRIPTION_KEY

Response Handling

Common status codes for Create Image.

Code Meaning
200 Success
Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
Too Many Requests
500 Internal Server Error

Ideogram v2 Text to Image API Pricing

ResolutionPrice (USD)
All Resolution$0.2

Ideogram v2 Utility (Image to Text — Captioning) API Documentation

Request Code

POST https://gateway.pixazo.ai/ideogramV_2/v1/describe
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
Content-Type: multipart/form-data

import requests

url = "https://gateway.pixazo.ai/ideogramV_2/v1/describe"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}

with open("/path/to/your/image.png", "rb") as image_file:
    files = {"image_file": image_file}
    response = requests.post(url, headers=headers, files=files)

print(response.json())
const formData = new FormData();
formData.append('image_file', fileInput.files[0]);

fetch('https://gateway.pixazo.ai/ideogramV_2/v1/describe', {
  method: 'POST',
  headers: {
    'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
  },
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -X POST "https://gateway.pixazo.ai/ideogramV_2/v1/describe" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
-H "Content-Type: multipart/form-data" \
--form 'image_file=@/path/to/your/image.png'

Output

{
  "created": "2024-11-01T10:06:14.744267+00:00",
  "data": {
    "description": "The image depicts a serene tropical beach..."
  }
}

Request Parameters - Describe Image

Parameter Required Type Description
image_fileYesFileThe image file for which a description is needed.

Example Request

--form 'image_file=@/path/to/your/image.png'

Response

{
  "created": "2024-11-01T10:06:14.744267+00:00",
  "data": {
    "description": "The image depicts a serene tropical beach scene with tall palm trees and azure waters."
  }
}

Request Headers

Header Value
Ocp-Apim-Subscription-KeyYOUR_SUBSCRIPTION_KEY
Content-Typemultipart/form-data

Response Handling

Common status codes for Describe Image.

Code Meaning
200 Success
Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
Too Many Requests
500 Internal Server Error

Ideogram v2 Utility (Image to Text — Captioning) API Pricing

ResolutionPrice (USD)
All Resolution$0.2

Ideogram v2 Image to Image (Image Editing) API Documentation

Request Code

POST https://gateway.pixazo.ai/ideogramV_2/v1/edit
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
Content-Type: multipart/form-data

import requests

url = "https://gateway.pixazo.ai/ideogramV_2/v1/edit"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
files = {
    "image_file": open("path/to/your/image.png", "rb"),
    "mask": open("path/to/your/mask.png", "rb"),
    "prompt": (None, "Enhance brightness and remove text"),
    "model": (None, "V_2")
}

response = requests.post(url, headers=headers, files=files)
print(response.json())
const formData = new FormData();
formData.append('image_file', document.getElementById('imageFile').files[0]);
formData.append('mask', document.getElementById('maskFile').files[0]);
formData.append('prompt', 'Enhance brightness and remove text');
formData.append('model', 'V_2');

fetch('https://gateway.pixazo.ai/ideogramV_2/v1/edit', {
  method: 'POST',
  headers: {
    'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
  },
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -X POST "https://gateway.pixazo.ai/ideogramV_2/v1/edit" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
-H "Content-Type: multipart/form-data" \
--form 'image_file=@/path/to/your/image.png' \
--form 'mask=@/path/to/your/mask.png' \
--form 'prompt="Enhance brightness and remove text"' \
--form 'model="V_2"'

Output

{
  "created": "2024-11-01T10:06:14.744267+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "Enhance brightness and remove text",
      "edited_image": "https://ideogram.ai/api/images/ephemeral/iSkGI5XfQ-ObReWhAiw_iA.png?exp=1730547982&sig=dabe41c3e4caa3ef788f32acc842cccfb2816686aab3e1a35d69d9139183fdc7"
    }
  ]
}

Request Parameters - Edit Image

Parameter Required Type Description
image_fileYesFileThe image file to be edited.
maskNoFileA mask file that determines which parts of the image will be affected by the transformation.
promptYesstringText description of the transformations to apply to the image.
modelYesstringThe version of the model to use for processing. Example: V_2.

Example Request

POST https://gateway.pixazo.ai/ideogramV_2/v1/edit
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
Content-Type: multipart/form-data

--boundary
Content-Disposition: form-data; name="image_file"; filename="image.png"
Content-Type: image/png

[File content]
--boundary
Content-Disposition: form-data; name="mask"; filename="mask.png"
Content-Type: image/png

[File content]
--boundary
Content-Disposition: form-data; name="prompt"
Content-Type: text/plain

Enhance brightness and remove text
--boundary
Content-Disposition: form-data; name="model"
Content-Type: text/plain

V_2
--boundary--

Response

{
  "created": "2024-11-01T10:06:14.744267+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "Enhance brightness and remove text",
      "original_image": "url_to_original_image",
      "edited_image": "https://ideogram.ai/api/images/ephemeral/iSkGI5XfQ-ObReWhAiw_iA.png?exp=1730547982&sig=dabe41c3e4caa3ef788f32acc842cccfb2816686aab3e1a35d69d9139183fdc7",
      "model_used": "V_2"
    }
  ]
}

Request Headers

Header Value
Ocp-Apim-Subscription-KeyYOUR_SUBSCRIPTION_KEY
Content-Typemultipart/form-data

Response Handling

Common status codes for Edit Image.

Code Meaning
200 Success
Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
Too Many Requests
500 Internal Server Error

Ideogram v2 Image to Image (Image Editing) API Pricing

ResolutionPrice (USD)
All Resolution$0.2

Ideogram v2 Image to Image (Image Editing — Remix) API Documentation

Request Code

POST https://gateway.pixazo.ai/ideogramV_2/v1/remix
Ocp-Apim-Subscription-Key: YOUR_Subscription_KEY
Content-Type: multipart/form-data

--boundary
Content-Disposition: form-data; name="image_request"

{"prompt":"A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.","aspect_ratio":"ASPECT_10_16","image_weight":50,"magic_prompt_option":"ON","model":"V_2"}
--boundary
Content-Disposition: form-data; name="image_file"; filename="image.png"
Content-Type: image/png

[Binary image data]
--boundary--
import requests

url = "https://gateway.pixazo.ai/ideogramV_2/v1/remix"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_Subscription_KEY"
}

files = {
    "image_request": (None, '{"prompt":"A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.","aspect_ratio":"ASPECT_10_16","image_weight":50,"magic_prompt_option":"ON","model":"V_2"}'),
    "image_file": ("image.png", open("/path/to/your/image.png", "rb"), "image/png")
}

response = requests.post(url, headers=headers, files=files)
print(response.json())
const formData = new FormData();
formData.append('image_request', '{"prompt":"A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.","aspect_ratio":"ASPECT_10_16","image_weight":50,"magic_prompt_option":"ON","model":"V_2"}');
formData.append('image_file', document.getElementById('imageInput').files[0]);

fetch('https://gateway.pixazo.ai/ideogramV_2/v1/remix', {
  method: 'POST',
  headers: {
    'Ocp-Apim-Subscription-Key': 'YOUR_Subscription_KEY'
  },
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -X POST "https://gateway.pixazo.ai/ideogramV_2/v1/remix" \
-H "Ocp-Apim-Subscription-Key: YOUR_Subscription_KEY" \
-H "Content-Type: multipart/form-data" \
--form 'image_request={
  "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
  "aspect_ratio": "ASPECT_10_16",
  "image_weight": 50,
  "magic_prompt_option": "ON",
  "model": "V_2"
}' \
--form 'image_file=@/path/to/your/image.png'

Output

{
  "created": "2024-11-01T10:06:14.744267+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A serene tropical beach scene...",
      "resolution": "800x1280",
      "image_url": "https://ideogram.ai/api/images/ephemeral/iSkGI5XfQ-ObReWhAiw_iA.png?exp=1730547982&sig=dabe41c3e4caa3ef788f32acc842cccfb2816686aab3e1a35d69d9139183fdc7"
    }
  ]
}

Request Parameters - Remix Image

Parameter Required Type Description
image_requestYesJSONA JSON string that includes details like prompt, aspect ratio, image weight, and model.
image_fileYesFileThe image file to be remixed with the textual description provided in `image_request`.

Example Request

{
  "image_request": "{\n  \"prompt\": \"A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.\",\n  \"aspect_ratio\": \"ASPECT_10_16\",\n  \"image_weight\": 50,\n  \"magic_prompt_option\": \"ON\",\n  \"model\": \"V_2\"\n}",
  "image_file": "[binary data]"
}

Response

{
  "created": "2024-11-01T10:06:14.744267+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
      "resolution": "800x1280",
      "image_weight": 50,
      "image_url": "https://ideogram.ai/api/images/ephemeral/iSkGI5XfQ-ObReWhAiw_iA.png?exp=1730547982&sig=dabe41c3e4caa3ef788f32acc842cccfb2816686aab3e1a35d69d9139183fdc7",
      "model_used": "V_2"
    }
  ]
}

Request Headers

Header Value
Ocp-Apim-Subscription-KeyYOUR_Subscription_KEY
Content-Typemultipart/form-data

Response Handling

Common status codes for Remix Image.

Code Meaning
200 Success
Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
Too Many Requests
500 Internal Server Error

Ideogram v2 Image to Image (Image Editing — Remix) API Pricing

ResolutionPrice (USD)
All Resolution$0.2
3. Ideogram Turbo

Ideogram Turbo Text to Image API Documentation

Request Code

POST https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/generate
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
    "image_request": {
        "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
        "negative_prompt": "blur",
        "model": "V_2_TURBO",
        "aspect_ratio": "ASPECT_10_16",
        "magic_prompt_option": "AUTO",
        "seed": 212,
        "style_type": "AUTO",
        "color_palette": {
            "name": "JUNGLE"
        }
    }
}
import requests

url = "https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/generate"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
    "image_request": {
        "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
        "negative_prompt": "blur",
        "model": "V_2_TURBO",
        "aspect_ratio": "ASPECT_10_16",
        "magic_prompt_option": "AUTO",
        "seed": 212,
        "style_type": "AUTO",
        "color_palette": {
            "name": "JUNGLE"
        }
    }
}

response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = 'https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/generate';
const headers = {
  'Content-Type': 'application/json',
  'Cache-Control': 'no-cache',
  'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
};
const data = {
  image_request: {
    prompt: 'A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.',
    negative_prompt: 'blur',
    model: 'V_2_TURBO',
    aspect_ratio: 'ASPECT_10_16',
    magic_prompt_option: 'AUTO',
    seed: 212,
    style_type: 'AUTO',
    color_palette: {
      name: 'JUNGLE'
    }
  }
};

fetch(url, {
  method: 'POST',
  headers: headers,
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -v -X POST "https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/generate" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
--data-raw '{
    "image_request": {
        "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
        "negative_prompt": "blur",
        "model": "V_2_TURBO",
        "aspect_ratio": "ASPECT_10_16",
        "magic_prompt_option": "AUTO",
        "seed": 212,
        "style_type": "AUTO",
        "color_palette": {
            "name": "JUNGLE"
        }
    }
}'

Output

{
  "created": "2024-11-01T10:06:14.744267+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A serene tropical beach scene...",
      "resolution": "800x1280",
      "url": "https://ideogram.ai/api/images/ephemeral/4p6cIwykSjaWcUUavtwuMw.png?exp=1730541994&sig=ef2b2872a29327783454a41061d1e890361cb6a5c77c358c6190793095428b59"
    }
  ]
}

Request Parameters - Create Image

Parameter Required Type Description
promptYesstringText describing the scene or image to be generated.
negative_promptNostringSpecifies elements or features to avoid in the image generation.
modelYesstringThe version of the model to use. Currently supported value: V_2_TURBO.
aspect_ratioNoenumDetermines the image resolution. Default: ASPECT_1_1. Other values: ASPECT_10_16, ASPECT_16_10, ASPECT_9_16, ASPECT_16_9, ASPECT_3_2, ASPECT_2_3, ASPECT_4_3, ASPECT_3_4, ASPECT_1_1, ASPECT_1_3, ASPECT_3_1
seedNointegerProvides a random seed for reproducibility. Allowed range: 1 to 9999999999.
magic_prompt_optionNoenumControls use of MagicPrompt. Default: AUTO. Other values: ON, OFF.
style_typeNoenumSpecifies the style type for the image. Default: AUTO. Other values include GENERAL, REALISTIC, DESIGN, RENDER_3D, ANIME
color_paletteNoobjectDefines a color palette using a preset name. Available presets: EMBER, FRESH, JUNGLE, MAGIC, MELON, MOSAIC, PASTEL, ULTRAMARINE

Example Request

{
    "image_request": {
        "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
        "negative_prompt": "blur",
        "model": "V_2_TURBO",
        "aspect_ratio": "ASPECT_10_16",
        "magic_prompt_option": "AUTO",
        "seed": 212,
        "style_type": "AUTO",
        "color_palette": {
            "name": "JUNGLE"
        }
    }
}

Response

{
    "created": "2024-11-01T10:06:14.744267+00:00",
    "data": [
        {
            "is_image_safe": true,
            "prompt": "A serene tropical beach scene with tall palm trees, a sandy beach, and azure waters...",
            "resolution": "800x1280",
            "seed": 212,
            "style_type": "REALISTIC",
            "url": "https://ideogram.ai/api/images/ephemeral/4p6cIwykSjaWcUUavtwuMw.png?exp=1730541994&sig=ef2b2872a29327783454a41061d1e890361cb6a5c77c358c6190793095428b59"
        }
    ]
}

Request Headers

Header Value
Content-Typeapplication/json
Cache-Controlno-cache
Ocp-Apim-Subscription-KeyYOUR_SUBSCRIPTION_KEY

Response Handling

Common status codes for Create Image.

Code Meaning
200 Success
Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
Too Many Requests
500 Internal Server Error

Ideogram Turbo Text to Image API Pricing

ResolutionPrice (USD)
All Resolution$0.2

Ideogram Turbo Utility (Image to Text — Captioning) API Documentation

Request Code

POST https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/describe
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
Content-Type: multipart/form-data

import requests

url = "https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/describe"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}

with open("/path/to/your/image.png", "rb") as image_file:
    files = {"image_file": image_file}
    response = requests.post(url, headers=headers, files=files)

print(response.json())
const formData = new FormData();
formData.append('image_file', fileInput.files[0]);

fetch('https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/describe', {
  method: 'POST',
  headers: {
    'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
  },
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -X POST "https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/describe" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
-H "Content-Type: multipart/form-data" \
--form 'image_file=@/path/to/your/image.png'

Output

{
  "created": "2024-11-01T10:06:14.744267+00:00",
  "data": {
    "description": "The image depicts a serene tropical beach scene..."
  }
}

Request Parameters - Describe Image

Parameter Required Type Description
image_fileYesFileThe image file for which a description is needed.

Example Request

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="image_file"; filename="image.png"
Content-Type: image/png

<binary image data>
------WebKitFormBoundary7MA4YWxkTrZu0gW--

Response

{
  "created": "2024-11-01T10:06:14.744267+00:00",
  "data": {
    "description": "The image depicts a serene tropical beach scene with tall palm trees and azure waters."
  }
}

Request Headers

Header Value
Ocp-Apim-Subscription-KeyYOUR_SUBSCRIPTION_KEY
Content-Typemultipart/form-data

Response Handling

Common status codes for Describe Image.

Code Meaning
200 Success
Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
Too Many Requests
500 Internal Server Error

Ideogram Turbo Utility (Image to Text — Captioning) API Pricing

ResolutionPrice (USD)
All Resolution$0.2

Ideogram Turbo Image to Image (Image Editing) API Documentation

Request Code

POST https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/edit
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
Content-Type: multipart/form-data

[form data]
import requests

url = "https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/edit"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}

files = {
    "image_file": open("image.png", "rb"),
    "mask": open("mask.png", "rb"),
    "prompt": (None, "Enhance brightness and remove text"),
    "model": (None, "V_2")
}

response = requests.post(url, headers=headers, files=files)
print(response.json())
const formData = new FormData();
formData.append('image_file', imageFileInput.files[0]);
formData.append('mask', maskFileInput.files[0]);
formData.append('prompt', 'Enhance brightness and remove text');
formData.append('model', 'V_2');

fetch('https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/edit', {
  method: 'POST',
  headers: {
    'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
  },
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -X POST "https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/edit" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
-H "Content-Type: multipart/form-data" \
--form 'image_file=@/path/to/your/image.png' \
--form 'mask=@/path/to/your/mask.png' \
--form 'prompt="Enhance brightness and remove text"' \
--form 'model="V_2"'

Output

{
  "created": "2024-11-01T11:46:02.294543+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "replace some text",
      "url": "https://ideogram.ai/api/images/ephemeral/...png"
    }
  ]
}

Request Parameters - Edit Image

Parameter Required Type Description
image_fileYesFileThe image file to be edited.
maskNoFileA mask file that determines which parts of the image will be affected by the transformation.
promptYesstringText description of the transformations to apply to the image.
modelYesstringThe version of the model to use for processing. Example: V_2.

Example Request

{}

Response

{
  "created": "2024-11-01T11:46:02.294543+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "replace some text",
      "resolution": "1216x704",
      "seed": 875575135,
      "style_type": "GENERAL",
      "url": "https://ideogram.ai/api/images/ephemeral/iSkGI5XfQ-ObReWhAiw_iA.png?exp=1730547982&sig=dabe41c3e4caa3ef788f32acc842cccfb2816686aab3e1a35d69d9139183fdc7"
    }
  ]
}

Request Headers

Header Value
Ocp-Apim-Subscription-KeyYOUR_SUBSCRIPTION_KEY
Content-Typemultipart/form-data

Response Handling

Common status codes for Edit Image.

Code Meaning
200 Success
Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
Too Many Requests
500 Internal Server Error

Ideogram Turbo Image to Image (Image Editing) API Pricing

ResolutionPrice (USD)
All Resolution$0.2

Ideogram Turbo Image to Image (Image Editing — Remix) API Documentation

Request Code

POST https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/remix
Ocp-Apim-Subscription-Key: YOUR_Subscription_KEY
Content-Type: multipart/form-data

--boundary
Content-Disposition: form-data; name="image_request"

{"prompt":"A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.","aspect_ratio":"ASPECT_10_16","image_weight":50,"magic_prompt_option":"ON","model":"V_2_TURBO"}
--boundary
Content-Disposition: form-data; name="image_file"; filename="image.png"
Content-Type: image/png

[binary data]
--boundary--
import requests

url = "https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/remix"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_Subscription_KEY"
}

files = {
    "image_request": (None, '{"prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.", "aspect_ratio": "ASPECT_10_16", "image_weight": 50, "magic_prompt_option": "ON", "model": "V_2_TURBO"}'),
    "image_file": ("image.png", open("/path/to/your/image.png", "rb"), "image/png")
}

response = requests.post(url, headers=headers, files=files)
print(response.json())
const formData = new FormData();
formData.append('image_request', JSON.stringify({
  prompt: "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
  aspect_ratio: "ASPECT_10_16",
  image_weight: 50,
  magic_prompt_option: "ON",
  model: "V_2_TURBO"
}));
formData.append('image_file', document.getElementById('imageInput').files[0]);

fetch('https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/remix', {
  method: 'POST',
  headers: {
    'Ocp-Apim-Subscription-Key': 'YOUR_Subscription_KEY'
  },
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -X POST "https://gateway.pixazo.ai/ideogramV_2_Turbo/v1/remix" \
-H "Ocp-Apim-Subscription-Key: YOUR_Subscription_KEY" \
-H "Content-Type: multipart/form-data" \
--form 'image_request={
  "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
  "aspect_ratio": "ASPECT_10_16",
  "image_weight": 50,
  "magic_prompt_option": "ON",
  "model": "V_2_TURBO"
}' \
--form 'image_file=@/path/to/your/image.png'

Output

{
  "created": "2000-01-23T04:56:07Z",
  "data": [
    {
      "prompt": "A serene tropical beach scene...",
      "resolution": "1024x1024",
      "is_image_safe": true,
      "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g"
    }
  ]
}

Request Parameters - Remix Image

Parameter Required Type Description
image_request Yes JSON A JSON string that includes details like prompt, aspect ratio, image weight, and model.
image_file Yes File The image file to be remixed with the textual description provided in `image_request`.

Example Request

{
  "image_request": "{\"prompt\": \"A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.\", \"aspect_ratio\": \"ASPECT_10_16\", \"image_weight\": 50, \"magic_prompt_option\": \"ON\", \"model\": \"V_2_TURBO\"}",
  "image_file": "[binary image data]"
}

Response

{
  "created": "2000-01-23T04:56:07Z",
  "data": [
    {
      "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there's an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
      "resolution": "1024x1024",
      "is_image_safe": true,
      "seed": 12345,
      "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g",
      "style_type": "REALISTIC"
    }
  ]
}

Request Headers

Header Value
Ocp-Apim-Subscription-Key YOUR_Subscription_KEY
Content-Type multipart/form-data

Response Handling

Common status codes for Remix Image.

Code Meaning
200 Success
Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
Too Many Requests
500 Internal Server Error

Ideogram Turbo Image to Image (Image Editing — Remix) API Pricing

ResolutionPrice (USD)
All Resolution$0.2