Zum Hauptinhalt springen

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.

Ideogram V3 Schnittstelle

Das Ideogram V3 Modell bietet erweiterte Funktionen zur Bildgenerierung und -verarbeitung. Die V3 Schnittstelle unterscheidet sich in Parametern und Verwendung von früheren Versionen. In diesem Abschnitt werden die V3 Schnittstellen und Anwendungsbeispiele ausführlich beschrieben.

V3 Generate

POST https://aihubmix.com/ideogram/v1/ideogram-v3/generate Generiert Bilder auf Grundlage der angegebenen Prompts. Das V3 Modell bietet eine höhere Bildqualität und unterstützt vielfältigere Stile und Parametersteuerungen.
prompt
string
erforderlich
Prompt für die Bildgenerierung
rendering_speed
string
Standard:"DEFAULT"
Optionen für die Rendering-Geschwindigkeit, verfügbar: TURBO, DEFAULT, QUALITY
num_images
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8
Die Generierung mehrerer Bilder verlängert die Generierungszeit nicht wesentlich
aspect_ratio
string
Standard:"1x1"
Seitenverhältnis für die Bildgenerierung, unterstützt eine breite Palette an Spezifikationen
Verfügbar: [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
Die in verschiedenen Modellen verwendeten Seitenverhältnisse unterscheiden sich.
magic_prompt
string
Standard:"AUTO"
Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
style_type
string
Standard:"AUTO"
Stiltyp für die Bildgenerierung, verfügbar: AUTO, GENERAL, REALISTIC, DESIGN
Hinweis: Im Vergleich zur V2-Version ist der Typ fokussierter
negative_prompt
string
Beschreibung der Inhalte, die nicht im Bild erscheinen sollen
seed
integer
Zufallsseed, Bereich: 0-2147483647
Verwenden Sie keinen Seed, wenn Sie mehrere Bilder generieren, da sonst dasselbe Bild erzeugt wird
style_reference_images
file
Stil-Referenzbild, kann zur Stilführung verwendet werden

Anwendungsbeispiele

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 Bilder auf Basis eines Referenzbildes und eines Prompts neu mischen. Die Remix-Funktion von V3 bewahrt Stil und Inhalt des Originalbildes besser.
prompt
string
erforderlich
Prompt für das Remixing von Bildern
image
file
erforderlich
Originalbilddatei
image_weight
integer
Standard:"50"
Die Gewichtung des Originalbildes, Bereich 1-100. Je größer der Wert, desto ähnlicher ist das Ergebnis dem Originalbild.
rendering_speed
string
Standard:"DEFAULT"
Optionen für die Rendering-Geschwindigkeit, verfügbar: TURBO, DEFAULT, QUALITY
num_images
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8 Die Generierung mehrerer Bilder verlängert die Generierungszeit nicht wesentlich
aspect_ratio
string
Seitenverhältnis des Ausgabebildes, verfügbar: [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
style_reference_images
file
Stil-Referenzbild, kann zur Stilführung verwendet werden
seed
integer
Zufallsseed, Bereich: 0-2147483647
magic_prompt
string
Standard:"AUTO"
Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
style_type
string
Standard:"AUTO"
Stiltyp für die Bildgenerierung, verfügbar: AUTO, GENERAL, REALISTIC, DESIGN
negative_prompt
string
Beschreibung der Inhalte, die nicht im Bild erscheinen sollen

Anwendungsbeispiele

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",
}

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

# files-Parameter initialisieren
files = None

# Pfad zum Stil-Referenzbild
style_reference_path = "yourpath/reference-image.png"
use_reference_image = True

# Dateien für den Upload vorbereiten
with open(source_image_path, "rb") as image_file:
    if use_reference_image and os.path.exists(style_reference_path):
        # Wenn ein Referenzbild verwendet wird und die Datei existiert, files-Parameter setzen
        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-***" # Ersetzen Sie dies durch Ihren AiHubMix API-Schlüssel
      },
      data=data,
      files=files
    )
print(response.json())

# Ausgabebild in Datei speichern
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 Die lokale Bearbeitungsfunktion von V3 ermöglicht es Benutzern, durch Bereitstellung des Originalbildes und einer Maske bestimmte Bereiche eines Bildes präzise zu bearbeiten, während andere Bereiche unverändert bleiben.
prompt
string
erforderlich
Prompt für die Bildbearbeitung
image
file
erforderlich
Originalbilddatei
mask
file
erforderlich
Maskenbild, schwarzer Bereich stellt den zu bearbeitenden Teil dar, weißer Bereich stellt den unveränderten Teil dar
rendering_speed
string
Standard:"DEFAULT"
Optionen für die Rendering-Geschwindigkeit, verfügbar: TURBO, DEFAULT, QUALITY
num_images
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8 Die Generierung mehrerer Bilder verlängert die Generierungszeit nicht wesentlich
aspect_ratio
string
Seitenverhältnis des Ausgabebildes, verfügbar: [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
seed
integer
Zufallsseed, Bereich: 0-2147483647
magic_prompt
string
Standard:"AUTO"
Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
style_type
string
Standard:"AUTO"
Stiltyp für die Bildgenerierung, verfügbar: AUTO, GENERAL, REALISTIC, DESIGN
negative_prompt
string
Beschreibung der Inhalte, die nicht im Bild erscheinen sollen

Anwendungsbeispiele

import requests
import os

# Originalbild - erforderlich
source_image_path = "yourpath/image.jpeg"
# Maske - erforderlich
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-***" # Ersetzen Sie dies durch Ihren AiHubMix API-Schlüssel
        },
        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())

# Ausgabebild in Datei speichern
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 Die Funktion zum Hintergrundaustausch von V3 erkennt intelligent Vorder- und Hintergrund eines Bildes und ersetzt den Hintergrund anhand des Prompts, während die Vordergrundobjekte unverändert bleiben.
prompt
string
erforderlich
Prompt für den Hintergrundaustausch
image
file
erforderlich
Originalbilddatei
rendering_speed
string
Standard:"DEFAULT"
Optionen für die Rendering-Geschwindigkeit, verfügbar: TURBO, DEFAULT, QUALITY
num_images
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8 Die Generierung mehrerer Bilder verlängert die Generierungszeit nicht wesentlich
style_reference_images
file
Stil-Referenzbild, kann zur Stilführung verwendet werden
seed
integer
Zufallsseed, Bereich: 0-2147483647
magic_prompt
string
Standard:"AUTO"
Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
style_type
string
Standard:"AUTO"
Stiltyp für die Bildgenerierung, verfügbar: AUTO, GENERAL, REALISTIC, DESIGN

Anwendungsbeispiele

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,
  # kein "aspect_ratio"
  "magic_prompt": "AUTO",
  "style_type": "AUTO",
  # kein "negative_prompt"
}

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

# files-Parameter initialisieren
files = None

# Pfad zum Stil-Referenzbild
style_reference_path = "yourpath/reference-image.png"
use_reference_image = True

# Dateien vorbereiten
with open(source_image_path, "rb") as image_file:
    if use_reference_image and os.path.exists(style_reference_path):
        # Wenn ein Referenzbild verwendet wird und die Datei existiert, files-Parameter setzen
        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-***" # Ersetzen Sie dies durch Ihren AiHubMix API-Schlüssel
      },
      data=data,
      files=files
    )
print(response.json())

# Ausgabebild in Datei speichern
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}")
Weitere optionale Parameter finden Sie unter Ideogram AI

💰 V3 Preisgestaltung

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

V2 & V1 Schnittstellenbeschreibung

