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

# Tencent: Hy Image 3.5 Preview

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

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

HY Image 3.5 Preview združuje ustvarjanje slike iz besedila, ustvarjanje na podlagi referenc in urejanje v več korakih pogovora. Tencent dokumentira do 20 referenčnih slik, samodejno izbiro velikosti in izrecne izhodne velikosti do slike 4096 × 4096 za podrobno vizualno delo.

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

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

HY Image 3.5 Preview je Tencentov enotni model za ustvarjanje in urejanje slik. Sprejema pisni opis z izbirnimi referenčnimi slikami ter podpira nadaljevanje iste vizualne naloge skozi več korakov pogovora. Rezultat je slika za določen prizor, kompozicijo ali popravek. Tencentovi primeri vključujejo podobe izdelkov, plakate za kampanje, vizualne zasnove vmesnikov in koncepte materialov. Izberite, ali naloga zahteva novo sliko, kompozicijo, ki jo usmerjajo reference, ali ciljno spremembo obstoječega rezultata.

Proizvajalec izdajo označuje kot hy-image-v3.5-preview in dokumentira omejitev poziva 100K žetonov. Vhod je kronološki pogovor z besedilom in slikami, pri čemer zadnje uporabniško sporočilo podaja trenutno navodilo. Prejšnja sporočila zagotavljajo kontekst za ponavljajoče se urejanje. To se razlikuje od postopka HY Image 3.0 z enim pozivom in njegovih ločenih vhodnih omejitev. Pri neprekinjeni oblikovalski nalogi ohranite ustrezni opis, vloge referenc in izbrano sliko, da lahko naslednje navodilo nadgradi predvideno vizualno stanje.

Pripravite referenčne slike PNG ali JPEG/JPG. Referenčni vhodi lahko vsebujejo do 20 slik, vsaka pa v dokumentiranem postopku ne sme presegati 20 MB. Sliko je mogoče podati kot referencirano ali kodirano gradivo. Če pogovor vsebuje preveč slik, proizvajalčev vodnik opisuje najprejšnje odstranjevanje starejših slik. Aktivni nabor referenc naj ostane osredotočen, namesto da računate na ohranitev vseh zgodovinskih slik v kontekstu. Nastavitev spreminjanja velikosti vhoda ohrani manjše slike, večje pa sorazmerno zmanjša proti ciljni površini slikovnih pik; privzeti cilj je 1.048.576 slikovnih pik. Ohranite dovolj vidnih podrobnosti izdelka, materiala ali postavitve, ki morajo usmerjati rezultat.

Izhodna velikost ima dva različna načina priprave. Pri samodejnem določanju velikosti generate\_max\_pixels določi ciljno površino: 1.048.576 slikovnih pik za raven 1K, 2.359.296 za privzeto raven 1.5K ali 4.194.304 za 2K. Proizvajalčeva pogosta vprašanja navajajo, da samostojno podana nastavitev ciljne površine privzeto uporablja kvadratno razmerje. Če izpustite obe nastavitvi velikosti, model uporabi opis in privzeto raven 1.5K. Te ravni ne ustvarijo samodejne nastavitve 4K. Raven površine uporabite, kadar nalogi ustreza kvadratna slika. Da lahko opis usmerja razmerja pri privzeti ravni 1.5K, izpustite obe nastavitvi velikosti; kadar postavitev zahteva konkretno pokončno ali široko velikost, zahtevajte izrecne dimenzije.

Pri izrecnih dimenzijah proizvajalec dovoljuje pozitivni celoštevilski stranici od 256 do 8192 slikovnih pik, s skupno površino največ 16.777.216 slikovnih pik. Kvadrat 4096 × 4096 izpolnjuje to omejitev. Razpon stranic in zgornja meja površine veljata hkrati, zato stranica 8192 slikovnih pik ne dovoljuje slike 8192 × 8192. Kadar končna postavitev zahteva konkretno velikost, izrecno zahtevajte potrebno širino in višino, namesto da predpostavljate, da raven ciljne površine določa enake dimenzije. Podrobnosti, občutljive na obrezovanje, in zahtevani prazen prostor naj bodo jasno navedeni v pozivu.

Model podpira urejanje v več korakih pogovora prek vrnjene zgodovine. Tencent razlikuje med končno dostavljeno sliko in vmesno sliko, uporabljeno kot kontekst za naslednji popravek; njegovi primeri pri nadaljevanju ohranijo asistentovo razmišljanje, zahtevo orodju in rezultat ustvarjene slike. Pri kompoziciji izdelka najprej določite motiv in kadriranje; nato zahtevajte spremembo osvetlitve ali novo ozadje in določite, kaj naj ohrani videz. Izbrani rezultat in njegovo zgodovino hranite skupaj, da naslednji korak dela s to sliko, ne z zavrženo različico. V Tencentovem dokumentiranem postopku povezave do končnih slik in slik v zgodovini potečejo po 12 urah, zato slikovna gradiva shranite, preden se nanje zanesete pri poznejšem urejanju.

Dokumentirane nastavitve vključujejo seme, opombo vodnega žiga po meri do 16 znakov in izbirno dopolnjevanje z zunanjim iskanjem, ki je privzeto izklopljeno. Seme je nenegativno celo število; ničla ali izpustitev omogoči proizvajalcu naključno izbiro. Te nastavitve imajo drugačen namen kot opis sam. Pri podobi izdelka na podlagi reference opišite videz izdelka, kot kamere, podlago, osvetlitev in predvideno postavitev, nato pa z referenco usmerite prepoznavne podrobnosti. Za plakat podajte hierarhijo in natančno besedilo, namesto da prepustite izmišljanje sporočila.

