Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview jungia vaizdų generavimą iš teksto, kūrimą pagal etalonus ir kelių ėjimų redagavimą. Tencent dokumentuoja iki 20 etaloninių vaizdų, automatinį dydžio parinkimą ir aiškiai nurodomus išvesties dydžius iki 4096 × 4096 vaizdo detaliam vizualiniam darbui.

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

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

HY Image 3.5 Preview yra vieningas Tencent vaizdų generavimo ir redagavimo modelis. Jis priima rašytinį aprašą su pasirenkamais etaloniniais vaizdais ir palaiko tos pačios vizualinės užduoties tęsimą per kelis ėjimus. Rezultatas yra apibrėžtos scenos, kompozicijos ar redagavimo vaizdas. Tencent pavyzdžiai apima produktų vaizdus, kampanijų plakatus, sąsajų dizaino vaizdus ir medžiagų koncepcijas. Pasirinkite, ar užduočiai reikia naujo vaizdo, etalonais paremto komponavimo, ar tikslinio esamo rezultato pakeitimo.

Gamintojas versiją identifikuoja kaip hy-image-v3.5-preview ir dokumentuoja 100K žetonų užklausos ribą. Įvestis yra chronologinis pokalbis su tekstu ir vaizdais, kuriame paskutinis naudotojo pranešimas pateikia dabartinę instrukciją. Ankstesni pranešimai suteikia kontekstą iteraciniam redagavimui. Tai skiriasi nuo HY Image 3.0 vienos užklausos eigos ir atskirų jos įvesties ribų. Tęstinei dizaino užduočiai išsaugokite atitinkamą aprašą, etalonų vaidmenis ir pasirinktą vaizdą, kad kita instrukcija galėtų remtis norima vizualine būsena.

Paruoškite PNG arba JPEG/JPG etaloninius vaizdus. Dokumentuotoje eigoje etalonų įvestyje gali būti iki 20 vaizdų, kiekvienas ne didesnis nei 20 MB. Vaizdą galima pateikti kaip nurodytą arba užkoduotą medžiagą. Jei pokalbyje yra per daug vaizdų, gamintojo vadovas aprašo pirmiausia senesnių vaizdų pašalinimą. Aktyvų etalonų rinkinį laikykite kryptingą, užuot tikėjęsi, kad kiekvienas istorinis vaizdas liks kontekste. Įvesties dydžio keitimo valdiklis išsaugo mažesnius vaizdus ir proporcingai mažina didesnius iki tikslinio ploto pikseliais; numatytasis tikslas yra 1 048 576 pikselių. Išsaugokite pakankamai matomų produkto, medžiagos ar išdėstymo detalių, kurios turi nukreipti rezultatą.

Išvesties dydžiui yra du atskiri pasiruošimo būdai. Automatinio dydžio atveju generate_max_pixels nustato tikslinį plotą: 1 048 576 pikselių 1K lygiui, 2 359 296 numatytajam 1.5K lygiui arba 4 194 304 lygiui 2K. Gamintojo DUK nurodo, kad pateikus vien tik tikslinio ploto nuostatą numatomas kvadratinis santykis. Kai abu dydžio valdikliai praleisti, modelis naudoja aprašą ir numatytąjį 1.5K lygį. Šie lygiai nesukuria automatinės 4K nuostatos. Naudokite ploto lygį, kai užduočiai tinka kvadratinis vaizdas. Kad proporcijas numatytajame 1.5K lygyje nukreiptų aprašas, praleiskite abu dydžio valdiklius; aiškių matmenų prašykite, kai maketui reikia konkretaus vertikalaus ar plataus dydžio.

Aiškiems matmenims gamintojas leidžia teigiamas sveikąsias kraštinių reikšmes nuo 256 iki 8192 pikselių, o bendras plotas negali viršyti 16 777 216 pikselių. 4096 × 4096 kvadratas šią ribą atitinka. Kraštinių intervalas ir ploto riba taikomi kartu, todėl 8192 pikselių kraštinė neleidžia 8192 × 8192 vaizdo. Kai galutiniam maketui reikia konkretaus dydžio, aiškiai prašykite reikiamo pločio ir aukščio, užuot manę, kad tikslinio ploto lygis nustato tuos pačius matmenis. Užklausoje aiškiai paminėkite apkirpimui jautrias detales ir reikalingą tuščią erdvę.

Modelis palaiko kelių ėjimų redagavimą per grąžinamą pokalbio istoriją. Tencent skiria galutinį pateiktą vaizdą nuo tarpinio vaizdo, naudojamo kaip kito redagavimo kontekstas; tęsiant jo pavyzdžiai išsaugo asistento samprotavimą, įrankio užklausą ir sugeneruoto vaizdo rezultatą. Produkto kompozicijai pirmiausia nustatykite objektą ir kadravimą, tada paprašykite pakeisti apšvietimą ar foną, nurodydami, kas turi išlaikyti savo išvaizdą. Pasirinktą rezultatą ir jo istoriją laikykite kartu, kad kitas ėjimas dirbtų su tuo vaizdu, o ne atmestu variantu. Tencent dokumentuotoje eigoje tiek galutinio, tiek istorijos vaizdo nuorodos nustoja galioti po 12 valandų, todėl išsaugokite vaizdo medžiagą prieš pasikliaudami ja vėlesniam redagavimui.

Dokumentuoti valdikliai apima sėklą, individualią vandens ženklo išnašą iki 16 simbolių ir pasirenkamą papildymą išorine paieška, kuris pagal numatymą išjungtas. Sėkla yra neneigiamas sveikasis skaičius; nulis arba praleidimas leidžia gamintojui parinkti atsitiktinai. Šie valdikliai turi kitus tikslus nei pats aprašas. Produkto vaizdui pagal etaloną aprašykite produkto išvaizdą, kameros kampą, paviršių, apšvietimą ir norimą išdėstymą, tada etalonu nukreipkite atpažinimo detales. Plakatui pateikite hierarchiją ir tikslų tekstą, užuot palikę jo žinutę išgalvoti.

Praktinės Tencent rekomendacijos siūlo tikrinti tekstą ir išdėstymą, ypač kai svarbios produkto specifikacijos, organizacijų pavadinimai ar kiti faktiniai užrašai. Patikrinkite galutinio vaizdo objektą, proporcijas, medžiagą, apkirpimą ir raides. Galutinę medžiagą išsaugokite su aprašu ir nuostatomis, o kitam redagavimui naudokite konkrečią instrukciją, susietą su matomu trūkumu.

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

tencent/hy-image-v3.5-preview

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

Pradžia

Leidžiamos įvestys: Tekstas · Vaizdai
Rezultatai: Vaizdai

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Vaizdai POST /v1/images/generations

Įvestis: text, image
Išvestis: image

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos tencent/hy-image-v3.5-preview	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausias ilgis: 1	Numatyta—
Laukas`resolution`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 1K, 1.5K, 2K, 4K	Numatyta—
Laukas`aspect_ratio`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 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	Numatyta—
Laukas`n`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 1	Numatyta—
Laukas`input_references`	Tipas`array`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 20	Numatyta—
Laukas`provider`	Tipas`object`	ReikalavimasNeprivaloma	Reikšmės ir ribos	Numatyta—

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijamodel, prompt
Parametras`material_types`	Specifikacijatext, image

Gyvavimo ciklas: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Planai

Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

Numatomi įkainiai palyginimui

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Numatomas kiekis	Apskaitos vienetas	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Numatomas kiekis—	Apskaitos vienetas—	Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų
Konfigūracijavaizdo išvesties žetonas	Įkainių lentelė—	Numatomas kiekis—	Apskaitos vienetas/ 1K vaizdo tokenų	Mokestis Išvestis · vaizdo išvesties žetonas · Įvertis tik palyginimui $0.0032 / 1K vaizdo tokenų
KonfigūracijaNumatoma generavimo kaina	Įkainių lentelė—	Numatomas kiekisvieno generavimo įvertis	Apskaitos vienetas—	Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.0131072 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis.

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · Vaizdai

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

Gauti ir išsaugoti rezultatus

Ailoot Ultra · Vaizdai

Atsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį

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

Kito turinio skaitymas

Skaityti esamą jums priklausančią medžiagą

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.

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.

Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.

Atsakymo laukai

Laukas	Tipas
Laukas`created`	Tipas
Laukas`data[].url`	Tipas
Laukas`data[].b64_json`	Tipas
Laukas`usage`	Tipas

Pseudonimai

Modelių pseudonimai

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

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

Kokios įvestys ir rezultatai prieinami?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
Kokius laukus naudoja užklausa?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
Kokie apribojimai taikomi?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview