Zum Hauptinhalt springen

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

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

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

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

Weitere optionale Parameter finden Sie unter Ideogram AI

💰 V3 Preisgestaltung


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

Antwort

Bild(er) erfolgreich generiert.

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

Antwort

Bildbearbeitungen erfolgreich generiert.

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

Antwort

Bild(er) erfolgreich generiert.

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

Antwort

Bild(er) erfolgreich generiert.

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

Antwort

Beschreibung(en) erfolgreich erstellt.

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

Bildbearbeitung

Bildverbesserung

Weitere Details finden Sie in der offiziellen Dokumentation

Zuletzt aktualisiert: 2026-06-01