Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview spojuje tvorbu obrázků z textu, tvorbu podle předloh a úpravy v několika kolech. Tencent dokumentuje až 20 referenčních obrázků, automatický výběr velikosti a výslovně zadané rozměry až 4096 × 4096 pro detailní vizuální tvorbu.

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

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

HY Image 3.5 Preview je sjednocený model společnosti Tencent pro tvorbu a úpravy obrázků. Přijímá písemné zadání s volitelnými obrazovými předlohami a umožňuje pokračovat v téže vizuální úloze v několika kolech. Výsledkem je obrázek zadané scény, kompozice nebo úpravy. Mezi příklady Tencentu patří produktové obrázky, reklamní plakáty, vizuály návrhů rozhraní a materiálové koncepty. Rozhodněte, zda úloha vyžaduje nový obrázek, kompozici inspirovanou předlohami, nebo cílenou změnu stávajícího výsledku.

Výrobce označuje tuto edici jako hy-image-v3.5-preview a dokumentuje limit zadání 100K tokenů. Vstupem je chronologická konverzace s textem a obrázky, přičemž poslední uživatelská zpráva obsahuje aktuální pokyn. Dřívější zprávy poskytují kontext pro průběžné úpravy. Tím se model liší od postupu HY Image 3.0 s jediným zadáním a jeho samostatných vstupních limitů. U navazujícího návrhu uchovávejte relevantní zadání, role předloh a vybraný obrázek, aby další pokyn mohl vycházet ze zamýšleného vizuálního stavu.

Připravte předlohy ve formátu PNG nebo JPEG/JPG. Dokumentovaný postup přijímá až 20 referenčních obrázků, každý o velikosti nejvýše 20 MB. Obrázek lze předat odkazem na soubor nebo v kódované podobě. Pokud konverzace obsahuje příliš mnoho obrázků, průvodce výrobce popisuje nejprve odstranění těch starších. Aktivní sadu předloh udržujte cílenou a nespoléhejte na to, že v kontextu zůstane každý historický obrázek. Nastavení změny velikosti vstupů ponechává menší obrázky a větší poměrně zmenšuje směrem k cílové ploše; výchozí cíl je 1 048 576 pixelů. Zachovejte dostatek viditelných detailů produktu, materiálu nebo rozvržení, které mají výsledek řídit.

Velikost výstupu lze připravit dvěma odlišnými způsoby. Při automatické velikosti určuje generate_max_pixels cílovou plochu: 1 048 576 pixelů pro úroveň 1K, 2 359 296 pro výchozí úroveň 1.5K nebo 4 194 304 pro 2K. Podle FAQ výrobce se při samostatném zadání cílové plochy používá výchozí čtvercový poměr stran. Pokud vynecháte obě nastavení velikosti, model vychází ze zadání a výchozí úrovně 1.5K. Tyto úrovně nevytvářejí automatické nastavení 4K. Úroveň podle plochy použijte, když se k úloze hodí čtvercový obrázek. Má-li poměry při výchozí úrovni 1.5K určit zadání, vynechte obě nastavení velikosti; vyžaduje-li rozvržení konkrétní rozměry na výšku nebo na šířku, zadejte je výslovně.

Pro konkrétní rozměry výrobce povoluje kladné celočíselné délky stran od 256 do 8192 pixelů a celkovou plochu nejvýše 16 777 216 pixelů. Čtverec 4096 × 4096 tomuto limitu odpovídá. Rozsah stran a maximální plocha platí současně, takže hrana o délce 8192 pixelů neumožňuje obrázek 8192 × 8192. Potřebuje-li výsledné rozvržení konkrétní velikost, vyžádejte přímo potřebnou šířku a výšku; nepředpokládejte, že úroveň cílové plochy určí stejné rozměry. V zadání zdůrazněte detaily citlivé na ořez i potřebné volné místo.

Model podporuje úpravy v několika kolech prostřednictvím vrácené historie konverzace. Tencent odlišuje finálně dodaný obrázek od mezilehlého obrázku, který slouží jako kontext pro další úpravu, a jeho příklady při pokračování zachovávají uvažování asistenta, požadavek nástroje i výsledek s vygenerovaným obrázkem. U produktové kompozice nejprve stanovte hlavní motiv a záběr; poté požádejte o změnu osvětlení nebo nové pozadí a určete, co má zachovat svůj vzhled. Vybraný výsledek uchovávejte spolu s historií, aby další kolo pracovalo s tímto obrázkem, nikoli se zavrženou variantou. V dokumentovaném postupu Tencentu vyprší odkazy na finální i historické obrázky po 12 hodinách, proto si obrazové soubory uložte, než na ně budete spoléhat při pozdější úpravě.

Dokumentované ovládací prvky zahrnují seed, vlastní poznámku vodoznaku o délce až 16 znaků a volitelné rozšíření o externí vyhledávání, které je ve výchozím stavu vypnuté. Seed je nezáporné celé číslo; nula nebo vynechání ponechává náhodnou volbu výrobci. Tyto prvky mají jiný účel než samotné zadání. U produktového vizuálu podle předlohy popište vzhled produktu, úhel kamery, povrch, osvětlení a zamýšlené rozvržení a předlohou upřesněte rozpoznávací detaily. U plakátu určete hierarchii a přesné znění, aby sdělení nemuselo být vymyšleno.

Praktická doporučení Tencentu radí kontrolovat text a rozvržení, zejména tam, kde záleží na specifikacích produktu, názvech organizací nebo jiných faktických formulacích. V hotovém obrázku prověřte hlavní motiv, proporce, materiál, ořez a nápisy. Finální soubor uchovávejte se zadáním a nastavením a pro další úpravu použijte konkrétní pokyn navázaný na viditelný 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

Přijímané vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metody

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

Vstup: text, image
Výstup: image

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity tencent/hy-image-v3.5-preview	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity Minimální délka: 1	Výchozí—
Pole`resolution`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 1K, 1.5K, 2K, 4K	Výchozí—
Pole`aspect_ratio`	Typ`string`	PožadavekVolitelné	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	Výchozí—
Pole`n`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 1 Maximum: 1	Výchozí—
Pole`input_references`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 20	Výchozí—
Pole`provider`	Typ`object`	PožadavekVolitelné	Hodnoty a limity	Výchozí—

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_types`	Kontrakttext, image

Životní cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutečně vrácené task_id nebo záznam v knihovně médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Předpokládané množství	Účtovací jednotka	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Účtovací jednotka—	Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
Konfiguracevýstupní obrazový token	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotka/ 1K obrazových tokenů	Poplatek Výstup · výstupní obrazový token · Odhad pouze pro srovnání $0.0032 / 1K obrazových tokenů
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Účtovací jednotka—	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.0131072 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

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

Přijímání a ukládání výsledků

Ailoot Ultra · Obrázky

Stáhněte každý vrácený obrázek nebo 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}

Další načtení obsahu

Načíst existující soubory, které vám patří

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.

Uchovejte všechny dokončené výsledky

Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.

Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.

Pokud je nutné ověřit původní odpověď

Uchovejte vrácené X-Client-Request-ID pro spárování záznamů. Načítejte pouze skutečně vrácené hodnoty task_id/asset_id nebo vlastní knihovnu médií; nikdy nevytvářejte URL úlohy z ID operace a nikdy znovu neodesílejte požadavek na vytvoření.

Pole odpovědi

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

Aliasy

Aliasy modelu

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

Aliasy cest metod

/v1/images

Související ID modelů

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

Jaké vstupy a výsledky jsou dostupné?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
Jaká pole požadavek používá?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
Jaké limity platí?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview