Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview spája tvorbu obrázkov z textu, tvorbu podľa referencií a úpravy vo viacerých kolách. Tencent dokumentuje až 20 referenčných obrázkov, automatický výber veľkosti a explicitné výstupné rozmery až po obrázok 4 096 × 4 096 na detailnú vizuálnu prácu.

Ailoot Ultra · Obrázky POST /v1/images/generations tencent/hy-image-v3.5-preview

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

HY Image 3.5 Preview je jednotný model spoločnosti Tencent na tvorbu a úpravu obrázkov. Prijíma písomné zadanie s voliteľnými referenčnými obrázkami a podporuje pokračovanie tej istej vizuálnej úlohy vo viacerých kolách. Výsledkom je obrázok pre určenú scénu, kompozíciu alebo úpravu. Príklady spoločnosti Tencent zahŕňajú produktové obrázky, plagáty pre kampane, vizuály návrhu rozhrania a materiálové koncepty. Určte, či úloha vyžaduje nový obrázok, kompozíciu vedenú referenciami alebo cielenú zmenu existujúceho výsledku.

Výrobca označuje edíciu ako hy-image-v3.5-preview a uvádza limit zadania 100K tokenov. Vstupom je chronologická konverzácia obsahujúca text a obrázky, pričom posledná správa používateľa obsahuje aktuálny pokyn. Skoršie správy poskytujú kontext pre priebežné úpravy. Tým sa líši od postupu HY Image 3.0 s jediným zadaním a jeho samostatných vstupných limitov. Pri priebežnej návrhovej úlohe uchovajte príslušné zadanie, úlohy referencií a vybraný obrázok, aby ďalší pokyn mohol nadviazať na zamýšľaný vizuálny stav.

Pripravte referenčné obrázky vo formáte PNG alebo JPEG/JPG. V dokumentovanom postupe môže referenčný vstup obsahovať až 20 obrázkov, každý s veľkosťou najviac 20 MB. Obrázok možno dodať ako odkazovaný alebo zakódovaný podklad. Ak konverzácia obsahuje priveľa obrázkov, príručka výrobcu opisuje odstránenie najstarších obrázkov ako prvých. Aktívny súbor referencií držte zameraný na úlohu a nespoliehajte sa na to, že v kontexte zostane každý historický obrázok. Ovládanie zmeny vstupnej veľkosti zachováva menšie obrázky a väčšie proporcionálne zmenšuje smerom k cieľovej ploche v pixeloch; predvolený cieľ je 1 048 576 pixelov. Zachovajte dostatok viditeľných detailov produktu, materiálu alebo rozloženia, ktoré majú viesť výsledok.

Veľkosť výstupu má dva odlišné spôsoby prípravy. Pri automatickej veľkosti určuje generate_max_pixels cieľovú plochu: 1 048 576 pixelov pre úroveň 1K, 2 359 296 pre predvolenú úroveň 1,5K alebo 4 194 304 pre 2K. FAQ výrobcu uvádza, že samostatne zadané nastavenie cieľovej plochy predvolene používa štvorcový pomer strán. Ak oba ovládacie prvky veľkosti vynecháte, model vychádza zo zadania a predvolenej úrovne 1,5K. Tieto úrovne nevytvárajú automatické nastavenie 4K. Úroveň plochy použite vtedy, keď úlohe vyhovuje štvorcový obrázok. Ak má pri predvolenej úrovni 1,5K proporcie viesť zadanie, vynechajte oba ovládacie prvky veľkosti; ak rozloženie vyžaduje konkrétnu veľkosť na výšku alebo na šírku, vyžiadajte explicitné rozmery.

Pri explicitných rozmeroch výrobca povoľuje kladné celočíselné dĺžky strán od 256 do 8 192 pixelov s celkovou plochou najviac 16 777 216 pixelov. Štvorec 4 096 × 4 096 tento limit spĺňa. Rozsah dĺžok strán a strop plochy platia súčasne, takže hrana dlhá 8 192 pixelov nepovoľuje obrázok 8 192 × 8 192. Keď konečné rozloženie potrebuje konkrétnu veľkosť, vyžiadajte požadovanú šírku a výšku explicitne a nepredpokladajte, že úroveň cieľovej plochy určuje rovnaké rozmery. V zadaní jasne uveďte detaily citlivé na orez aj požadované voľné miesto.