Die Ideogram AI V2 & V1 Bildgenerierungs-Schnittstellen bieten leistungsstarke Text-to-Image-Fähigkeiten, einschließlich Generate-, Remix-, Edit-, Upscale- und Describe-Funktionen.
  • Remix: Erzeugt neue Bilder auf Basis eines Referenzbildes und eines Prompts.
  • Edit: Lokale Bearbeitung bestimmter Bereiche eines Referenzbildes mithilfe von Prompts und Masken.
  • Upscale: Erhöht niedrig aufgelöste Bilder auf hohe Auflösung, mit Kontrolle über Ähnlichkeit und Detailgrad.
  • Describe: Reverse-Engineering von Prompts zur Beschreibung von Bildern.
Unterstützte Stile:
  • AUTO: Standardmäßige automatische Auswahl
  • GENERAL: Allgemeiner Zweck
  • REALISTIC: Realistisch
  • DESIGN: Designorientiert
  • RENDER_3D: 3D-Rendering
  • ANIME: Anime-Stil
  1. Verfügbar über die offizielle AiHubMix API oder die Cherry Studio APP. Beachten Sie, dass derzeit ein Proxy für die Bildgenerierung erforderlich ist; eine Direktverbindung innerhalb Chinas wird in Zukunft unterstützt.
  2. Cherry Studio bietet derzeit nur die Ideogram-Bildgenerierungs-Schnittstelle (Generate) an.

Generate

POST https://aihubmix.com/ideogram/generate
Generiert synchron Bilder auf Basis der angegebenen Prompts und optionalen Parameter. Bild-Links haben eine begrenzte Gültigkeitsdauer; wenn Sie die Bilder behalten möchten, müssen Sie sie herunterladen und speichern.
Anfrageparameter
image_request
object
erforderlich
Anfrageobjekt für die Bildgenerierung
image_request.prompt
string
erforderlich
Prompt für die Bildgenerierung
image_request.aspect_ratio
string
Standard:"ASPECT_1_1"
Seitenverhältnis für die Bildgenerierung, bestimmt die Auflösung. Kann nicht zusammen mit dem Resolution-Parameter verwendet werden.Verfügbare Verhältnisse:
  • 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
Standard:"V_2"
Modell zum Generieren oder Bearbeiten von Bildern. /generate und /remix unterstützen alle Modelltypen, aber /edit unterstützt nur V_2 und V_2_TURBO.Verfügbare Modellversionen:
  • V_1
  • V_1_TURBO
  • V_2
  • V_2_TURBO
  • V_2A
  • V_2A_TURBO
image_request.magic_prompt_option
string
Standard:"AUTO"
Option zur Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
image_request.seed
integer
Zufallsseed, Bereich: 0-2147483647
image_request.style_type
string
Standard:"AUTO"
Stiltyp zur Bildgenerierung; dieser Parameter gilt nur für V_2 und höhere Modellversionen und sollte in V_1-Versionen nicht angegeben werden.Verfügbare Stile:
  • AUTO
  • GENERAL
  • REALISTIC
  • DESIGN
  • RENDER_3D
  • ANIME
image_request.negative_prompt
string
Beschreibt, was nicht im Bild erscheinen soll. Nur für die Modellversionen V_1, V_1_TURBO, V_2 und V_2_TURBO anwendbar. Beschreibungen im Prompt haben Vorrang vor Beschreibungen im Negative-Prompt.
image_request.num_images
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8
image_request.resolution
string
Auflösung für die Bildgenerierung (nur für Modellversion 2.0 anwendbar, kann nicht zusammen mit aspect_ratio verwendet werden), ausgedrückt als Breite x Höhe. Wenn nicht angegeben, wird standardmäßig aspect_ratio verwendet.

Beispielaufrufe

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())

Antwort

Bild(er) erfolgreich generiert.
{
  "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"
    }
  ]
}

Fehlercodes

  • 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 Bearbeitet synchron ein angegebenes Bild mithilfe der bereitgestellten Maske. Die Maske gibt an, welche Teile des Bildes bearbeitet werden sollen, während der Prompt und der ausgewählte Stiltyp die Bearbeitungsrichtung weiter leiten können. Unterstützte Bildformate sind JPEG, PNG und WebP. Bild-Links haben eine begrenzte Gültigkeitsdauer; wenn Sie die Bilder behalten möchten, müssen Sie sie herunterladen und speichern. Anfrageparameter
image_file
file
erforderlich
Originalbilddatei, unterstützt JPEG-, PNG- und WebP-Formate
mask
file
erforderlich
Maskenbild, muss folgende Anforderungen erfüllen:
  • Enthält nur schwarze und weiße Pixel, unterstützt RGB-, RGBA- oder Graustufen-Bildformate
  • Exakt die gleichen Abmessungen wie das Originalbild
  • Schwarze Bereiche stehen für Teile, die geändert werden sollen, weiße Bereiche stehen für Teile, die unverändert bleiben sollen
  • Darf nicht rein weiß sein
  • Der zu ändernde Bereich (schwarzer Teil) sollte mindestens 10 % der Bildfläche einnehmen
prompt
string
erforderlich
Prompt für die lokale Bearbeitung
model
string
erforderlich
Modell zum Generieren oder Bearbeiten von Bildern. /generate und /remix unterstützen alle Modelltypen, aber /edit unterstützt nur V_2 und V_2_TURBO.Verfügbare Modellversionen:
  • V_2
  • V_2_TURBO
magic_prompt_option
string
Standard:"AUTO"
Option zur Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
num_images
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8
seed
integer
Zufallsseed, Bereich: 0-2147483647
style_type
string
Standard:"AUTO"
Stiltyp zur Bildgenerierung; dieser Parameter gilt nur für V_2 und höhere Modellversionen.Verfügbare Stile:
  • AUTO
  • GENERAL
  • REALISTIC
  • DESIGN
  • RENDER_3D
  • ANIME

Beispielaufrufe

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()

# Datei schließen
files["image_file"].close()
files["mask"].close()

Antwort

Bildbearbeitungen erfolgreich generiert.
{
  "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"
    }
  ]
}

Fehlercodes

  • 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 Verschmilzt das bereitgestellte Bild mit den angegebenen Prompts und optionalen Parametern. Eingangsbilder werden vor dem Remixing auf das ausgewählte Seitenverhältnis zugeschnitten. Unterstützte Bildformate sind JPEG, PNG und WebP. Bild-Links haben eine begrenzte Gültigkeitsdauer; wenn Sie die Bilder behalten möchten, müssen Sie sie herunterladen und speichern. Anfrageparameter
image_request
object
erforderlich
Anfrage zum Generieren neuer Bilder unter Verwendung des bereitgestellten Bildes und Prompts. Das bereitgestellte Bild wird so zugeschnitten, dass es zum ausgewählten Ausgabe-Seitenverhältnis passt.
image_request.prompt
string
erforderlich
Prompt für die Bildgenerierung
image_request.aspect_ratio
string
Standard:"ASPECT_1_1"
Seitenverhältnis für die Bildgenerierung, bestimmt die Auflösung. Kann nicht zusammen mit dem Resolution-Parameter verwendet werden.Verfügbare Verhältnisse:
  • 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
Standard:"50"
Gewichtung des Referenzbildes, Bereich: 1-100
image_request.model
string
Standard:"V_2"
Modell zum Generieren oder Bearbeiten von Bildern. /generate und /remix unterstützen alle Modelltypen, aber /edit unterstützt nur V_2 und V_2_TURBO.
image_request.negative_prompt
string
Beschreibt, was nicht im Bild erscheinen soll. Nur für die Modellversionen V_1, V_1_TURBO, V_2 und V_2_TURBO anwendbar. Beschreibungen im Prompt haben Vorrang vor Beschreibungen im Negative-Prompt.
image_request.magic_prompt_option
string
Standard:"AUTO"
Option zur Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
image_request.num_images
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich: 1-8
image_request.resolution
string
Auflösung für die Bildgenerierung (nur für Modellversion 2.0 anwendbar, kann nicht zusammen mit aspect_ratio verwendet werden), ausgedrückt als Breite x Höhe. Wenn nicht angegeben, wird standardmäßig aspect_ratio verwendet.
image_request.seed
integer
Zufallsseed, Bereich: 0-2147483647
image_request.style_type
string
Standard:"AUTO"
Stiltyp für generierte Bilder; nur für V_2 und höhere Modellversionen anwendbar, sollte in V_1-Versionen nicht angegeben werden.Verfügbare Stile:
  • AUTO
  • GENERAL
  • REALISTIC
  • DESIGN
  • RENDER_3D
  • ANIME
image_file
file
erforderlich
Originalbilddatei, unterstützt JPEG-, PNG- und WebP-Formate

Beispielaufrufe

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())

Antwort

Bild(er) erfolgreich generiert.
{
  "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"
    }
  ]
}

Fehlercodes

  • 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 Skaliert das bereitgestellte Bild synchron mit optionalen Prompts hoch. Unterstützte Bildformate sind JPEG, PNG und WebP. Bild-Links haben eine begrenzte Gültigkeitsdauer; wenn Sie die Bilder behalten möchten, müssen Sie sie herunterladen und speichern. Anfrageparameter
image_request
object
erforderlich
Anfrageobjekt zum Hochskalieren des bereitgestellten Bildes mit optionalen Prompts
image_request.prompt
string
Optionaler Prompt zur Steuerung des Upscaling-Prozesses
image_request.resemblance
integer
Standard:"50"
Ähnlichkeit, Bereich: 1-100
image_request.detail
integer
Standard:"50"
Detail, Bereich: 1-100
image_request.magic_prompt_option
string
Standard:"AUTO"
Option zur Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
image_request.num_images
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich: 1-8
image_request.seed
integer
Zufallsseed, Bereich: 0-2147483647
image_file
file
erforderlich
Originalbilddatei, unterstützt JPEG-, PNG- und WebP-Formate

Beispielaufrufe

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())

Antwort

Bild(er) erfolgreich generiert.
{
  "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"
    }
  ]
}

Fehlercodes

  • 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 Analysiert und beschreibt das hochgeladene Bild. Unterstützte Bildformate sind JPEG, PNG und WebP. Anfrageparameter
image_file
file
erforderlich
Zu beschreibende Bilddatei, unterstützt JPEG-, PNG- und WebP-Formate

Beispielaufrufe

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())

# Datei schließen
files["image_file"].close()

Antwort

Beschreibung(en) erfolgreich erstellt.
{
  "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."
    }
  ]
}

Fehlercodes

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

💰 V2 & V1 Preisgestaltung

Bildgenerierung

ModellFunktionKosten pro Bild
2aText zu Bild oder Text + Referenzbild zu BildUS $0.04
2a TurboText zu Bild oder Text + Referenzbild zu Bild (schneller, aber geringfügig niedrigere Qualität)US $0.025
2.0Text zu Bild oder Text + Referenzbild zu BildUS $0.08
2.0 TurboText zu Bild oder Text + Referenzbild zu Bild (schneller, aber geringfügig niedrigere Qualität)US $0.05
1.0Text zu Bild oder Text + Referenzbild zu BildUS $0.06
1.0 TurboText zu Bild oder Text + Referenzbild zu Bild (schneller, aber geringfügig niedrigere Qualität)US $0.02

Bildbearbeitung

ModellFunktionKosten pro Bild
2.0 EditBilder mithilfe von Text-Prompts, Referenzbildern und binären Masken neu generierenUS $0.08
2.0 Turbo EditBilder mithilfe von Text-Prompts, Referenzbildern und binären Masken neu generieren (schneller, aber geringere Qualität)US $0.05

Bildverbesserung

ModellFunktionKosten pro Bild
UpscaleAuflösung des Referenzbildes um das 2-fache erhöhen, mögliche Verbesserung der QualitätUS $0.06

Weitere Details finden Sie in der offiziellen Dokumentation

Zuletzt aktualisiert: 2026-06-01