Tencent: Hy Image 3.5 Preview
HY Image 3.5 Preview kombinerar text-till-bild-generering, referensbaserat skapande och redigering i flera omgångar. Tencent dokumenterar upp till 20 referensbilder, automatiskt storleksval och uttryckliga utmatningsstorlekar upp till en bild på 4096 × 4096 för detaljerat visuellt arbete.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
HY Image 3.5 Preview är Tencents enhetliga modell för bildgenerering och bildredigering. Den tar emot en skriftlig brief med valfria referensbilder och stöder att samma visuella uppgift fortsätter över flera omgångar. Resultatet är en bild för en definierad scen, komposition eller redigering. Tencents exempel omfattar produktbilder, kampanjaffischer, visualiseringar av gränssnittsdesign och materialkoncept. Välj om uppgiften behöver en ny bild, en komposition som vägleds av referenser eller en avgränsad ändring av ett befintligt resultat.
Producenten identifierar utgåvan som hy-image-v3.5-preview och dokumenterar en promptgräns på 100K token. Indata är en kronologisk konversation med text och bilder, där det sista användarmeddelandet ger den aktuella instruktionen. Tidigare meddelanden ger sammanhang för iterativ redigering. Detta skiljer sig från HY Image 3.0:s arbetsflöde med en enda prompt och dess separata indatagränser. För en fortlöpande designuppgift behåller du den relevanta briefen, referensernas roller och den valda bilden så att nästa instruktion kan bygga vidare på det avsedda visuella tillståndet.
Förbered referensbilder i PNG eller JPEG/JPG. Referensindata kan innehålla upp till 20 bilder, vardera högst 20 MB i det dokumenterade arbetsflödet. En bild kan tillhandahållas som en refererad eller kodad tillgång. Om konversationen innehåller för många bilder beskriver producentens guide att äldre bilder tas bort först. Håll den aktiva referensuppsättningen fokuserad i stället för att förlita dig på att varje historisk bild finns kvar i sammanhanget. Kontrollen för storleksändring av indata bevarar mindre bilder och skalar större proportionellt mot en målarea i pixlar; standardmålet är 1 048 576 pixlar. Bevara tillräckligt med synliga detaljer för den produkt, det material eller den layout som ska vägleda resultatet.
Utmatningsstorleken har två skilda sätt att förberedas. Vid automatisk storleksanpassning anger generate_max_pixels en målarea: 1 048 576 pixlar för nivån 1K, 2 359 296 för standardnivån 1.5K eller 4 194 304 för 2K. Producentens FAQ anger att en inställning med enbart målarea som standard ger ett kvadratiskt bildförhållande. När båda storlekskontrollerna utelämnas använder modellen briefen och standardnivån 1.5K. Dessa nivåer skapar ingen automatisk 4K-inställning. Använd en areanivå när en kvadratisk bild passar uppgiften. För att låta briefen styra proportionerna vid standardnivån 1.5K utelämnar du båda storlekskontrollerna; begär uttryckliga mått när layouten kräver en specifik stående eller bred storlek.
För uttryckliga mått tillåter producenten positiva heltal för sidorna från 256 till 8192 pixlar, med en total area på högst 16 777 216 pixlar. En kvadrat på 4096 × 4096 uppfyller den gränsen. Sidintervallet och areataket gäller tillsammans, så en kant på 8192 pixlar tillåter inte en bild på 8192 × 8192. Begär uttryckligen den bredd och höjd som behövs när slutlayouten kräver en specifik storlek, i stället för att anta att en målareanivå ger samma mått. Gör beskärningskänsliga detaljer och det nödvändiga tomrummet tydliga i prompten.
Modellen stöder redigering i flera omgångar genom den returnerade konversationshistoriken. Tencent skiljer den slutligt levererade bilden från den mellanliggande bild som används som sammanhang för nästa redigering, och exemplen behåller assistentens resonemang, verktygsbegäran och resultatet med den genererade bilden när arbetet fortsätter. För en produktkomposition etablerar du först motivet och inramningen; be sedan om ändrad ljussättning eller en ny bakgrund och ange vad som ska behålla sitt utseende. Håll ihop det valda resultatet och dess historik så att nästa omgång arbetar med den bilden i stället för en bortvald variant. I Tencents dokumenterade arbetsflöde upphör både länken till slutbilden och länken till historikbilden att gälla efter 12 timmar, så spara bildmaterialet innan du förlitar dig på det för en senare redigering.
De dokumenterade kontrollerna omfattar ett seed, en egen vattenmärkesfotnot på upp till 16 tecken och valfri utökning med extern sökning, som är avstängd som standard. Seed-värdet är ett icke-negativt heltal; noll eller ett utelämnat värde låter producenten välja slumpmässigt. Dessa kontroller har andra syften än själva briefen. För en referensbaserad produktbild beskriver du produktens utseende, kameravinkel, yta, ljussättning och avsedda layout och använder sedan referensen för att vägleda de identifierande detaljerna. För en affisch anger du hierarkin och den exakta texten i stället för att låta dess budskap hittas på.
Tencents praktiska vägledning rekommenderar kontroll av text och layout, särskilt när produktspecifikationer, organisationsnamn eller annan faktatext är viktiga. Granska den färdiga bilden avseende motiv, proportioner, material, beskärning och text. Spara slutmaterialet tillsammans med brief och inställningar, och använd en konkret instruktion kopplad till ett synligt problem vid nästa redigering.
Ailoot Ultra · Bilder POST /v1/images/generations tencent/hy-image-v3.5-preview
tencent/hy-image-v3.5-previewStart
HY Image 3.5 Preview kombinerar text-till-bild-generering, referensbaserat skapande och redigering i flera omgångar. Tencent dokumenterar upp till 20 referensbilder, automatiskt storleksval och uttryckliga utmatningsstorlekar upp till en bild på 4096 × 4096 för detaljerat visuellt arbete.
- Godkända indata
- Text · Bilder
- Resultat
- Bilder
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Bilder POST /v1/images/generations
- Indatatyper
text,image- Utdatatyper
image
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser tencent/hy-image-v3.5-preview | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 | Standard— |
Fältresolution | Typstring | KravValfritt | Värden & gränser 1K, 1.5K, 2K, 4K | Standard— |
Fältaspect_ratio | Typstring | KravValfritt | Värden & 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— |
Fältn | Typinteger | KravValfritt | Värden & gränser Minimum: 1 Maximum: 1 | Standard— |
Fältinput_references | Typarray | KravValfritt | Värden & gränser Minsta antal objekt: 0 Maximalt antal objekt: 20 | Standard— |
Fältprovider | Typobject | KravValfritt | Värden & gränser | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parametermaterial_types | Avtaltext, image |
Livscykel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Debiteringsenhet | Avgift |
|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Debiteringsenhet— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| Konfigurationbildutdatatoken | Prislista— | Prognostiserad mängd— | Debiteringsenhet/ 1K bildtoken | Avgift Utdata · bildutdatatoken · Uppskattning endast för jämförelse $0.0032 / 1K bildtoken |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Debiteringsenhet— | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.0131072 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Bilder
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
Ta emot och spara resultat
Ailoot Ultra · Bilder
Ladda ned varje returnerad bild eller spara dess Base64-innehåll
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Andra innehållsläsningar
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.
Behåll alla färdiga resultat
Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.
Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.
Om det ursprungliga svaret behöver kontrolleras
Behåll det returnerade värdet för X-Client-Request-ID för avstämning. Läs endast av resultat via de task_id/asset_id-värden som faktiskt returnerades eller via det mediebibliotek som tillhör dig. Bygg aldrig en uppgifts-URL från operations-ID:t och skicka aldrig skapandeförfrågan igen.
Svarsfält
| Fält | Typ |
|---|---|
Fältcreated | Typ |
Fältdata[].url | Typ |
Fältdata[].b64_json | Typ |
Fältusage | Typ |
Alias
Modellalias
Ailoot Ultra tencent/hy-image-v3.5-preview
Alias för metodsökvägar
/v1/images
Relaterade anropar-ID:n
FAQ · Tencent: Hy Image 3.5 Preview
- Vilka indata och resultat finns?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:text,image→image- Vilka fält använder begäran?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:model,prompt,resolution,aspect_ratio,n,input_references,provider- Vilka gränser gäller?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:n.minimum:1;n.maximum:1