Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview yhdistää kuvien luonnin tekstistä, viitteisiin perustuvan luomisen ja usean vuoron muokkauksen. Tencentin dokumentaatiossa kuvataan enintään 20 viitekuvaa, automaattinen koonvalinta ja täsmälliset tuloskoot aina 4096 × 4096 pikselin kuvaan asti yksityiskohtaista visuaalista työtä varten.

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

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

HY Image 3.5 Preview on Tencentin yhtenäinen kuvien luonti- ja muokkausmalli. Se vastaanottaa kirjallisen briiffin ja valinnaisia viitekuvia sekä tukee saman visuaalisen tehtävän jatkamista useiden vuorojen ajan. Tuloksena on kuva määritetystä näkymästä, sommittelusta tai muokkauksesta. Tencentin esimerkkeihin kuuluvat tuotekuvat, kampanjajulisteet, käyttöliittymäsuunnittelun kuvat ja materiaalikonseptit. Valitse, tarvitseeko tehtävä uuden kuvan, viitteiden ohjaaman sommittelun vai rajatun muutoksen olemassa olevaan tulokseen.

Valmistaja nimeää version tunnuksella hy-image-v3.5-preview ja dokumentoi kehotteen rajaksi 100K tokenia. Syöte on aikajärjestyksessä oleva tekstiä ja kuvia sisältävä keskustelu, jonka viimeinen käyttäjäviesti antaa nykyisen ohjeen. Aiemmat viestit tarjoavat kontekstin iteratiiviselle muokkaukselle. Tämä eroaa HY Image 3.0:n yhden kehotteen työnkulusta ja sen omista syöterajoista. Säilytä jatkuvaa suunnittelutehtävää varten olennainen briiffi, viitteiden roolit ja valittu kuva, jotta seuraava ohje voi rakentua tarkoitetun visuaalisen tilanteen varaan.

Valmistele PNG- tai JPEG/JPG-viitekuvat. Dokumentoidussa työnkulussa viitesyöte voi sisältää enintään 20 kuvaa, joista kunkin koko on enintään 20 MB. Kuva voidaan toimittaa viitattuna tai koodattuna aineistona. Jos keskustelussa on liikaa kuvia, valmistajan opas kuvaa vanhempien kuvien poistamisen ensin. Pidä aktiivinen viitejoukko rajattuna sen sijaan, että luottaisit kaikkien aiempien kuvien säilyvän kontekstissa. Syötekuvan koonsäätö säilyttää pienemmät kuvat ja skaalaa suurempia samassa suhteessa kohti pikselipinta-alatavoitetta; sen oletustavoite on 1 048 576 pikseliä. Säilytä riittävästi näkyviä yksityiskohtia tuotteesta, materiaalista tai asettelusta, jonka on tarkoitus ohjata tulosta.

Tuloskoon valmisteluun on kaksi erillistä tapaa. Automaattisessa koonvalinnassa generate_max_pixels asettaa tavoitepinta-alan: 1 048 576 pikseliä 1K-tasolle, 2 359 296 oletuksena olevalle 1.5K-tasolle tai 4 194 304 2K-tasolle. Valmistajan usein kysyttyjen kysymysten mukaan yksin annettu pinta-alatavoite käyttää oletuksena neliökuvasuhdetta. Kun molemmat kokosäädöt jätetään pois, malli käyttää briiffiä ja oletuksena olevaa 1.5K-tasoa. Nämä tasot eivät muodosta automaattista 4K-asetusta. Käytä pinta-alatasoa, kun neliökuva sopii tehtävään. Jätä molemmat kokosäädöt pois, jos haluat briiffin ohjaavan mittasuhteita oletuksena olevalla 1.5K-tasolla; pyydä täsmälliset mitat, kun asettelu tarvitsee tietyn pysty- tai vaakakoon.

Täsmällisille mitoille valmistaja sallii sivunpituudet positiivisina kokonaislukuina väliltä 256–8192 pikseliä, ja kokonaispinta-ala saa olla enintään 16 777 216 pikseliä. Neliö, jonka koko on 4096 × 4096, täyttää tämän rajan. Sivujen vaihteluväli ja pinta-alaraja ovat voimassa yhtä aikaa, joten 8192 pikselin sivu ei mahdollista 8192 × 8192 -kuvaa. Pyydä tarvittava leveys ja korkeus erikseen, kun lopullinen asettelu tarvitsee tietyn koon, sen sijaan että olettaisit pinta-alatason määrittävän samat mitat. Kuvaa kehotteessa rajaukselle herkät yksityiskohdat ja tarvittava tyhjä tila.

Malli tukee usean vuoron muokkausta palautetun keskusteluhistorian avulla. Tencent erottaa lopullisen toimitetun kuvan välivaiheen kuvasta, jota käytetään seuraavan muokkauksen kontekstina. Sen esimerkeissä säilytetään jatkamista varten avustajan päättely, työkalupyyntö ja luodun kuvan tulos. Määritä tuotesommittelussa ensin kohde ja rajaus; pyydä sitten valaistuksen muutosta tai uutta taustaa ja kerro samalla, minkä ulkoasun tulee säilyä. Pidä valittu tulos ja sen historia yhdessä, jotta seuraava vuoro käsittelee sitä kuvaa eikä hylättyä variaatiota. Tencentin dokumentoidussa työnkulussa sekä lopullisen kuvan että historiakuvan linkit vanhenevat 12 tunnin kuluttua, joten tallenna kuva-aineistot ennen kuin käytät niitä myöhemmän muokkauksen perustana.

Dokumentoituja säätöjä ovat siemenarvo, enintään 16 merkin mukautettu vesileiman alaviite sekä valinnainen ulkoisen haun hyödyntäminen, joka on oletuksena pois käytöstä. Siemenarvo on ei-negatiivinen kokonaisluku; nolla tai arvon pois jättäminen antaa valmistajan valita sen satunnaisesti. Näillä säädöillä on eri tarkoitukset kuin itse briiffillä. Kuvaile viitteeseen perustuvaa tuotekuvaa varten tuotteen ulkonäkö, kamerakulma, pinta, valaistus ja tarkoitettu asettelu ja käytä sitten viitettä tunnistettavien yksityiskohtien ohjaamiseen. Anna julisteelle hierarkia ja täsmällinen sanamuoto sen sijaan, että jättäisit viestin keksittäväksi.

Tencentin käytännön ohjeissa suositellaan tekstin ja asettelun tarkistamista etenkin silloin, kun tuotetiedot, organisaatioiden nimet tai muut tosiasioihin liittyvät sanamuodot ovat tärkeitä. Tarkista valmiista kuvasta kohde, mittasuhteet, materiaali, rajaus ja tekstit. Säilytä lopullinen aineisto briiffin ja asetusten kanssa ja kohdista seuraavan muokkauksen konkreettinen ohje näkyvään ongelmaan.

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

tencent/hy-image-v3.5-preview

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

Aloitus

Hyväksytyt syötteet: Teksti · Kuvat
Tulokset: Kuvat

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot Ultra · Kuvat POST /v1/images/generations

Syötetyypit: text, image
Tulostyypit: image

Kenttä	Tyyppi	Vaatimus	Arvot & rajat	Oletus
Kenttä`model`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat tencent/hy-image-v3.5-preview	Oletus—
Kenttä`prompt`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat Vähimmäispituus: 1	Oletus—
Kenttä`resolution`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 1K, 1.5K, 2K, 4K	Oletus—
Kenttä`aspect_ratio`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 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	Oletus—
Kenttä`n`	Tyyppi`integer`	VaatimusValinnainen	Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 1	Oletus—
Kenttä`input_references`	Tyyppi`array`	VaatimusValinnainen	Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 20	Oletus—
Kenttä`provider`	Tyyppi`object`	VaatimusValinnainen	Arvot & rajat	Oletus—

Menetelmän parametrit ja elinkaari

Parametri	Sopimus
Parametri`content_type`	Sopimusapplication/json
Parametri`required`	Sopimusmodel, prompt
Parametri`material_types`	Sopimustext, image

Elinkaari: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Hinnoittelu

Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila: Ei määritetty Kun nopea tila on valittu
Flex-tila: Ei määritetty Kun flex-tila on valittu
Päättelyn enimmäisteho: Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

Asetukset	Hinnasto	Ennustettu määrä	Laskutusyksikkö	Veloitus
AsetuksetTokenien perushinnat	HinnastoPerushinta	Ennustettu määrä—	Laskutusyksikkö—	Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia
Asetuksetkuvatulosteen token	Hinnasto—	Ennustettu määrä—	Laskutusyksikkö/ 1K kuvatokenia	Veloitus Tuloste · kuvatulosteen token · Arvio vain vertailua varten $0.0032 / 1K kuvatokenia
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Laskutusyksikkö—	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.0131072 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Esimerkkipyynnöt

Ailoot Ultra · Kuvat

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

Vastaanota ja tallenna tulokset

Ailoot Ultra · Kuvat

Lataa jokainen palautettu kuva tai tallenna sen Base64-sisältö

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

Muut sisällön lukukerrat

Lue olemassa olevat omistamasi aineistot

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.

Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.

Säilytä koko vastaus ja otsakkeet, jokainen todellinen tuloste, alkuperäiset palautetut tunnisteet ja kaikki käyttötietokentät. Selvitä alkuperäisen operaation tila lähettämättä luontipyyntöä uudelleen.

Jos alkuperäinen vastaus on tarkistettava

Säilytä palautettu X-Client-Request-ID täsmäytystä varten. Tee lukukyselyt vain todellisuudessa palautetuilla task_id/asset_id-arvoilla tai käytä omistamaasi mediakirjastoa; älä koskaan rakenna tehtävän URL-osoitetta operaation ID:n perusteella äläkä lähetä luontipyyntöä uudelleen.

Vastauksen kentät

Kenttä	Tyyppi
Kenttä`created`	Tyyppi
Kenttä`data[].url`	Tyyppi
Kenttä`data[].b64_json`	Tyyppi
Kenttä`usage`	Tyyppi

Aliakset

Mallin aliakset

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

Menetelmäpolkujen aliakset

/v1/images

Liittyvät kutsujan ID:t

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

Mitä syötteitä ja tuloksia on saatavilla?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
Mitä kenttiä pyyntö käyttää?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
Mitä rajoja sovelletaan?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview