Skip to main content

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.
string
erforderlich
Prompt für die Bildgenerierung
string
Standard:"DEFAULT"
Optionen für die Rendering-Geschwindigkeit, verfügbar: TURBO, DEFAULT, QUALITY
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8
Die Generierung mehrerer Bilder verlängert die Generierungszeit nicht wesentlich
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.
string
Standard:"AUTO"
Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
string
Standard:"AUTO"
Stiltyp für die Bildgenerierung, verfügbar: AUTO, GENERAL, REALISTIC, DESIGN
Hinweis: Im Vergleich zur V2-Version ist der Typ fokussierter
string
Beschreibung der Inhalte, die nicht im Bild erscheinen sollen
integer
Zufallsseed, Bereich: 0-2147483647
Verwenden Sie keinen Seed, wenn Sie mehrere Bilder generieren, da sonst dasselbe Bild erzeugt wird
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.
string
erforderlich
Prompt für das Remixing von Bildern
file
erforderlich
Originalbilddatei
integer
Standard:"50"
Die Gewichtung des Originalbildes, Bereich 1-100. Je größer der Wert, desto ähnlicher ist das Ergebnis dem Originalbild.
string
Standard:"DEFAULT"
Optionen für die Rendering-Geschwindigkeit, verfügbar: TURBO, DEFAULT, QUALITY
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8 Die Generierung mehrerer Bilder verlängert die Generierungszeit nicht wesentlich
string
Seitenverhältnis des Ausgabebildes, verfügbar: [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
file
Stil-Referenzbild, kann zur Stilführung verwendet werden
integer
Zufallsseed, Bereich: 0-2147483647
string
Standard:"AUTO"
Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
string
Standard:"AUTO"
Stiltyp für die Bildgenerierung, verfügbar: AUTO, GENERAL, REALISTIC, DESIGN
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.
string
erforderlich
Prompt für die Bildbearbeitung
file
erforderlich
Originalbilddatei
file
erforderlich
Maskenbild, schwarzer Bereich stellt den zu bearbeitenden Teil dar, weißer Bereich stellt den unveränderten Teil dar
string
Standard:"DEFAULT"
Optionen für die Rendering-Geschwindigkeit, verfügbar: TURBO, DEFAULT, QUALITY
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8 Die Generierung mehrerer Bilder verlängert die Generierungszeit nicht wesentlich
string
Seitenverhältnis des Ausgabebildes, verfügbar: [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
integer
Zufallsseed, Bereich: 0-2147483647
string
Standard:"AUTO"
Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
string
Standard:"AUTO"
Stiltyp für die Bildgenerierung, verfügbar: AUTO, GENERAL, REALISTIC, DESIGN
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.
string
erforderlich
Prompt für den Hintergrundaustausch
file
erforderlich
Originalbilddatei
string
Standard:"DEFAULT"
Optionen für die Rendering-Geschwindigkeit, verfügbar: TURBO, DEFAULT, QUALITY
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8 Die Generierung mehrerer Bilder verlängert die Generierungszeit nicht wesentlich
file
Stil-Referenzbild, kann zur Stilführung verwendet werden
integer
Zufallsseed, Bereich: 0-2147483647
string
Standard:"AUTO"
Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
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.
  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
object
erforderlich
Anfrageobjekt für die Bildgenerierung
string
erforderlich
Prompt für die Bildgenerierung
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
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
string
Standard:"AUTO"
Option zur Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
integer
Zufallsseed, Bereich: 0-2147483647
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
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.
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8
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
file
erforderlich
Originalbilddatei, unterstützt JPEG-, PNG- und WebP-Formate
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
string
erforderlich
Prompt für die lokale Bearbeitung
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
string
Standard:"AUTO"
Option zur Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich 1-8
integer
Zufallsseed, Bereich: 0-2147483647
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
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.
string
erforderlich
Prompt für die Bildgenerierung
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
integer
Standard:"50"
Gewichtung des Referenzbildes, Bereich: 1-100
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.
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.
string
Standard:"AUTO"
Option zur Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich: 1-8
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.
integer
Zufallsseed, Bereich: 0-2147483647
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
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
object
erforderlich
Anfrageobjekt zum Hochskalieren des bereitgestellten Bildes mit optionalen Prompts
string
Optionaler Prompt zur Steuerung des Upscaling-Prozesses
integer
Standard:"50"
Ähnlichkeit, Bereich: 1-100
integer
Standard:"50"
Detail, Bereich: 1-100
string
Standard:"AUTO"
Option zur Prompt-Verbesserung. Verfügbare Parameter: AUTO, ON, OFF
integer
Standard:"1"
Anzahl der zu generierenden Bilder, Bereich: 1-8
integer
Zufallsseed, Bereich: 0-2147483647
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
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