Tencent: Hy Image 3.5 Preview
HY Image 3.5 Preview verbindet Text-to-Image-Generierung, referenzgestützte Erstellung und Bearbeitung über mehrere Gesprächsrunden. Tencent dokumentiert bis zu 20 Referenzbilder, automatische Größenwahl und ausdrückliche Ausgabegrößen bis zu 4096 × 4096 Pixeln für detaillierte Bildarbeiten.
Ü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 vereinheitlichtes Modell für Bilderzeugung 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 definierte Szene, Komposition oder Bearbeitung. Tencents Beispiele umfassen Produktbilder, Kampagnenplakate, visuelle Interface-Entwürfe und Materialkonzepte. Entscheiden Sie, ob die Aufgabe ein neues Bild, eine durch Referenzen geprägte Komposition oder eine gezielte Änderung eines vorhandenen Ergebnisses benötigt.
Der Hersteller bezeichnet die Ausgabe als hy-image-v3.5-preview und dokumentiert eine Promptgrenze von 100K Tokens. Die Eingabe ist ein chronologischer Gesprächsverlauf mit Text und Bildern, dessen letzte Nutzernachricht die aktuelle Anweisung liefert. Frühere Nachrichten geben Kontext für iterative Bearbeitungen. Das unterscheidet sich vom Einzelprompt-Workflow von 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 Bildzustand aufbauen kann.
Bereiten Sie Referenzbilder als PNG oder JPEG/JPG vor. Die Referenzeingaben können im dokumentierten Workflow bis zu 20 Bilder enthalten, jedes höchstens 20 MB groß. Ein Bild kann als referenzierte oder kodierte Datei bereitgestellt werden. Wenn der Gesprächsverlauf zu viele Bilder enthält, beschreibt der Herstellerleitfaden das vorrangige Entfernen älterer Bilder. Halten Sie die aktive Referenzauswahl gezielt, statt darauf zu vertrauen, dass jedes historische Bild im Kontext bleibt. Die Eingabe-Größensteuerung behält kleinere Bilder bei und skaliert größere proportional auf eine Ziel-Pixelfläche; der Standardzielwert beträgt 1.048.576 Pixel. Erhalten Sie ausreichend sichtbare Details des Produkts, Materials oder Layouts, die das Ergebnis leiten sollen.
Für die Ausgabegröße gibt es zwei unterschiedliche 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 der Flächenziel-Einstellung standardmäßig ein quadratisches Seitenverhältnis verwendet. Fehlen beide Größensteuerungen, nutzt das Modell das Briefing und die standardmäßige 1.5K-Stufe. 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 bei der standardmäßigen 1.5K-Stufe leitet. Fordern Sie ausdrückliche Abmessungen an, wenn das Layout eine bestimmte Hoch- oder Breitformatgröße benötigt.
Für ausdrückliche 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 Kantenlänge von 8192 Pixeln erlaubt daher kein Bild von 8192 × 8192 Pixeln. Fordern Sie die erforderliche Breite und Höhe ausdrücklich an, wenn das finale Layout eine bestimmte Größe benötigt, statt anzunehmen, dass eine Zielflächenstufe dieselben Abmessungen bestimmt. Halten Sie zuschnittkritische Details und den erforderlichen Freiraum im Prompt fest.
Das Modell unterstützt die Bearbeitung über mehrere Gesprächsrunden mithilfe des zurückgegebenen Gesprächsverlaufs. Tencent unterscheidet das final ausgelieferte Bild vom Zwischenbild, das als Kontext für die nächste Bearbeitung dient. Seine Beispiele bewahren beim Fortsetzen die Überlegungen des Assistenten, die Werkzeuganfrage und das erzeugte Bildergebnis. Legen Sie bei einer Produktkomposition zuerst Motiv und Bildausschnitt fest. Fordern Sie anschließend eine geänderte Beleuchtung oder einen neuen Hintergrund an und geben Sie an, was sein Aussehen behalten soll. Bewahren Sie das ausgewählte Ergebnis zusammen mit seinem Verlauf auf, damit die nächste Runde dieses Bild statt einer verworfenen Variante bearbeitet. Im dokumentierten Tencent-Workflow laufen sowohl die finalen als auch die Verlaufs-Bildlinks nach 12 Stunden ab. Sichern Sie daher die Bilddateien, 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 eine optionale Ergänzung durch externe Suche, die standardmäßig ausgeschaltet ist. Der Seed ist eine nicht negative ganze Zahl; bei null oder fehlender Angabe wählt der Hersteller zufällig. Diese Steuerelemente haben andere Aufgaben als das Briefing selbst. Beschreiben Sie für ein referenzgestütztes Produktbild Erscheinung, Kamerawinkel, Untergrund, Beleuchtung und vorgesehenes Layout und verwenden Sie dann die Referenz für die identitätsprägenden Details. Geben Sie für ein Plakat Hierarchie und exakten Wortlaut an, statt seine Botschaft erfinden zu lassen.
Tencents praktische Hinweise empfehlen die Prüfung von Text und Layout, insbesondere wenn Produktspezifikationen, Organisationsnamen oder andere sachliche Formulierungen wichtig sind. Prüfen Sie das fertige Bild auf Motiv, Proportionen, Material, Zuschnitt und Schrift. Bewahren Sie das finale Bild zusammen 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-previewStart
HY Image 3.5 Preview verbindet Text-to-Image-Generierung, referenzgestützte Erstellung und Bearbeitung über mehrere Gesprächsrunden. Tencent dokumentiert bis zu 20 Referenzbilder, automatische Größenwahl und ausdrückliche Ausgabegrößen bis zu 4096 × 4096 Pixeln für detaillierte Bildarbeiten.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Bilder POST /v1/images/generations
- Eingabetypen
text,image- Ausgabetypen
image
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits tencent/hy-image-v3.5-preview | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 1K, 1.5K, 2K, 4K | Standard— |
Feldaspect_ratio | Typstring | 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— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 1 | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 20 | Standard— |
Feldprovider | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parametermaterial_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 Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationBildausgabetoken | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheit/ 1K Bild-Token | Gebühr Ausgabe · Bildausgabetoken · Schätzung nur zum Vergleich $0.0032 / 1K Bild-Token |
| 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 →
Beispielanfragen
Ailoot Ultra · Bilder
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"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Bilder
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Die zurückgegebene X-Client-Request-ID zum Abgleich aufbewahren. Nur tatsächlich zurückgegebene task_id-/asset_id-Werte oder die eigene Medienbibliothek abfragen; niemals eine Aufgaben-URL aus der Vorgangs-ID bilden und die Erstellung niemals erneut anfordern.
Antwortfelder
| Feld | Typ |
|---|---|
Feldcreated | Typ |
Felddata[].url | Typ |
Felddata[].b64_json | Typ |
Feldusage | Typ |
Aliasnamen
Modellaliasnamen
Ailoot Ultra tencent/hy-image-v3.5-preview
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Tencent: Hy Image 3.5 Preview
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:model,prompt,resolution,aspect_ratio,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:n.minimum:1;n.maximum:1