Model podporuje úpravy vo viacerých kolách prostredníctvom vrátenej histórie konverzácie. Tencent rozlišuje konečný doručený obrázok od priebežného obrázka použitého ako kontext pre ďalšiu úpravu a jeho príklady pri pokračovaní zachovávajú uvažovanie asistenta, požiadavku na nástroj aj výsledok generovania obrázka. Pri produktovej kompozícii najprv určte objekt a záber; potom požiadajte o zmenu osvetlenia alebo nové pozadie a uveďte, čo má zachovať svoj vzhľad. Vybraný výsledok uchovajte spolu s históriou, aby ďalšie kolo pracovalo s týmto obrázkom, nie s odloženým variantom. V dokumentovanom postupe spoločnosti Tencent platnosť odkazov na konečný obrázok aj obrázok v histórii uplynie po 12 hodinách, preto obrazové podklady uložte skôr, než sa na ne spoľahnete pri neskoršej úprave.

Dokumentované ovládacie prvky zahŕňajú seed, vlastný text v päte vodoznaku s najviac 16 znakmi a voliteľné doplnenie externým vyhľadávaním, ktoré je predvolene vypnuté. Seed je nezáporné celé číslo; nula alebo vynechanie nechá výrobcu vybrať náhodnú hodnotu. Tieto ovládacie prvky majú iný účel než samotné zadanie. Pri produktovom vizuále podľa referencie opíšte vzhľad produktu, uhol kamery, povrch, osvetlenie a zamýšľané rozloženie a potom referenciou veďte rozpoznávacie detaily. Pri plagáte zadajte hierarchiu a presné znenie namiesto ponechania jeho posolstva na vymýšľanie.

Praktické odporúčania spoločnosti Tencent vyzývajú na kontrolu textu a rozloženia, najmä tam, kde záleží na produktových špecifikáciách, názvoch organizácií alebo inom faktickom znení. V dokončenom obrázku skontrolujte objekt, proporcie, materiál, orez a nápisy. Konečný podklad uchovajte so zadaním a nastaveniami a ďalšiu úpravu veďte konkrétnym pokynom viazaným na viditeľný problém.

Ailoot Ultra · Obrázky POST /v1/images/generations tencent/hy-image-v3.5-preview

tencent/hy-image-v3.5-preview

Tencent /tencent/hy-image-v3.5-preview

Úvod

Povolené vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Obrázky POST /v1/images/generations

Vstup: text, image
Výstup: image

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity tencent/hy-image-v3.5-preview	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Minimálna dĺžka: 1	Predvolené—
Pole`resolution`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 1K, 1.5K, 2K, 4K	Predvolené—
Pole`aspect_ratio`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 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	Predvolené—
Pole`n`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 1 Maximum: 1	Predvolené—
Pole`input_references`	Typ`array`	PožiadavkaVoliteľné	Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 20	Predvolené—
Pole`provider`	Typ`object`	PožiadavkaVoliteľné	Hodnoty a limity	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, prompt
Parameter`material_types`	Špecifikáciatext, image

Životný cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Účtovacia jednotka	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Účtovacia jednotka—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
Konfiguráciatoken výstupného obrázka	Sadzobník—	Odhadované množstvo—	Účtovacia jednotka/ 1K obrazových tokenov	Poplatok Výstup · token výstupného obrázka · Odhad iba na porovnanie $0.0032 / 1K obrazových tokenov
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Účtovacia jednotka—	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.0131072 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Obrázky

curl

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

Prijať a uložiť výsledky

Ailoot Ultra · Obrázky

Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64

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

Čítanie ďalšieho obsahu

Čítať existujúce podklady, ktoré vám patria

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.

Uchovať všetky dokončené výsledky

Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.

Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.

Ak treba overiť pôvodnú odpoveď

Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.

Polia odpovede

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelov

Ailoot Ultra tencent/hy-image-v3.5-preview

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

Aké vstupy a výsledky sú dostupné?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
Aké polia používa požiadavka?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
Aké limity platia?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview