Tencent: Hy Image 3.5 Preview
HY Image 3.5 Preview kombinerer tekst-til-billede-generering, referencebaseret skabelse og redigering over flere samtalerunder. Tencent dokumenterer op til 20 referencebilleder, automatisk størrelsesvalg og udtrykkelige outputstørrelser på op til et billede på 4096 × 4096 til detaljeret visuelt arbejde.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
HY Image 3.5 Preview er Tencents samlede model til billedgenerering og redigering. Den accepterer en skrevet beskrivelse med valgfrie referencebilleder og understøtter fortsættelse af samme visuelle opgave over flere samtalerunder. Resultatet er et billede til en defineret scene, komposition eller redigering. Tencents eksempler omfatter produktbilleder, kampagneplakater, billeder af grænsefladedesign og materialekoncepter. Vælg, om opgaven kræver et nyt billede, en komposition præget af referencer eller en fokuseret ændring af et eksisterende resultat.
Producenten identificerer udgaven som hy-image-v3.5-preview og dokumenterer en promptgrænse på 100K tokens. Input er en kronologisk samtale med tekst og billeder, hvor den sidste brugerbesked leverer den aktuelle instruktion. Tidligere beskeder giver kontekst til iterativ redigering. Dette adskiller sig fra HY Image 3.0's arbejdsgang med én prompt og dens separate inputgrænser. Ved en sammenhængende designopgave skal du gemme den relevante beskrivelse, referenceroller og det valgte billede, så den næste instruktion kan bygge på den ønskede visuelle tilstand.
Forbered referencebilleder i PNG eller JPEG/JPG. Referenceinput kan indeholde op til 20 billeder, hver højst 20 MB i den dokumenterede arbejdsgang. Et billede kan medsendes som et refereret eller kodet materiale. Hvis samtalen indeholder for mange billeder, beskriver producentens vejledning, at ældre billeder fjernes først. Hold det aktive referencesæt fokuseret frem for at stole på, at hvert historisk billede forbliver i konteksten. Kontrollen til størrelsesændring af input bevarer mindre billeder og skalerer større proportionalt mod et mål for pixelareal; standardmålet er 1.048.576 pixels. Bevar tilstrækkelige synlige detaljer til det produkt, materiale eller layout, der skal styre resultatet.
Outputstørrelse har to forskellige forberedelsesveje. Ved automatisk størrelse angiver generate_max_pixels et målareal: 1.048.576 pixels til 1K-niveauet, 2.359.296 til standardniveauet 1.5K eller 4.194.304 til 2K. Producentens FAQ siger, at en indstilling for arealmål, som angives alene, bruger kvadratisk format som standard. Når begge størrelseskontroller udelades, bruger modellen beskrivelsen og standardniveauet 1.5K. Disse niveauer skaber ikke en automatisk 4K-indstilling. Brug et arealniveau, når et kvadratisk billede passer til opgaven. For at lade beskrivelsen styre proportionerne på standardniveauet 1.5K skal du udelade begge størrelseskontroller; bed om udtrykkelige dimensioner, når layoutet kræver en bestemt stående eller bred størrelse.
Ved udtrykkelige dimensioner tillader producenten sider angivet som positive heltal fra 256 til 8192 pixels med et samlet areal på højst 16.777.216 pixels. Et kvadrat på 4096 × 4096 opfylder denne grænse. Sideintervallet og arealloftet gælder samtidig, så en kant på 8192 pixels tillader ikke et billede på 8192 × 8192. Bed udtrykkeligt om den nødvendige bredde og højde, når det endelige layout kræver en bestemt størrelse, frem for at antage, at et arealniveau bestemmer de samme dimensioner. Hold beskæringsfølsomme detaljer og den nødvendige tomme plads synlige i prompten.
Modellen understøtter redigering over flere samtalerunder gennem returneret samtalehistorik. Tencent skelner mellem det endeligt leverede billede og det mellemliggende billede, der bruges som kontekst til næste redigering, og eksemplerne bevarer assistentens ræsonnement, værktøjsanmodning og genererede billedresultat ved fortsættelse. Ved en produktkomposition skal du først fastlægge motiv og indramning og derefter bede om en lysændring eller ny baggrund, mens du angiver, hvad der skal bevare sit udseende. Gem det valgte resultat og dets historik sammen, så næste samtalerunde arbejder på dette billede frem for en fravalgt variation. I Tencents dokumenterede arbejdsgang udløber både linkene til slutbilledet og historikbilledet efter 12 timer, så gem billedmaterialerne, før du regner med dem til en senere redigering.
De dokumenterede kontroller omfatter et seed, en brugerdefineret vandmærkefodnote på op til 16 tegn og valgfri udvidelse med ekstern søgning, som er slået fra som standard. Seed er et ikke-negativt heltal; nul eller udeladelse lader producenten vælge tilfældigt. Disse kontroller tjener andre formål end selve beskrivelsen. Til et referencebaseret produktbillede skal du beskrive produktets udseende, kameravinkel, overflade, belysning og ønskede layout og derefter bruge referencen til at styre de identificerende detaljer. Til en plakat skal du angive hierarki og præcis ordlyd frem for at lade budskabet blive opfundet.
Tencents praktiske vejledning anbefaler at kontrollere tekst og layout, især hvor produktspecifikationer, organisationsnavne eller anden faktuel ordlyd er vigtig. Undersøg det færdige billede for motiv, proportioner, materiale, beskæring og tekst. Gem det endelige materiale sammen med beskrivelsen og indstillingerne, og brug en konkret instruktion knyttet til et synligt problem til den næste redigering.
Ailoot Ultra · Billeder POST /v1/images/generations tencent/hy-image-v3.5-preview
tencent/hy-image-v3.5-previewStart
HY Image 3.5 Preview kombinerer tekst-til-billede-generering, referencebaseret skabelse og redigering over flere samtalerunder. Tencent dokumenterer op til 20 referencebilleder, automatisk størrelsesvalg og udtrykkelige outputstørrelser på op til et billede på 4096 × 4096 til detaljeret visuelt arbejde.
- Accepterede input
- Tekst · Billeder
- Resultater
- Billeder
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Billeder POST /v1/images/generations
- Inputtyper
text,image- Outputtyper
image
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser tencent/hy-image-v3.5-preview | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltresolution | Typestring | KravValgfrit | Værdier og grænser 1K, 1.5K, 2K, 4K | Standard— |
Feltaspect_ratio | Typestring | KravValgfrit | Værdier og grænser 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 | Standard— |
Feltn | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 1 Maksimum: 1 | Standard— |
Feltinput_references | Typearray | KravValgfrit | Værdier og grænser Minimumsantal elementer: 0 Maksimalt antal elementer: 20 | Standard— |
Feltprovider | Typeobject | KravValgfrit | Værdier og grænser | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt |
Parametermaterial_types | Kontrakttext, image |
Livscyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · det faktisk returnerede task_id eller posten i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Afregningsenhed | Beløb |
|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregningsenhed— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| Konfigurationbilledoutputtoken | Takstplan— | Forventet mængde— | Afregningsenhed/ 1K billedtokens | Beløb Output · billedoutputtoken · Estimat kun til sammenligning $0.0032 / 1K billedtokens |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.0131072 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Billeder
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
Hent og gem resultater
Ailoot Ultra · Billeder
Hent hvert returneret billede, eller gem dets Base64-indhold
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Læsning af andet indhold
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.
Behold alle færdige resultater
Gem hvert færdigt billede; hent hver returneret URL eller afkod dets Base64-indhold.
Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.
Hvis det oprindelige svar skal kontrolleres
Gem det returnerede X-Client-Request-ID til afstemning. Brug kun faktisk returnerede task_id/asset_id-værdier eller dit eget mediebibliotek til læseanmodninger; opbyg aldrig en opgave-URL ud fra operations-ID’et, og send aldrig oprettelsesanmodningen igen.
Svarfelter
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Aliaser
Modelaliaser
Ailoot Ultra tencent/hy-image-v3.5-preview
Aliaser for metodestier
/v1/images
Relaterede kalder-ID’er
FAQ · Tencent: Hy Image 3.5 Preview
- Hvilke input og resultater er tilgængelige?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:text,image→image- Hvilke felter bruger anmodningen?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:model,prompt,resolution,aspect_ratio,n,input_references,provider- Hvilke grænser gælder?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:n.minimum:1;n.maximum:1