Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview združuje ustvarjanje slike iz besedila, ustvarjanje na podlagi referenc in urejanje v več korakih pogovora. Tencent dokumentira do 20 referenčnih slik, samodejno izbiro velikosti in izrecne izhodne velikosti do slike 4096 × 4096 za podrobno vizualno delo.

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

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

HY Image 3.5 Preview je Tencentov enotni model za ustvarjanje in urejanje slik. Sprejema pisni opis z izbirnimi referenčnimi slikami ter podpira nadaljevanje iste vizualne naloge skozi več korakov pogovora. Rezultat je slika za določen prizor, kompozicijo ali popravek. Tencentovi primeri vključujejo podobe izdelkov, plakate za kampanje, vizualne zasnove vmesnikov in koncepte materialov. Izberite, ali naloga zahteva novo sliko, kompozicijo, ki jo usmerjajo reference, ali ciljno spremembo obstoječega rezultata.

Proizvajalec izdajo označuje kot hy-image-v3.5-preview in dokumentira omejitev poziva 100K žetonov. Vhod je kronološki pogovor z besedilom in slikami, pri čemer zadnje uporabniško sporočilo podaja trenutno navodilo. Prejšnja sporočila zagotavljajo kontekst za ponavljajoče se urejanje. To se razlikuje od postopka HY Image 3.0 z enim pozivom in njegovih ločenih vhodnih omejitev. Pri neprekinjeni oblikovalski nalogi ohranite ustrezni opis, vloge referenc in izbrano sliko, da lahko naslednje navodilo nadgradi predvideno vizualno stanje.

Pripravite referenčne slike PNG ali JPEG/JPG. Referenčni vhodi lahko vsebujejo do 20 slik, vsaka pa v dokumentiranem postopku ne sme presegati 20 MB. Sliko je mogoče podati kot referencirano ali kodirano gradivo. Če pogovor vsebuje preveč slik, proizvajalčev vodnik opisuje najprejšnje odstranjevanje starejših slik. Aktivni nabor referenc naj ostane osredotočen, namesto da računate na ohranitev vseh zgodovinskih slik v kontekstu. Nastavitev spreminjanja velikosti vhoda ohrani manjše slike, večje pa sorazmerno zmanjša proti ciljni površini slikovnih pik; privzeti cilj je 1.048.576 slikovnih pik. Ohranite dovolj vidnih podrobnosti izdelka, materiala ali postavitve, ki morajo usmerjati rezultat.

Izhodna velikost ima dva različna načina priprave. Pri samodejnem določanju velikosti generate_max_pixels določi ciljno površino: 1.048.576 slikovnih pik za raven 1K, 2.359.296 za privzeto raven 1.5K ali 4.194.304 za 2K. Proizvajalčeva pogosta vprašanja navajajo, da samostojno podana nastavitev ciljne površine privzeto uporablja kvadratno razmerje. Če izpustite obe nastavitvi velikosti, model uporabi opis in privzeto raven 1.5K. Te ravni ne ustvarijo samodejne nastavitve 4K. Raven površine uporabite, kadar nalogi ustreza kvadratna slika. Da lahko opis usmerja razmerja pri privzeti ravni 1.5K, izpustite obe nastavitvi velikosti; kadar postavitev zahteva konkretno pokončno ali široko velikost, zahtevajte izrecne dimenzije.

Pri izrecnih dimenzijah proizvajalec dovoljuje pozitivni celoštevilski stranici od 256 do 8192 slikovnih pik, s skupno površino največ 16.777.216 slikovnih pik. Kvadrat 4096 × 4096 izpolnjuje to omejitev. Razpon stranic in zgornja meja površine veljata hkrati, zato stranica 8192 slikovnih pik ne dovoljuje slike 8192 × 8192. Kadar končna postavitev zahteva konkretno velikost, izrecno zahtevajte potrebno širino in višino, namesto da predpostavljate, da raven ciljne površine določa enake dimenzije. Podrobnosti, občutljive na obrezovanje, in zahtevani prazen prostor naj bodo jasno navedeni v pozivu.

Model podpira urejanje v več korakih pogovora prek vrnjene zgodovine. Tencent razlikuje med končno dostavljeno sliko in vmesno sliko, uporabljeno kot kontekst za naslednji popravek; njegovi primeri pri nadaljevanju ohranijo asistentovo razmišljanje, zahtevo orodju in rezultat ustvarjene slike. Pri kompoziciji izdelka najprej določite motiv in kadriranje; nato zahtevajte spremembo osvetlitve ali novo ozadje in določite, kaj naj ohrani videz. Izbrani rezultat in njegovo zgodovino hranite skupaj, da naslednji korak dela s to sliko, ne z zavrženo različico. V Tencentovem dokumentiranem postopku povezave do končnih slik in slik v zgodovini potečejo po 12 urah, zato slikovna gradiva shranite, preden se nanje zanesete pri poznejšem urejanju.

Dokumentirane nastavitve vključujejo seme, opombo vodnega žiga po meri do 16 znakov in izbirno dopolnjevanje z zunanjim iskanjem, ki je privzeto izklopljeno. Seme je nenegativno celo število; ničla ali izpustitev omogoči proizvajalcu naključno izbiro. Te nastavitve imajo drugačen namen kot opis sam. Pri podobi izdelka na podlagi reference opišite videz izdelka, kot kamere, podlago, osvetlitev in predvideno postavitev, nato pa z referenco usmerite prepoznavne podrobnosti. Za plakat podajte hierarhijo in natančno besedilo, namesto da prepustite izmišljanje sporočila.

Tencentova praktična navodila priporočajo preverjanje besedila in postavitve, zlasti kadar so pomembne specifikacije izdelkov, imena organizacij ali druge stvarne navedbe. Na dokončani sliki preverite motiv, razmerja, material, izrez in napise. Končno gradivo hranite skupaj z opisom in nastavitvami, za naslednji popravek pa uporabite konkretno navodilo, povezano z vidno težavo.

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

tencent/hy-image-v3.5-preview

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

Začetek

Dovoljeni vhodi: Besedilo · Slike
Rezultati: Slike

Na voljo v Ailoot · vhodi in metode

Ailoot Ultra · Slike POST /v1/images/generations

Vhod: text, image
Izhod: image

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve tencent/hy-image-v3.5-preview	Privzeto—
Polje`prompt`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Najmanjša dolžina: 1	Privzeto—
Polje`resolution`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 1K, 1.5K, 2K, 4K	Privzeto—
Polje`aspect_ratio`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 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	Privzeto—
Polje`n`	Vrsta`integer`	ZahtevaIzbirno	Vrednosti in omejitve Najmanj: 1 Največ: 1	Privzeto—
Polje`input_references`	Vrsta`array`	ZahtevaIzbirno	Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 20	Privzeto—
Polje`provider`	Vrsta`object`	ZahtevaIzbirno	Vrednosti in omejitve	Privzeto—

Parametri in življenjski cikel metode

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

Življenjski cikel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenik

Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način: Ni navedeno Ko je izbran hitri način
Način flex: Ni navedeno Ko je izbran način flex
Najvišja raven razmišljanja: Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

Ocenjene cene za primerjavo

Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

Nastavitev	Cenovna lestvica	Predvidena količina	Obračunska enota	Strošek
NastavitevOsnovne cene žetonov	Cenovna lestvicaOsnovna cena	Predvidena količina—	Obračunska enota—	Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov
Nastavitevizhodni žeton slike	Cenovna lestvica—	Predvidena količina—	Obračunska enota/ 1K slikovnih žetonov	Strošek Izhod · izhodni žeton slike · Ocena samo za primerjavo $0.0032 / 1K slikovnih žetonov
NastavitevOcenjeni strošek ustvarjanja	Cenovna lestvica—	Predvidena količinaocena za eno generiranje	Obračunska enota—	Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.0131072 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje.

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot Ultra · Slike

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

Prejmi in shrani rezultate

Ailoot Ultra · Slike

Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64

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

Branje druge vsebine

Preberi obstoječa gradiva, ki vam pripadajo

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.

Ohrani vse dokončane rezultate

Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.

Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.

Če je treba preveriti izvirni odgovor

Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.

Polja odgovora

Polje	Vrsta
Polje`created`	Vrsta
Polje`data[].url`	Vrsta
Polje`data[].b64_json`	Vrsta
Polje`usage`	Vrsta

Druga imena

Druga imena modelov

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

Druga imena poti metod

/v1/images

Povezani ID-ji za klic

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

Kateri vhodi in rezultati so na voljo?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
Katera polja uporablja zahteva?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
Katere omejitve veljajo?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview