Source: https://ailoot.ai/models/de-ch/tencent-hy-image-v3-5-preview/
Canonical: https://ailoot.ai/models/de-ch/tencent-hy-image-v3-5-preview/
Language: de-ch

# Tencent: Hy Image 3.5 Preview

[Markdown](https://ailoot.ai/models/de-ch/tencent-hy-image-v3-5-preview/index.md) · [JSON](https://ailoot.ai/models/de-ch/tencent-hy-image-v3-5-preview/facts.json)

## [Tencent: Hy Image 3.5 Preview](https://ailoot.ai/models/de-ch/tencent-hy-image-v3-5-preview/)

HY Image 3.5 Preview verbindet Text-zu-Bild-Generierung, referenzbasierte Erstellung und Bearbeitung über mehrere Gesprächsrunden. Tencent dokumentiert bis zu 20 Referenzbilder, automatische Grössenwahl und ausdrückliche Ausgabegrössen bis zu einem Bild mit 4096 × 4096 Pixeln für detaillierte visuelle Arbeit.

- [**Ailoot Ultra · Bilder** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/de-ch/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 vereinheitlichtes Modell zur 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 definierte Szene, Komposition oder Bearbeitung. Tencents Beispiele umfassen Produktbilder, Kampagnenplakate, Bilder für Interface-Design und Materialkonzepte. Entscheiden Sie, ob die Aufgabe ein neues Bild, eine durch 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 Tokens. Die Eingabe ist eine chronologische Unterhaltung mit Text und Bildern; die letzte Nutzernachricht liefert die aktuelle Anweisung. Frühere Nachrichten geben Kontext für iterative Bearbeitung. Das unterscheidet sich vom Ablauf mit einem einzelnen Prompt und den separaten Eingabegrenzen von HY Image 3.0. Bewahren Sie bei einer fortlaufenden Designaufgabe das relevante Briefing, die Referenzrollen und das gewählte Bild auf, damit die nächste Anweisung auf dem beabsichtigten visuellen Zustand aufbauen kann.

Bereiten Sie Referenzbilder als PNG oder JPEG/JPG vor. Referenzeingaben können im dokumentierten Ablauf bis zu 20 Bilder enthalten, jeweils höchstens 20 MB gross. Ein Bild kann als referenzierte oder kodierte Datei geliefert werden. Wenn die Unterhaltung zu viele Bilder enthält, beschreibt der Herstellerleitfaden ein Entfernen älterer Bilder zuerst. Halten Sie die aktive Referenzauswahl gezielt, statt sich darauf zu verlassen, dass jedes historische Bild im Kontext bleibt. Die Einstellung zur Eingabeskalierung bewahrt kleinere Bilder und skaliert grössere proportional auf eine Zielfläche in Pixeln hin; der Standardzielwert beträgt 1'048'576 Pixel. Erhalten Sie genügend sichtbare Details für das Produkt, Material oder Layout, das das Ergebnis führen soll.

Für die Ausgabegrösse gibt es zwei unterschiedliche Vorbereitungswege. Bei automatischer Grössenwahl setzt generate\_max\_pixels eine Zielfläche: 1'048'576 Pixel für die Stufe 1K, 2'359'296 für die standardmässige Stufe 1.5K oder 4'194'304 für 2K. Laut Hersteller-FAQ führt eine allein angegebene Zielflächeneinstellung standardmässig zu einem quadratischen Seitenverhältnis. Wenn beide Grösseneinstellungen fehlen, nutzt das Modell das Briefing und die Standardstufe 1.5K. Diese Stufen erzeugen keine automatische 4K-Einstellung. Nutzen Sie eine Flächenstufe, wenn ein quadratisches Bild zur Aufgabe passt. Damit das Briefing die Proportionen in der Standardstufe 1.5K bestimmt, lassen Sie beide Grösseneinstellungen weg; verlangen Sie ausdrückliche Abmessungen, wenn das Layout ein bestimmtes Hoch- oder Breitformat 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 mit 4096 × 4096 erfüllt diese Grenze. Seitenbereich und Flächenobergrenze gelten gemeinsam; eine Kante von 8192 Pixeln erlaubt daher kein Bild mit 8192 × 8192. Fordern Sie die erforderliche Breite und Höhe ausdrücklich an, wenn das fertige Layout eine bestimmte Grösse benötigt, statt anzunehmen, eine Zielflächenstufe bestimme dieselben Abmessungen. Machen Sie beschnittempfindliche Details und den benötigten Freiraum im Prompt deutlich.

Das Modell unterstützt die Bearbeitung über mehrere Gesprächsrunden anhand des zurückgegebenen Gesprächsverlaufs. Tencent unterscheidet das endgültig gelieferte Bild vom Zwischenbild, das als Kontext für die nächste Bearbeitung dient; seine Beispiele behalten bei der Fortsetzung die Überlegungen des Assistenten, die Werkzeuganfrage und das generierte Bildergebnis bei. Legen Sie für eine Produktkomposition zunächst Motiv und Bildausschnitt fest und bitten Sie danach um eine Lichtänderung oder einen neuen Hintergrund, wobei Sie angeben, was sein Erscheinungsbild behalten soll. Bewahren Sie das gewählte Ergebnis gemeinsam mit seinem Verlauf auf, damit die nächste Runde an diesem Bild und nicht an einer verworfenen Variante arbeitet. Im dokumentierten Tencent-Ablauf laufen sowohl die endgültigen als auch die Verlaufsbild-Links nach 12 Stunden ab; sichern Sie daher die Bilddateien, bevor Sie sich für eine spätere Bearbeitung darauf verlassen.

Zu den dokumentierten Einstellungen gehören ein Seed, eine benutzerdefinierte Wasserzeichen-Fussnote mit bis zu 16 Zeichen und eine optionale Erweiterung durch externe Suche, die standardmässig ausgeschaltet ist. Der Seed ist eine nichtnegative ganze Zahl; null oder Weglassen lässt den Hersteller zufällig wählen. Diese Einstellungen erfüllen andere Zwecke als das Briefing selbst. Beschreiben Sie für ein referenzbasiertes Produktmotiv Aussehen, Kamerawinkel, Untergrund, Beleuchtung und vorgesehenes Layout des Produkts und nutzen Sie dann die Referenz für die identifizierenden Details. Geben Sie für ein Plakat Hierarchie und genauen 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, Beschnitt und Schrift. Bewahren Sie das fertige Bild mit Briefing und Einstellungen auf und verwenden Sie für die nächste Bearbeitung eine konkrete Anweisung, die sich auf ein sichtbares Problem bezieht.

**Ailoot Ultra · Bilder** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview`

[`tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/de-ch/#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 Erstellung und Bearbeitung über mehrere Gesprächsrunden. Tencent dokumentiert bis zu 20 Referenzbilder, automatische Grössenwahl und ausdrückliche Ausgabegrössen bis zu einem Bild mit 4096 × 4096 Pixeln für detaillierte 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 |
| --- | --- | --- | --- | --- |
| KonfigurationToken-Basistarife | 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 · Cache schreiben · Schätzung nur zum Vergleich **—** / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich **—** / 1K Tokens |
| KonfigurationBildausgabe-Token | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheit/ 1K Bild-Tokens | Gebühr Ausgabe · Bildausgabe-Token · Schätzung nur zum Vergleich **$0.0032** / 1K Bild-Tokens |
| KonfigurationGeschätzte Erzeugungskosten | 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 abschliessenden Verbrauchsdatensatzes. [So funktionieren Reservierung und Abrechnung →](https://ailoot.ai/docs/de-ch/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"<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}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

Abrufe anderer Inhalte

Vorhandene eigene Dateien abrufen

```bash
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 |
| --- | --- |
| Feld`created` | Typ |
| Feld`data[].url` | Typ |
| Feld`data[].b64_json` | Typ |
| Feld`usage` | Typ |

### Aliasnamen

#### Modellaliasnamen

**Ailoot Ultra** [`tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/de-ch/#m=tencent%2Fhy-image-v3.5-preview&route=Ultra&caller=tencent%2Fhy-image-v3.5-preview&fmt=images)

#### Aliasnamen für Methodenpfade

`/v1/images`

#### Zugehörige Aufrufer-IDs

[`tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/de-ch/#m=tencent%2Fhy-image-v3.5-preview&route=Ultra&caller=tencent%2Fhy-image-v3.5-preview&fmt=images)

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`

Verbinden Sie Ailoot mit Claude Code, OpenCode, Hermes oder Ihrer eigenen Anwendung.

## Das Unternehmen und sein Projektportfolio

Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.

## Tokens mit Rabatt kaufen.

Aborabatt für regelmäßige Arbeit. Aktionscodes bieten bis 50% beim Tokenkauf.

Abo

Wählen Sie einen Tarif mit Rabatt für Ihre regelmäßigen Anfragen.

Aktionscode bis 50%

Geben Sie den Code beim Kauf ein. Der Preis wird nach den gültigen Aktionsbedingungen berechnet.

Ausgaben in der Historie

Modell, Tokens und Betrag werden für jede Anfrage gespeichert.

[Abo wählen](https://ailoot.ai/docs/de-ch/billing/subscriptions/) · [Modellpreise ansehen](https://ailoot.ai/models/de-ch/)

## Verbinden Sie die API mit dem Produkt, das Sie verkaufen.

SaaS, Anwendungen und Bots nach dem offiziellen Angebot und Lizenzvertrag von Ailoot. Fordern Sie für den Weiterverkauf eine Reseller-Lizenz an.

Kommerzielle Anwendung

Integrieren Sie Text-, Bild-, Video- und Audioerzeugung in kostenpflichtige Funktionen Ihres Dienstes.

Reseller-Lizenz

Senden Sie Projektbeschreibung und Zugangsmodell. Fordern Sie schriftliche Nutzungs- und Weiterverkaufsbedingungen an.

Dokumente auf der Website

Offizielles Angebot, Lizenzvertrag und Datenschutzerklärung sind vor der Verbindung zugänglich.

[Reseller-Lizenz anfordern](mailto:support@ailoot.ai) · [Offizielles Angebot und Lizenzvertrag](https://ailoot.ai/legal/offer?lang=de-ch)

## Ailoot · Das Unternehmen und sein Projektportfolio





Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle.





Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.





Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.
