Source: https://ailoot.ai/models/cs/tencent-hy-image-v3-5-preview/ Canonical: https://ailoot.ai/models/cs/tencent-hy-image-v3-5-preview/ Language: cs # Tencent: Hy Image 3.5 Preview [Markdown](https://ailoot.ai/models/cs/tencent-hy-image-v3-5-preview/index.md) · [JSON](https://ailoot.ai/models/cs/tencent-hy-image-v3-5-preview/facts.json) ## [Tencent: Hy Image 3.5 Preview](https://ailoot.ai/models/cs/tencent-hy-image-v3-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`](https://ailoot.ai/models/cs/tencent-hy-image-v3-5-preview/#method-0) 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`](https://ailoot.ai/models/cs/#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` ### Úvod 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. 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í →](https://ailoot.ai/docs/cs/billing/reserve/) ### Příklady požadavků #### Ailoot Ultra · Obrázky 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"