Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt

Use this file to discover all available pages before exploring further.

Interfaz de Ideogram V3

El modelo Ideogram V3 ofrece capacidades avanzadas de generación y procesamiento de imágenes. La interfaz V3 se diferencia de las versiones anteriores en parámetros y uso. Esta sección detallará las interfaces V3 y los ejemplos de uso.

V3 Generate

POST https://aihubmix.com/ideogram/v1/ideogram-v3/generate Genera imágenes basadas en los prompts dados. El modelo V3 ofrece capacidades de generación de imágenes de mayor calidad, admitiendo estilos más diversos y controles de parámetros.
prompt
string
requerido
Prompt para la generación de la imagen
rendering_speed
string
predeterminado:"DEFAULT"
Opciones de velocidad de renderizado, disponibles TURBO, DEFAULT, QUALITY
num_images
integer
predeterminado:"1"
Número de imágenes a generar, rango 1-8
Generar más imágenes no aumentará significativamente el tiempo de generación
aspect_ratio
string
predeterminado:"1x1"
Relación de aspecto para la generación de la imagen; admite una amplia variedad de especificaciones
Disponibles [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
Las relaciones de aspecto utilizadas en distintos modelos son diferentes.
magic_prompt
string
predeterminado:"AUTO"
Mejora del prompt. Parámetros disponibles: AUTO, ON, OFF
style_type
string
predeterminado:"AUTO"
Tipo de estilo para la generación de imágenes, disponibles AUTO, GENERAL, REALISTIC, DESIGN
Nota: Comparado con la versión V2, el tipo está más enfocado
negative_prompt
string
Descripción del contenido que no quieres que aparezca en la imagen
seed
integer
Semilla aleatoria, rango: 0-2147483647
No utilices semilla al generar varias imágenes; de lo contrario, se generarán la misma imagen
style_reference_images
file
Imagen de referencia de estilo; puede usarse como guía estilística

Ejemplos de uso

curl -X POST https://aihubmix.com/ideogram/v1/ideogram-v3/generate \
  -H "Api-Key: sk-***" \
  -H "Content-Type: multipart/form-data" \
  -F prompt="Delicate 3D cover design with various combat machines flying from an portal. The machines have different shapes, sizes, and colors. The portal is emitting swirling energy. The background contains a futuristic city with tall buildings. The text \"One Gateway, Infinite Models\" is placed in the center with neon lights, expansive view, cinematic lighting, vivid color, bright tone. clean text, cyber punk, smooth render" \
  -F rendering_speed="QUALITY" \
  -F num_images="2" \
  -F aspect_ratio="2x1"

V3 Remix

POST https://aihubmix.com/ideogram/v1/ideogram-v3/remix Remixea imágenes basándose en una imagen de referencia y un prompt. La función Remix de V3 mantiene mejor el estilo y el contenido de la imagen original.
prompt
string
requerido
Prompt para el remix de la imagen
image
file
requerido
Archivo de imagen original
image_weight
integer
predeterminado:"50"
El peso de la imagen original, rango 1-100; cuanto mayor sea el valor, más parecido será el resultado a la imagen original.
rendering_speed
string
predeterminado:"DEFAULT"
Opciones de velocidad de renderizado, disponibles TURBO, DEFAULT, QUALITY
num_images
integer
predeterminado:"1"
Número de imágenes a generar, rango 1-8 Generar más imágenes no aumentará significativamente el tiempo de generación
aspect_ratio
string
Relación de aspecto de la imagen de salida, disponibles [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
style_reference_images
file
Imagen de referencia de estilo; puede usarse como guía estilística
seed
integer
Semilla aleatoria, rango: 0-2147483647
magic_prompt
string
predeterminado:"AUTO"
Mejora del prompt. Parámetros disponibles: AUTO, ON, OFF
style_type
string
predeterminado:"AUTO"
Tipo de estilo para la generación de imágenes, disponibles AUTO, GENERAL, REALISTIC, DESIGN
negative_prompt
string
Descripción del contenido que no quieres que aparezca en la imagen

Ejemplos de uso

import requests
import os

data = {
  "prompt": "bird playing with a cat in the snow, pixel art style",
  "image_weight": "60",
  "rendering_speed": "QUALITY",
  "num_images": 1,
  "seed": 1,
  "aspect_ratio": "16x9", 
  "magic_prompt": "AUTO",
  "style_type": "AUTO",
  "negative_prompt": "blurry, bad anatomy, watermark",
}

# Original image - required
source_image_path = "yourpath/image.jpeg"
if not os.path.exists(source_image_path):
    raise FileNotFoundError(f"Original image not found: {source_image_path}")

# initialize files parameter
files = None

# Style reference image path
style_reference_path = "yourpath/reference-image.png"
use_reference_image = True

# Prepare the files for upload
with open(source_image_path, "rb") as image_file:
    if use_reference_image and os.path.exists(style_reference_path):
        # If using a reference image and the file exists, set the files parameter
        files = {
            "image": image_file,
            "style_reference_images": open(style_reference_path, "rb"),
        }
    else:
        if use_reference_image:
            print(f"Warning: Style reference image not found: {style_reference_path}")
        files = {
            "image": image_file,
        }

    response = requests.post(
      "https://aihubmix.com/ideogram/v1/ideogram-v3/remix",
      headers={
        "Api-Key": "sk-***" # Replace with your AiHubMix API key
      },
      data=data,
      files=files
    )
print(response.json())

# save output image to file
response_json = response.json()
if response.ok and 'data' in response_json and len(response_json['data']) > 0:
    image_data = response_json['data'][0]['url']
    image_response = requests.get(image_data)
    if image_response.ok:
        with open('output.png', 'wb') as f:
            f.write(image_response.content)
        print("Image saved to output.png")
    else:
        print(f"Failed to get image: {image_response.status_code}")
else:
    print("API request failed or no image returned")
    print(f"Error details: {response_json}")

V3 Edit

POST https://aihubmix.com/ideogram/v1/ideogram-v3/edit La función de edición local de V3 permite a los usuarios editar con precisión áreas específicas de una imagen proporcionando la imagen original y una máscara, manteniendo las demás áreas sin cambios.
prompt
string
requerido
Prompt para la edición de la imagen
image
file
requerido
Archivo de imagen original
mask
file
requerido
Imagen de máscara; el área negra representa la parte a editar y el área blanca, la parte que se mantiene sin cambios
rendering_speed
string
predeterminado:"DEFAULT"
Opciones de velocidad de renderizado, disponibles TURBO, DEFAULT, QUALITY
num_images
integer
predeterminado:"1"
Número de imágenes a generar, rango 1-8 Generar más imágenes no aumentará significativamente el tiempo de generación
aspect_ratio
string
Relación de aspecto de la imagen de salida, disponibles [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
seed
integer
Semilla aleatoria, rango: 0-2147483647
magic_prompt
string
predeterminado:"AUTO"
Mejora del prompt. Parámetros disponibles: AUTO, ON, OFF
style_type
string
predeterminado:"AUTO"
Tipo de estilo para la generación de imágenes, disponibles AUTO, GENERAL, REALISTIC, DESIGN
negative_prompt
string
Descripción del contenido que no quieres que aparezca en la imagen

Ejemplos de uso

import requests
import os

# Original image - required
source_image_path = "yourpath/image.jpeg"
# mask - required
mask_image_path = "yourpath/mask.jpg"

if not os.path.exists(source_image_path):
    raise FileNotFoundError(f"Original image not found: {source_image_path}")

with open(source_image_path, "rb") as image_file, open(mask_image_path, "rb") as mask_file:
    response = requests.post(
        "https://aihubmix.com/ideogram/v1/ideogram-v3/edit",
        headers={
            "Api-Key": "sk-***" # Replace with your AiHubMix API key
        },
        data={
            "prompt": "remove text",
            "rendering_speed": "DEFAULT",
            "num_images": 1,
            "seed": 1,
            "aspect_ratio": "16x9",
            "magic_prompt": "AUTO",
            "style_type": "AUTO",
            "negative_prompt": "blurry, bad anatomy, watermark",
        },
        files={
            "image": image_file,
            "mask": mask_file,
        }
    )

print(response.json())

# save output image to file
response_json = response.json()
if response.ok and 'data' in response_json and len(response_json['data']) > 0:
    image_data = response_json['data'][0]['url']
    image_response = requests.get(image_data)
    if image_response.ok:
        with open('output.png', 'wb') as f:
            f.write(image_response.content)
        print("Image saved to output.png")
    else:
        print(f"Failed to get image: {image_response.status_code}")
else:
    print("API request failed or no image returned")
    print(f"Error details: {response_json}")

V3 Replace Background

POST https://aihubmix.com/ideogram/v1/ideogram-v3/replace-background La función de reemplazo de fondo de V3 puede identificar de forma inteligente el primer plano y el fondo de la imagen y reemplazar el fondo según el prompt, manteniendo intactos los objetos del primer plano.
prompt
string
requerido
Prompt para el reemplazo del fondo
image
file
requerido
Archivo de imagen original
rendering_speed
string
predeterminado:"DEFAULT"
Opciones de velocidad de renderizado, disponibles TURBO, DEFAULT, QUALITY
num_images
integer
predeterminado:"1"
Número de imágenes a generar, rango 1-8 Generar más imágenes no aumentará significativamente el tiempo de generación
style_reference_images
file
Imagen de referencia de estilo; puede usarse como guía estilística
seed
integer
Semilla aleatoria, rango: 0-2147483647
magic_prompt
string
predeterminado:"AUTO"
Mejora del prompt. Parámetros disponibles: AUTO, ON, OFF
style_type
string
predeterminado:"AUTO"
Tipo de estilo para la generación de imágenes, disponibles AUTO, GENERAL, REALISTIC, DESIGN

Ejemplos de uso

import requests
import os

data = {
  "prompt": "bird playing with a cat in the snow, pixel art style",
  "rendering_speed": "QUALITY",
  "num_images": 1,
  "seed": 1,
  # no "aspect_ratio"
  "magic_prompt": "AUTO",
  "style_type": "AUTO",
  # no "negative_prompt"
}

# Original image - required
source_image_path = "yourpath/image.png"
if not os.path.exists(source_image_path):
    raise FileNotFoundError(f"Original image not found: {source_image_path}")

# initialize files parameter
files = None

# Style reference image path
style_reference_path = "yourpath/reference-image.png"
use_reference_image = True

# Prepare files
with open(source_image_path, "rb") as image_file:
    if use_reference_image and os.path.exists(style_reference_path):
        # If using a reference image and the file exists, set the files parameter
        files = {
            "image": image_file,
            "style_reference_images": open(style_reference_path, "rb"),
        }
    else:
        if use_reference_image:
            print(f"Warning: Style reference image not found: {style_reference_path}")
        files = {
            "image": image_file,
        }

    response = requests.post(
      "https://aihubmix.com/ideogram/v1/ideogram-v3/replace-background",
      headers={
        "Api-Key": "sk-***" # Replace with your AiHubMix API key
      },
      data=data,
      files=files
    )
print(response.json())

# save output image to file
response_json = response.json()
if response.ok and 'data' in response_json and len(response_json['data']) > 0:
    image_data = response_json['data'][0]['url']
    image_response = requests.get(image_data)
    if image_response.ok:
        with open('output.png', 'wb') as f:
            f.write(image_response.content)
        print("Image saved to output.png")
    else:
        print(f"Failed to get image: {image_response.status_code}")
else:
    print("API request failed or no image returned")
    print(f"Error details: {response_json}")
Para más parámetros opcionales, consulta Ideogram AI

💰 Precios V3

Ideogram v3GenerateRemixEditReframeReplace BG
3.0 TurboUS $0.03US $0.03US $0.03US $0.03US $0.03
3.0 DefaultUS $0.06US $0.06US $0.06US $0.06US $0.06
3.0 QualityUS $0.09US $0.09US $0.09US $0.09US $0.09

Descripción de las interfaces V2 y V1

Las interfaces de dibujo de Ideogram AI V2 y V1 ofrecen sólidas capacidades de texto a imagen, incluidas las funciones generate, remix, edit, upscale y describe.
  • Remix: Crea imágenes nuevas basadas en una imagen de referencia y un prompt.
  • Edit: Realiza ediciones locales en áreas específicas de una imagen de referencia usando prompts y máscaras.
  • Upscale: Mejora imágenes de baja resolución a alta resolución, con control sobre la similitud y los niveles de detalle.
  • Describe: Ingeniería inversa de prompts para describir imágenes.
Estilos admitidos:
  • AUTO: Selección automática predeterminada
  • GENERAL: Uso general
  • REALISTIC: Realista
  • DESIGN: Orientado a diseño
  • RENDER_3D: Renderizado 3D
  • ANIME: Estilo anime
  1. Disponible a través de la API oficial de AiHubMix o la aplicación Cherry Studio. Ten en cuenta que actualmente se requiere un proxy para la generación de imágenes; la conexión directa dentro de China se admitirá en el futuro.
  2. Cherry Studio actualmente solo ofrece la interfaz de dibujo (generate) de Ideogram.

Generate

POST https://aihubmix.com/ideogram/generate
Genera imágenes de forma sincrónica basadas en los prompts dados y parámetros opcionales. Los enlaces de las imágenes tienen un periodo de validez limitado; si quieres conservar las imágenes, debes descargarlas y guardarlas.
Parámetros de la solicitud
image_request
object
requerido
Objeto de solicitud para la generación de la imagen
image_request.prompt
string
requerido
Prompt para la generación de la imagen
image_request.aspect_ratio
string
predeterminado:"ASPECT_1_1"
Relación de aspecto para la generación de la imagen, determina la resolución. No se puede usar junto con el parámetro resolution.Relaciones disponibles:
  • 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
image_request.model
string
predeterminado:"V_2"
Modelo para generar o editar imágenes. /generate y /remix admiten todos los tipos de modelo, pero /edit solo admite V_2 y V_2_TURBO.Versiones de modelo disponibles:
  • V_1
  • V_1_TURBO
  • V_2
  • V_2_TURBO
  • V_2A
  • V_2A_TURBO
image_request.magic_prompt_option
string
predeterminado:"AUTO"
Opción de mejora del prompt. Parámetros disponibles: AUTO, ON, OFF
image_request.seed
integer
Semilla aleatoria, rango: 0-2147483647
image_request.style_type
string
predeterminado:"AUTO"
Tipo de estilo utilizado para generar imágenes; este parámetro solo se aplica a las versiones V_2 y superiores del modelo y no debe especificarse en las versiones V_1.Estilos disponibles:
  • AUTO
  • GENERAL
  • REALISTIC
  • DESIGN
  • RENDER_3D
  • ANIME
image_request.negative_prompt
string
Describe lo que no quieres que aparezca en la imagen. Solo se aplica a las versiones de modelo V_1, V_1_TURBO, V_2 y V_2_TURBO. Las descripciones en el prompt tienen prioridad sobre las descripciones en el negative prompt.
image_request.num_images
integer
predeterminado:"1"
Número de imágenes a generar, rango 1-8
image_request.resolution
string
Resolución para la generación de la imagen (solo aplicable a la versión 2.0 del modelo, no se puede usar junto con aspect_ratio), expresada como ancho x alto. Si no se especifica, se usará aspect_ratio por defecto.

Ejemplos de llamada

import requests
import os

url = "https://aihubmix.com/ideogram/generate"

payload = { "image_request": {
        "prompt": "3D cartoon, An adorable white owl baby with tilted head, shiny amber eyes with highlight, fluffy body, standing on a trunk with moss and lots of glowing mushrooms, Close up, cinematic lighting, low angle, deep sense of depth. The background is a magical spring landscape, cute and esthetic, huge title design \"Always curious\"", #string optional
        "negative_prompt": "blurry, bad anatomy, watermark",
        "aspect_ratio": "ASPECT_3_2",  # optional include ASPECT_1_1(Default), 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": "V_2",
        "num_images": 2, #integer optional >=1 <=8 Defaults to 1
        "magic_prompt_option": "AUTO", #string optional AUTO, ON, OFF
        #"seed": "2" #integer optional >=0 <=2147483647
        "style_type": "RENDER_3D" #string optional AUTO/GENERAL/REALISTIC/DESIGN/RENDER_3D/ANIME, only applicable to V_2 and above
    } }
headers = {
    "Api-Key": os.getenv("AIHUBMIX_API_KEY"),
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

Respuesta

Imagen(es) generada(s) correctamente.
{
  "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"
    }
  ]
}

Códigos de error

  • 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 Edita de forma sincrónica una imagen especificada utilizando la máscara proporcionada. La máscara indica qué partes de la imagen se deben editar, mientras que el prompt y el tipo de estilo seleccionado pueden guiar aún más la dirección de la edición. Los formatos de imagen admitidos incluyen JPEG, PNG y WebP. Los enlaces de las imágenes tienen un periodo de validez limitado; si quieres conservarlas, debes descargarlas y guardarlas. Parámetros de la solicitud
image_file
file
requerido
Archivo de imagen original; admite formatos JPEG, PNG y WebP
mask
file
requerido
Imagen de máscara que debe cumplir los siguientes requisitos:
  • Contiene únicamente píxeles en blanco y negro, admite formatos de imagen RGB, RGBA o en escala de grises
  • Tiene exactamente las mismas dimensiones que la imagen original
  • Las áreas negras representan las partes que deben modificarse y las áreas blancas las partes que deben permanecer sin cambios
  • No puede ser totalmente blanca
  • El área modificada (parte negra) debe ocupar al menos el 10 % del área de la imagen
prompt
string
requerido
Prompt para la edición local
model
string
requerido
Modelo para generar o editar imágenes. /generate y /remix admiten todos los tipos de modelo, pero /edit solo admite V_2 y V_2_TURBO.Versiones de modelo disponibles:
  • V_2
  • V_2_TURBO
magic_prompt_option
string
predeterminado:"AUTO"
Opción de mejora del prompt. Parámetros disponibles: AUTO, ON, OFF
num_images
integer
predeterminado:"1"
Número de imágenes a generar, rango 1-8
seed
integer
Semilla aleatoria, rango: 0-2147483647
style_type
string
predeterminado:"AUTO"
Tipo de estilo utilizado para generar imágenes; este parámetro solo se aplica a las versiones V_2 y superiores del modelo.Estilos disponibles:
  • AUTO
  • GENERAL
  • REALISTIC
  • DESIGN
  • RENDER_3D
  • ANIME

Ejemplos de llamada

import requests
import os

url = "https://aihubmix.com/ideogram/eidt"

files = {
    "image_file": open('<file1>', 'rb'), #required
    "mask": "open('<file1>', 'rb')" #required
}

payload = {
    "prompt": "\"prompt\"", #required
    "model": "V_2",  #required, only supported for V_2 and V_2_TURBO.
    "magic_prompt_option": ,
    "num_images":1, #integer optional >=1 <=8 Defaults to 1
    "seed": , #integer optional >=0 <=2147483647
    "style_type":
16}
headers = {"Api-Key": os.getenv("AIHUBMIX_API_KEY")}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.json()

# close file
files["image_file"].close()
files["mask"].close()

Respuesta

Ediciones de imagen generadas correctamente.
{
  "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"
    }
  ]
}

Códigos de error

  • 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 Fusiona la imagen proporcionada con los prompts dados y parámetros opcionales. Las imágenes de entrada se recortan a la relación de aspecto seleccionada antes del remix. Los formatos de imagen admitidos incluyen JPEG, PNG y WebP. Los enlaces de las imágenes tienen un periodo de validez limitado; si quieres conservarlas, debes descargarlas y guardarlas. Parámetros de la solicitud
image_request
object
requerido
Solicitud para generar nuevas imágenes usando la imagen y el prompt proporcionados. La imagen proporcionada se recortará para coincidir con la relación de aspecto de salida seleccionada.
image_request.prompt
string
requerido
Prompt para la generación de la imagen
image_request.aspect_ratio
string
predeterminado:"ASPECT_1_1"
Relación de aspecto para la generación de la imagen, determina la resolución. No se puede usar junto con el parámetro resolution.Relaciones disponibles:
  • 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
image_request.image_weight
integer
predeterminado:"50"
Peso de la imagen de referencia, rango: 1-100
image_request.model
string
predeterminado:"V_2"
Modelo para generar o editar imágenes. /generate y /remix admiten todos los tipos de modelo, pero /edit solo admite V_2 y V_2_TURBO.
image_request.negative_prompt
string
Describe lo que no quieres que aparezca en la imagen. Solo se aplica a las versiones de modelo V_1, V_1_TURBO, V_2 y V_2_TURBO. Las descripciones en el prompt tienen prioridad sobre las descripciones en el negative prompt.
image_request.magic_prompt_option
string
predeterminado:"AUTO"
Opción de mejora del prompt. Parámetros disponibles: AUTO, ON, OFF
image_request.num_images
integer
predeterminado:"1"
Número de imágenes a generar, rango: 1-8
image_request.resolution
string
Resolución para la generación de la imagen (solo aplicable a la versión 2.0 del modelo, no se puede usar junto con aspect_ratio), expresada como ancho x alto. Si no se especifica, se usará aspect_ratio por defecto.
image_request.seed
integer
Semilla aleatoria, rango: 0-2147483647
image_request.style_type
string
predeterminado:"AUTO"
Tipo de estilo para las imágenes generadas; solo se aplica a las versiones V_2 y superiores del modelo, no debe especificarse en las versiones V_1.Estilos disponibles:
  • AUTO
  • GENERAL
  • REALISTIC
  • DESIGN
  • RENDER_3D
  • ANIME
image_file
file
requerido
Archivo de imagen original; admite formatos JPEG, PNG y WebP

Ejemplos de llamada

import requests
import os

url = "https://aihubmix.com/ideogram/remix"

files = { "image_file": open('<file1>', 'rb') }
payload = {"image_request": '''{
    "prompt": "watercolor",
    "aspect_ratio": "ASPECT_10_16",
    "image_weight": 50,
    "magic_prompt_option": "ON",
    "model": "V_2"
}'''}

headers = {"Api-Key": os.getenv("AIHUBMIX_API_KEY")}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.json())

Respuesta

Imagen(es) generada(s) correctamente.
{
  "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"
    }
  ]
}

Códigos de error

  • 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 Aumenta de forma sincrónica la resolución de la imagen proporcionada con prompts opcionales. Los formatos de imagen admitidos incluyen JPEG, PNG y WebP. Los enlaces de las imágenes tienen un periodo de validez limitado; si quieres conservarlas, debes descargarlas y guardarlas. Parámetros de la solicitud
image_request
object
requerido
Objeto de solicitud para aumentar la resolución de la imagen proporcionada con prompts opcionales
image_request.prompt
string
Prompt opcional para guiar el proceso de aumento de resolución
image_request.resemblance
integer
predeterminado:"50"
Similitud, rango: 1-100
image_request.detail
integer
predeterminado:"50"
Detalle, rango: 1-100
image_request.magic_prompt_option
string
predeterminado:"AUTO"
Opción de mejora del prompt. Parámetros disponibles: AUTO, ON, OFF
image_request.num_images
integer
predeterminado:"1"
Número de imágenes a generar, rango: 1-8
image_request.seed
integer
Semilla aleatoria, rango: 0-2147483647
image_file
file
requerido
Archivo de imagen original; admite formatos JPEG, PNG y WebP

Ejemplos de llamada

import requests
import os

url = "https://aihubmix.com/ideogram/upscale"

files = { "image_file": open('<file1>', 'rb') }
payload = { "image_request": "{}" }
headers = {"Api-Key": os.getenv("AIHUBMIX_API_KEY")}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.json())

Respuesta

Imagen(es) generada(s) correctamente.
{
  "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"
    }
  ]
}

Códigos de error

  • 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 Analiza y describe la imagen subida. Los formatos de imagen admitidos incluyen JPEG, PNG y WebP. Parámetros de la solicitud
image_file
file
requerido
Archivo de imagen a describir; admite formatos JPEG, PNG y WebP

Ejemplos de llamada

import requests
import os

url = "https://aihubmix.com/ideogram/describe"

files = { "image_file": open('<file1>', 'rb') }
headers = {"Api-Key": os.getenv("AIHUBMIX_API_KEY")}

response = requests.post(url, files=files, headers=headers)

print(response.json())

# close file
files["image_file"].close()

Respuesta

Descripción(es) creada(s) correctamente.
{
  "descriptions": [
    {
      "text": "A meticulously illustrated cat with striped patterns, sitting upright. The cat's eyes are a captivating shade of yellow, and it appears to be gazing intently at something. The background consists of abstract, swirling patterns in shades of black, white, and beige, creating an almost fluid or wavy appearance. The cat is positioned in the foreground, with the background elements fading into the distance, giving a sense of depth to the image."
    },
    {
      "text": "A meticulously illustrated cat with striped patterns, sitting upright. The cat's eyes are a captivating shade of yellow, and it appears to be gazing intently at something. The background consists of abstract, swirling patterns in shades of black, white, and beige, creating an almost fluid or wavy appearance. The cat is positioned in the foreground, with the background elements fading into the distance, giving a sense of depth to the image."
    }
  ]
}

Códigos de error

  • 400 : Post Describe Request Bad Request Error
  • 422 : Post Describe Request Unprocessable Entity Error
  • 429 : Post Describe Request Too Many Requests Error

💰 Precios de V2 y V1

Generación de imágenes

ModeloFunciónCoste por imagen
2aTexto a imagen, o texto + imagen de referencia a imagenUS $0.04
2a TurboTexto a imagen, o texto + imagen de referencia a imagen (más rápido pero con calidad ligeramente inferior)US $0.025
2.0Texto a imagen, o texto + imagen de referencia a imagenUS $0.08
2.0 TurboTexto a imagen, o texto + imagen de referencia a imagen (más rápido pero con calidad ligeramente inferior)US $0.05
1.0Texto a imagen, o texto + imagen de referencia a imagenUS $0.06
1.0 TurboTexto a imagen, o texto + imagen de referencia a imagen (más rápido pero con calidad ligeramente inferior)US $0.02

Edición de imágenes

ModeloFunciónCoste por imagen
2.0 EditRegenera imágenes usando prompts de texto, imágenes de referencia y máscaras binariasUS $0.08
2.0 Turbo EditRegenera imágenes usando prompts de texto, imágenes de referencia y máscaras binarias (más rápido pero con calidad ligeramente inferior)US $0.05

Mejora de imágenes

ModeloFunciónCoste por imagen
UpscaleAumenta la resolución de la imagen de referencia 2x, mejorando potencialmente la calidadUS $0.06

Para más detalles, consulta la documentación oficial

Última actualización: 2026-06-01