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

# Tencent: Hy Image 3.5 Preview

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

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

HY Image 3.5 Preview combineert tekst-naar-beeldgeneratie, creatie op basis van referenties en bewerking over meerdere gespreksbeurten. Tencent documenteert maximaal 20 referentiebeelden, automatische formaatkeuze en expliciete uitvoerformaten tot een afbeelding van 4.096 × 4.096 pixels voor gedetailleerd visueel werk.

- [**Ailoot Ultra · Afbeeldingen** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/nl-be/tencent-hy-image-v3-5-preview/#method-0)

Over het model

Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.

HY Image 3.5 Preview is het geïntegreerde model van Tencent voor beeldgeneratie en -bewerking. Het aanvaardt een geschreven briefing met optionele referentiebeelden en ondersteunt het voortzetten van dezelfde visuele taak over meerdere gespreksbeurten. Het resultaat is een afbeelding voor een welbepaalde scène, compositie of bewerking. De voorbeelden van Tencent omvatten productbeelden, campagneposters, visuals voor interfaceontwerp en materiaalconcepten. Bepaal of de taak een nieuw beeld, een compositie op basis van referenties of een gerichte wijziging van een bestaand resultaat vereist.

De producent identificeert de editie als hy-image-v3.5-preview en documenteert een promptlimiet van 100.000 tokens. De invoer is een chronologisch gesprek met tekst en beelden, waarbij het laatste gebruikersbericht de huidige instructie bevat. Eerdere berichten bieden context voor iteratieve bewerking. Dit verschilt van de workflow met één prompt van HY Image 3.0 en de afzonderlijke invoerlimieten daarvan. Bewaar bij een doorlopende ontwerptaak de relevante briefing, de rollen van de referenties en het gekozen beeld, zodat de volgende instructie op de bedoelde visuele toestand kan voortbouwen.

Bereid referentiebeelden in PNG of JPEG/JPG voor. De gedocumenteerde workflow laat maximaal 20 referentiebeelden toe, elk niet groter dan 20 MB. Een beeld kan als verwezen of gecodeerd bestand worden aangeleverd. Als het gesprek te veel beelden bevat, beschrijft de handleiding van de producent dat oudere beelden eerst worden verwijderd. Houd de actieve referentieset gericht, in plaats van erop te vertrouwen dat elk historisch beeld in de context blijft. De regeling voor het aanpassen van de invoergrootte behoudt kleinere beelden en schaalt grotere beelden proportioneel naar een doeloppervlakte in pixels; het standaarddoel is 1.048.576 pixels. Behoud voldoende zichtbare details van het product, materiaal of de lay-out die het resultaat moeten sturen.

Er zijn twee verschillende manieren om de uitvoergrootte voor te bereiden. Bij automatische formaatkeuze stelt generate\_max\_pixels een doeloppervlakte in: 1.048.576 pixels voor het 1K-niveau, 2.359.296 voor het standaardniveau van 1,5K of 4.194.304 voor 2K. Volgens de FAQ van de producent wordt standaard een vierkante verhouding gebruikt wanneer alleen een doeloppervlakte is opgegeven. Als beide formaatregelingen ontbreken, gebruikt het model de briefing en het standaardniveau van 1,5K. Deze niveaus leveren geen automatische 4K-instelling op. Gebruik een oppervlakteniveau wanneer een vierkant beeld bij de taak past. Laat beide formaatregelingen weg om de briefing de verhoudingen op het standaardniveau van 1,5K te laten bepalen; vraag expliciete afmetingen wanneer de lay-out een specifiek staand of breed formaat vereist.

Voor expliciete afmetingen staat de producent positieve gehele zijden van 256 tot 8.192 pixels toe, met een totale oppervlakte van maximaal 16.777.216 pixels. Een vierkant van 4.096 × 4.096 voldoet aan die limiet. Het bereik voor de zijden en de oppervlaktebovengrens gelden samen, dus een zijde van 8.192 pixels betekent niet dat een beeld van 8.192 × 8.192 is toegestaan. Vraag de vereiste breedte en hoogte expliciet op wanneer de uiteindelijke lay-out een specifiek formaat nodig heeft, in plaats van aan te nemen dat een doeloppervlakteniveau dezelfde afmetingen bepaalt. Maak details die gevoelig zijn voor uitsnijden en de vereiste lege ruimte duidelijk in de prompt.

Het model ondersteunt bewerking over meerdere gespreksbeurten via de teruggestuurde gespreksgeschiedenis. Tencent maakt onderscheid tussen het uiteindelijk geleverde beeld en het tussentijdse beeld dat als context voor de volgende bewerking dient. De voorbeelden behouden bij het voortzetten de redenering van de assistent, het toolverzoek en het gegenereerde beeldresultaat. Leg voor een productcompositie eerst het onderwerp en de kadrering vast; vraag daarna een andere belichting of een nieuwe achtergrond en vermeld wat zijn uiterlijk moet behouden. Bewaar het gekozen resultaat samen met de geschiedenis, zodat de volgende beurt op dat beeld werkt en niet op een verworpen variant. In de gedocumenteerde workflow van Tencent vervallen zowel de uiteindelijke beeldlinks als de beeldlinks uit de geschiedenis na 12 uur. Bewaar de beeldbestanden dus voordat je erop rekent voor een latere bewerking.

De gedocumenteerde instellingen omvatten een seed, een eigen watermerkvoetnoot van maximaal 16 tekens en optionele verrijking via extern zoeken, die standaard uitgeschakeld is. De seed is een niet-negatief geheel getal; bij nul of weglating kiest de producent willekeurig. Deze instellingen dienen andere doelen dan de briefing zelf. Beschrijf voor een productbeeld op basis van referenties het uiterlijk van het product, de camerahoek, het oppervlak, de belichting en de beoogde lay-out. Gebruik daarna de referentie om de herkenbare details te sturen. Geef voor een poster de hiërarchie en exacte bewoordingen op, in plaats van de boodschap te laten verzinnen.

De praktische richtlijnen van Tencent raden aan tekst en lay-out te controleren, vooral waar productspecificaties, organisatienamen of andere feitelijke bewoordingen van belang zijn. Controleer in het afgewerkte beeld het onderwerp, de verhoudingen, het materiaal, de uitsnede en de belettering. Bewaar het uiteindelijke bestand met de briefing en instellingen en gebruik voor de volgende bewerking een concrete instructie die aansluit op een zichtbaar probleem.

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

[`tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/nl-be/#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`

### Aan de slag

HY Image 3.5 Preview combineert tekst-naar-beeldgeneratie, creatie op basis van referenties en bewerking over meerdere gespreksbeurten. Tencent documenteert maximaal 20 referentiebeelden, automatische formaatkeuze en expliciete uitvoerformaten tot een afbeelding van 4.096 × 4.096 pixels voor gedetailleerd visueel werk.

Toegestane invoer

Tekst · Afbeeldingen

Resultaten

Afbeeldingen

### Beschikbaar in Ailoot · invoer en methoden

**Ailoot Ultra · Afbeeldingen** `POST /v1/images/generations`

Invoer

`text`, `image`

Uitvoer

`image`

| Veld | Type | Vereiste | Waarden en limieten | Standaard |
| --- | --- | --- | --- | --- |
| Veld`model` | Type`string` | VereisteVereist | Waarden en limieten tencent/hy-image-v3.5-preview | Standaard— |
| Veld`prompt` | Type`string` | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
| Veld`resolution` | Type`string` | VereisteOptioneel | Waarden en limieten 1K, 1.5K, 2K, 4K | Standaard— |
| Veld`aspect_ratio` | Type`string` | VereisteOptioneel | Waarden en limieten 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 | Standaard— |
| Veld`n` | Type`integer` | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 1 | Standaard— |
| Veld`input_references` | Type`array` | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 20 | Standaard— |
| Veld`provider` | Type`object` | VereisteOptioneel | Waarden en limieten | Standaard— |

Methodeparameters en levenscyclus

| Parameter | Contract |
| --- | --- |
| Parameter`content_type` | Contractapplication/json |
| Parameter`required` | Contractmodel, prompt |
| Parameter`material_types` | Contracttext, image |

Levenscyclus: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · daadwerkelijk teruggegeven task\_id of record in de mediabibliotheek

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### Tarieven

##### Zo worden de uiteindelijke kosten berekend

De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.

Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.

Snelle modus

Niet opgegeven Wanneer de snelle modus geselecteerd is

Flex-modus

Niet opgegeven Wanneer de flex-modus geselecteerd is

Maximale redeneerinspanning

Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt

#### Geschatte tarieven ter vergelijking

#### Prijzen per configuratie

Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.

| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
| --- | --- | --- | --- | --- |
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking **—** / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking **—** / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking **—** / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking **—** / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking **—** / 1K tokens |
| Configuratieafbeeldingsuitvoertoken | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheid/ 1K afbeeldingstokens | Kosten Uitvoer · afbeeldingsuitvoertoken · Schatting uitsluitend ter vergelijking **$0.0032** / 1K afbeeldingstokens |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking **$0.0131072** schatting vóór generatie Deze raming is geen extra kost of vast tarief voor de voltooide generatie. |

Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. [Zo werken reservering en afrekening →](https://ailoot.ai/docs/nl-be/billing/reserve/)

### Voorbeeldverzoeken

#### Ailoot Ultra · Afbeeldingen

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
```

### Resultaten ophalen en opslaan

#### Ailoot Ultra · Afbeeldingen

Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

Lezen van andere inhoud

Bestaande eigen bestanden ophalen

```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 voltooide resultaten bewaren

Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.

Bewaar de volledige respons en headers, iedere daadwerkelijke uitvoer, de oorspronkelijk teruggegeven identificatoren en alle verbruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.

##### Als het oorspronkelijke antwoord moet worden gecontroleerd

Bewaar de teruggegeven X-Client-Request-ID voor de reconciliatie. Lees uitsluitend daadwerkelijk teruggegeven task\_id/asset\_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.

Antwoordvelden

| Veld | Type |
| --- | --- |
| Veld`created` | Type |
| Veld`data[].url` | Type |
| Veld`data[].b64_json` | Type |
| Veld`usage` | Type |

### Aliasnamen

#### Modelaliasnamen

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

#### Aliasnamen voor methodepaden

`/v1/images`

#### Gerelateerde aanroeper-ID’s

[`tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/nl-be/#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

Welke invoer en resultaten zijn beschikbaar?

`POST /v1/images/generations` · `tencent/hy-image-v3.5-preview`: `text`, `image` → `image`

Welke velden gebruikt het verzoek?

`POST /v1/images/generations` · `tencent/hy-image-v3.5-preview`: `model`, `prompt`, `resolution`, `aspect_ratio`, `n`, `input_references`, `provider`

Welke limieten gelden?

`POST /v1/images/generations` · `tencent/hy-image-v3.5-preview`: `n.minimum`: `1`; `n.maximum`: `1`

Verbind Ailoot met Claude Code, OpenCode, Hermes of je eigen applicatie.

## Het bedrijf en zijn projectenportefeuille

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

## Koop tokens met korting.

Abonnementsvoordeel voor regelmatig gebruik. Promotiecodes geven tot 50% korting op tokens.

Abonnement

Kies een abonnement met korting voor je terugkerende verzoeken.

Promotiecode tot 50%

Vul de code bij aankoop in. De prijs wordt volgens de lopende actie herberekend.

Kosten in de geschiedenis

Model, tokens en bedrag worden per verzoek bewaard.

[Kies een abonnement](https://ailoot.ai/docs/nl-be/billing/subscriptions/) · [Bekijk modelprijzen](https://ailoot.ai/models/nl-be/)

## Verbind de API met het product dat je verkoopt.

SaaS, apps en bots volgens de openbare aanbodvoorwaarden en licentieovereenkomst van Ailoot. Vraag voor doorverkoop een resellerlicentie aan.

Commerciële applicatie

Voeg tekst-, beeld-, video- en geluidsgeneratie aan betaalde functies van je service toe.

Resellerlicentie

Stuur een projectbeschrijving en toegangsschema. Vraag schriftelijke voorwaarden voor gebruik en doorverkoop.

Documenten op de site

Aanbodvoorwaarden, licentieovereenkomst en gegevensbeleid zijn vóór het verbinden beschikbaar.

[Vraag een resellerlicentie aan](mailto:support@ailoot.ai) · [Aanbodvoorwaarden en licentieovereenkomst](https://ailoot.ai/legal/offer?lang=nl-be)

## Ailoot · Het bedrijf en zijn projectenportefeuille





Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle.





Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.





Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.