Tencentova praktična navodila priporočajo preverjanje besedila in postavitve, zlasti kadar so pomembne specifikacije izdelkov, imena organizacij ali druge stvarne navedbe. Na dokončani sliki preverite motiv, razmerja, material, izrez in napise. Končno gradivo hranite skupaj z opisom in nastavitvami, za naslednji popravek pa uporabite konkretno navodilo, povezano z vidno težavo.

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

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

### Začetek

HY Image 3.5 Preview združuje ustvarjanje slike iz besedila, ustvarjanje na podlagi referenc in urejanje v več korakih pogovora. Tencent dokumentira do 20 referenčnih slik, samodejno izbiro velikosti in izrecne izhodne velikosti do slike 4096 × 4096 za podrobno vizualno delo.

Dovoljeni vhodi

Besedilo · Slike

Rezultati

Slike

### Na voljo v Ailoot · vhodi in metode

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

Vhod

`text`, `image`

Izhod

`image`

| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
| --- | --- | --- | --- | --- |
| Polje`model` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve tencent/hy-image-v3.5-preview | Privzeto— |
| Polje`prompt` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
| Polje`resolution` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve 1K, 1.5K, 2K, 4K | Privzeto— |
| Polje`aspect_ratio` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve 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 | Privzeto— |
| Polje`n` | Vrsta`integer` | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 1 | Privzeto— |
| Polje`input_references` | Vrsta`array` | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 20 | Privzeto— |
| Polje`provider` | Vrsta`object` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |

Parametri in življenjski cikel metode

| Parameter | Specifikacija |
| --- | --- |
| Parameter`content_type` | Specifikacijaapplication/json |
| Parameter`required` | Specifikacijamodel, prompt |
| Parameter`material_types` | Specifikacijatext, image |

Življenjski cikel: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · Dejansko vrnjeni task\_id ali zapis v medijski knjižnici

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

`GET /v1/media/assets`

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

### Cenik

##### Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način

Ni navedeno Ko je izbran hitri način

Način flex

Ni navedeno Ko je izbran način flex

Najvišja raven razmišljanja

Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

#### Ocenjene cene za primerjavo

#### Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

| Nastavitev | Cenovna lestvica | Predvidena količina | Obračunska enota | Strošek |
| --- | --- | --- | --- | --- |
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Obračunska enota— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo **—** / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo **—** / 1K žetonov |
| Nastavitevizhodni žeton slike | Cenovna lestvica— | Predvidena količina— | Obračunska enota/ 1K slikovnih žetonov | Strošek Izhod · izhodni žeton slike · Ocena samo za primerjavo **$0.0032** / 1K slikovnih žetonov |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Obračunska enota— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo **$0.0131072** ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. [Kako delujeta rezervacija in obračun →](https://ailoot.ai/docs/sl/billing/reserve/)

### Primeri zahtev

#### Ailoot Ultra · Slike

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

### Prejmi in shrani rezultate

#### Ailoot Ultra · Slike

Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64

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

Branje druge vsebine

Preberi obstoječa gradiva, ki vam pripadajo

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

##### Ohrani vse dokončane rezultate

Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.

Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.

##### Če je treba preveriti izvirni odgovor

Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task\_id/asset\_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.

Polja odgovora

| Polje | Vrsta |
| --- | --- |
| Polje`created` | Vrsta |
| Polje`data[].url` | Vrsta |
| Polje`data[].b64_json` | Vrsta |
| Polje`usage` | Vrsta |

### Druga imena

#### Druga imena modelov

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

#### Druga imena poti metod

`/v1/images`

#### Povezani ID-ji za klic

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

Kateri vhodi in rezultati so na voljo?

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

Katera polja uporablja zahteva?

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

Katere omejitve veljajo?

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

Ailoot povežite s Claude Code, OpenCode, Hermes ali svojo aplikacijo.

## Podjetje in njegov portfelj projektov

Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah.

## Žetone kupujte s popustom.

Naročniški popust za redno delo. Promocijske kode prinesejo do 50% popusta na nakup žetonov.

Naročnina

Za redne zahteve izberite paket s popustom.

Promocijska koda do 50%

Kodo vnesite ob nakupu. Cena se preračuna po veljavni akciji.

Poraba v zgodovini

Za vsako zahtevo se shranijo model, žetoni in znesek.

[Izberite naročnino](https://ailoot.ai/docs/sl/billing/subscriptions/) · [Oglejte si cene modelov](https://ailoot.ai/models/sl/)

## API povežite z izdelkom, ki ga prodajate.

SaaS, aplikacije in boti po ponudbi in licenčni pogodbi Ailoot. Za nadaljnjo prodajo zaprosite za preprodajno licenco.

Komercialna aplikacija

Ustvarjanje besedila, slik, videa in zvoka vključite v plačljive funkcije svoje storitve.

Licenca za preprodajalca

Pošljite opis projekta in shemo dostopa. Zahtevajte pisne pogoje uporabe in nadaljnje prodaje.

Dokumenti na strani

Ponudba, licenčna pogodba in politika obdelave podatkov so dostopne pred povezavo.

[Zaprosite za preprodajno licenco](mailto:support@ailoot.ai) · [Ponudba in licenčna pogodba](https://ailoot.ai/legal/offer?lang=sl)

## Ailoot · Podjetje in njegov portfelj projektov





Ailoot temelji na pridobljenih operativnih izkušnjah, široki bazi strank, stabilni storitvi in stalnem spremljanju KPI.





Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah.





Ailoot te operativne izkušnje uporablja za dostop prek API do funkcij umetne inteligence v izdelkih strank, agentih, aplikacijah in avtomatizacijah.
