Source: https://ailoot.ai/models/de-at/tencent-hy-image-v3-5-preview/ Canonical: https://ailoot.ai/models/de-at/tencent-hy-image-v3-5-preview/ Language: de-at # Tencent: Hy Image 3.5 Preview [Markdown](https://ailoot.ai/models/de-at/tencent-hy-image-v3-5-preview/index.md) · [JSON](https://ailoot.ai/models/de-at/tencent-hy-image-v3-5-preview/facts.json) ## [Tencent: Hy Image 3.5 Preview](https://ailoot.ai/models/de-at/tencent-hy-image-v3-5-preview/) HY Image 3.5 Preview verbindet Text-zu-Bild-Generierung, referenzbasierte Bilderstellung und Bearbeitung über mehrere Gesprächsrunden. Tencent dokumentiert bis zu 20 Referenzbilder, automatische Größenwahl und ausdrückliche Ausgabegrößen bis zu einem Bild mit 4096 × 4096 Pixeln für detailreiche visuelle Arbeit. - [**Ailoot Ultra · Bilder** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/de-at/tencent-hy-image-v3-5-preview/#method-0) Über das Modell Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt. HY Image 3.5 Preview ist Tencents einheitliches Modell für Bildgenerierung und -bearbeitung. Es akzeptiert ein schriftliches Briefing mit optionalen Referenzbildern und unterstützt die Fortsetzung derselben visuellen Aufgabe über mehrere Gesprächsrunden. Das Ergebnis ist ein Bild für eine festgelegte Szene, Komposition oder Bearbeitung. Tencents Beispiele umfassen Produktbilder, Kampagnenplakate, Visualisierungen von Oberflächendesigns und Materialkonzepte. Entscheiden Sie, ob die Aufgabe ein neues Bild, eine von Referenzen geprägte Komposition oder eine gezielte Änderung an einem vorhandenen Ergebnis benötigt. Der Hersteller bezeichnet die Ausgabe als hy-image-v3.5-preview und dokumentiert eine Promptgrenze von 100K Token. Die Eingabe ist ein chronologischer Gesprächsverlauf mit Text und Bildern; die letzte Nutzernachricht liefert die aktuelle Anweisung. Frühere Nachrichten geben Kontext für iterative Bearbeitungen. Das unterscheidet sich vom Ablauf mit einem einzelnen Prompt bei HY Image 3.0 und dessen eigenen Eingabegrenzen. Bewahren Sie bei einer fortlaufenden Designaufgabe das relevante Briefing, die Referenzrollen und das ausgewählte Bild auf, damit die nächste Anweisung auf dem beabsichtigten visuellen Stand aufbauen kann. Bereiten Sie PNG- oder JPEG/JPG-Referenzbilder vor. Referenzeingaben können im dokumentierten Ablauf bis zu 20 Bilder enthalten, jeweils mit höchstens 20 MB. Ein Bild kann als referenziertes oder kodiertes Asset bereitgestellt werden. Wenn das Gespräch zu viele Bilder enthält, werden laut Herstellerleitfaden zuerst ältere Bilder aus dem Kontext entfernt. Halten Sie die aktive Referenzauswahl gezielt, statt darauf zu vertrauen, dass jedes historische Bild im Kontext bleibt. Die Steuerung zur Eingabegrößenanpassung erhält kleinere Bilder und skaliert größere proportional auf eine Ziel-Pixelfläche; der Standardzielwert beträgt 1.048.576 Pixel. Erhalten Sie ausreichend sichtbare Details für das Produkt, Material oder Layout, das das Ergebnis lenken soll. Für die Ausgabegröße gibt es zwei getrennte Vorbereitungswege. Bei automatischer Größenwahl legt generate\_max\_pixels eine Zielfläche fest: 1.048.576 Pixel für die 1K-Stufe, 2.359.296 für die standardmäßige 1.5K-Stufe oder 4.194.304 für 2K. Laut Hersteller-FAQ wird bei alleiniger Angabe einer Zielfläche standardmäßig ein quadratisches Seitenverhältnis verwendet. Werden beide Größensteuerungen weggelassen, verwendet das Modell das Briefing und die Standardstufe 1.5K. Diese Stufen erzeugen keine automatische 4K-Einstellung. Verwenden Sie eine Flächenstufe, wenn ein quadratisches Bild zur Aufgabe passt. Lassen Sie beide Größensteuerungen weg, damit das Briefing die Proportionen auf der Standardstufe 1.5K vorgibt; fordern Sie ausdrückliche Abmessungen an, wenn das Layout eine bestimmte Hoch- oder Breitformatgröße benötigt. Bei ausdrücklichen Abmessungen erlaubt der Hersteller positive ganzzahlige Seitenlängen von 256 bis 8192 Pixeln bei einer Gesamtfläche von höchstens 16.777.216 Pixeln. Ein Quadrat von 4096 × 4096 erfüllt diese Grenze. Seitenbereich und Flächenobergrenze gelten gemeinsam; eine Kante mit 8192 Pixeln erlaubt daher kein Bild mit 8192 × 8192 Pixeln. Fordern Sie die erforderliche Breite und Höhe ausdrücklich an, wenn das fertige Layout eine bestimmte Größe benötigt, statt anzunehmen, dass eine Zielflächenstufe dieselben Abmessungen bestimmt. Halten Sie beschnittempfindliche Details und den erforderlichen Freiraum im Prompt fest. Das Modell unterstützt Bearbeitung über mehrere Gesprächsrunden anhand des zurückgegebenen Gesprächsverlaufs. Tencent unterscheidet zwischen dem fertig ausgelieferten Bild und dem Zwischenbild, das als Kontext für die nächste Bearbeitung dient. Die Beispiele behalten bei der Fortsetzung die Überlegungen des Assistenten, die Werkzeuganfrage und das generierte Bildergebnis bei. Legen Sie bei einer Produktkomposition zuerst Motiv und Bildausschnitt fest und bitten Sie danach um eine Änderung der Beleuchtung oder einen neuen Hintergrund, wobei Sie angeben, was sein Erscheinungsbild behalten soll. Bewahren Sie das ausgewählte Ergebnis gemeinsam mit seinem Verlauf auf, damit die nächste Runde dieses Bild und keine verworfene Variante bearbeitet. Im dokumentierten Tencent-Ablauf laufen sowohl die Links zum fertigen Bild als auch jene zum Verlaufsbild nach 12 Stunden ab; sichern Sie daher die Bildassets, bevor Sie sich für eine spätere Bearbeitung darauf verlassen. Zu den dokumentierten Steuerelementen gehören ein Seed, eine benutzerdefinierte Wasserzeichen-Fußnote mit bis zu 16 Zeichen und optionale Unterstützung durch externe Suche, die standardmäßig deaktiviert ist. Der Seed ist eine nicht negative Ganzzahl; bei null oder Weglassen wählt der Hersteller zufällig. Diese Steuerelemente dienen anderen Zwecken als das Briefing selbst. Beschreiben Sie für ein referenzbasiertes Produktmotiv das Aussehen des Produkts, Kamerawinkel, Untergrund, Beleuchtung und geplantes Layout und verwenden Sie anschließend die Referenz zur Vorgabe der identifizierenden Details. Geben Sie für ein Plakat Hierarchie und exakten Wortlaut an, statt die Aussage erfinden zu lassen. Tencents praktische Hinweise empfehlen, Text und Layout zu kontrollieren, besonders dort, wo Produktspezifikationen, Organisationsnamen oder andere sachliche Formulierungen wichtig sind. Prüfen Sie das fertige Bild auf Motiv, Proportionen, Material, Beschnitt und Schrift. Bewahren Sie das fertige Asset gemeinsam mit Briefing und Einstellungen auf und verwenden Sie für die nächste Bearbeitung eine konkrete Anweisung, die an ein sichtbares Problem anknüpft. **Ailoot Ultra · Bilder** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview` [`tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/de-at/#m=tencent%2Fhy-image-v3.5-preview&route=Ultra&caller=tencent%2Fhy-image-v3.5-preview&fmt=images) Tencent /`tencent/hy-image-v3.5-preview` ### Einstieg HY Image 3.5 Preview verbindet Text-zu-Bild-Generierung, referenzbasierte Bilderstellung und Bearbeitung über mehrere Gesprächsrunden. Tencent dokumentiert bis zu 20 Referenzbilder, automatische Größenwahl und ausdrückliche Ausgabegrößen bis zu einem Bild mit 4096 × 4096 Pixeln für detailreiche visuelle Arbeit. Zulässige Eingaben Text · Bilder Ergebnisse Bilder ### In Ailoot verfügbar · Eingaben und Methoden **Ailoot Ultra · Bilder** `POST /v1/images/generations` Eingabe `text`, `image` Ausgabe `image` | Feld | Typ | Anforderung | Werte und Limits | Standard | | --- | --- | --- | --- | --- | | Feld`model` | Typ`string` | AnforderungErforderlich | Werte und Limits tencent/hy-image-v3.5-preview | Standard— | | Feld`prompt` | Typ`string` | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— | | Feld`resolution` | Typ`string` | AnforderungOptional | Werte und Limits 1K, 1.5K, 2K, 4K | Standard— | | Feld`aspect_ratio` | Typ`string` | AnforderungOptional | Werte und Limits 1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9 | Standard— | | Feld`n` | Typ`integer` | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 1 | Standard— | | Feld`input_references` | Typ`array` | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 20 | Standard— | | Feld`provider` | Typ`object` | AnforderungOptional | Werte und Limits | Standard— | Methodenparameter und Lebenszyklus | Parameter | Vertrag | | --- | --- | | Parameter`content_type` | Vertragapplication/json | | Parameter`required` | Vertragmodel, prompt | | Parameter`material_types` | Vertragtext, image | Lebenszyklus: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · die tatsächlich zurückgegebene task\_id oder ein Eintrag in der Medienbibliothek `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Tarife ##### So wird die endgültige Gebühr berechnet Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge. Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode. Schnellmodus Nicht angegeben Wenn der Schnellmodus ausgewählt ist Flex-Modus Nicht angegeben Wenn der Modus flex ausgewählt ist Maximaler Denkaufwand Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird #### Geschätzte Tarife zum Vergleich #### Preise nach Konfiguration Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif. | Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungseinheit | Gebühr | | --- | --- | --- | --- | --- | | KonfigurationBasistarife für Tokens | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich **—** / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich **—** / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich **—** / 1K Tokens Eingabe · In Cache schreiben · Schätzung nur zum Vergleich **—** / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich **—** / 1K Tokens | | KonfigurationBildausgabetoken | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheit/ 1K Bild-Tokens | Gebühr Ausgabe · Bildausgabetoken · Schätzung nur zum Vergleich **$0.0032** / 1K Bild-Tokens | | KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich **$0.0131072** Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. | Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. [So funktionieren Reservierung und Abrechnung →](https://ailoot.ai/docs/de-at/billing/reserve/) ### Beispielanfragen #### Ailoot Ultra · Bilder curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'tencent/hy-image-v3.5-preview', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"