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.
", "aboutText": "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.\n\nVý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.\n\nPř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.\n\nVelikost 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ě.\n\nPro 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.\n\nModel 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ě.\n\nDokumentované 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.\n\nPraktická 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "aaed8ad2f16e63ce4b7c00244ab8edf27ea46382d196997bb25ccc26e4fdf551", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "cs", "methods": [ { "html": "tencent/hy-image-v3.5-previewHY 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.
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.
POST /v1/images/generationstext, imageimage| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity tencent/hy-image-v3.5-preview | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Minimální délka: 1 | Výchozí— |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity 1K, 1.5K, 2K, 4K | Výchozí— |
Poleaspect_ratio | Typstring | 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í— |
Polen | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 1 Maximum: 1 | Výchozí— |
Poleinput_references | Typarray | PožadavekVolitelné | Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 20 | Výchozí— |
Poleprovider | Typobject | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametrmaterial_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}
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.
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í →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'tencent/hy-image-v3.5-preview', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nStá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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nUlož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í.
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 | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Ailoot Ultra tencent/hy-image-v3.5-preview
/v1/images