modeller

Tencent: Hy Image 3.5 Preview

Markdown · JSON

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-preview

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

Start

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ältTypKravVärden & gränserStandard
FältmodelTypstringKravObligatorisktVärden & gränser
tencent/hy-image-v3.5-preview
Standard—
FältpromptTypstringKravObligatorisktVärden & gränser
Minsta längd: 1
Standard—
FältresolutionTypstringKravValfrittVärden & gränser
1K, 1.5K, 2K, 4K
Standard—
Fältaspect_ratioTypstringKravValfrittVä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ältnTypintegerKravValfrittVärden & gränser
Minimum: 1
Maximum: 1
Standard—
Fältinput_referencesTyparrayKravValfrittVärden & gränser
Minsta antal objekt: 0
Maximalt antal objekt: 20
Standard—
FältproviderTypobjectKravValfrittVärden & gränserStandard—
Metodparametrar och livscykel
ParameterAvtal
Parametercontent_typeAvtalapplication/json
ParameterrequiredAvtalmodel, prompt
Parametermaterial_typesAvtaltext, 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.

KonfigurationPrislistaPrognostiserad mängdDebiteringsenhetAvgift
KonfigurationGrundpriser för tokenPrislistaGrundprisPrognostiserad 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
KonfigurationbildutdatatokenPrislista—Prognostiserad mängd—Debiteringsenhet/ 1K bildtokenAvgift
Utdata · bildutdatatoken · Uppskattning endast för jämförelse $0.0032 / 1K bildtoken
KonfigurationUppskattad genereringskostnadPrislista—Prognostiserad mängduppskattning för en genereringDebiteringsenhet—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

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

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}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Andra innehållsläsningar
Läs befintliga resurser som tillhör dig
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ältTyp
FältcreatedTyp
Fältdata[].urlTyp
Fältdata[].b64_jsonTyp
FältusageTyp

Alias

Modellalias

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

Alias för metodsökvägar

/v1/images

Relaterade anropar-ID:n

tencent/hy-image-v3.5-preview

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

Fler detaljer

Anslut Ailoot till Claude Code, OpenCode, Hermes eller din app.

Företaget och dess projektportfölj

Företaget och dess projektportfölj: miljontals kunder; månatlig försäljning för miljarder.

Köp token med rabatt.

Prenumerationsrabatt för återkommande arbete. Kampanjkoder ger upp till 50% vid tokenköp.

Prenumeration
Välj en rabatterad plan för återkommande anrop.
Kampanjkod upp till 50%
Ange koden vid köpet. Priset räknas om enligt kampanjen.
Kostnader i historiken
Modell, token och belopp sparas för varje anrop.

Välj prenumeration · Se modellpriser

Anslut API till produkten som du säljer.

SaaS, appar och botar enligt Ailoots officiella villkor och licensavtal. Begär återförsäljarlicens för vidareförsäljning.

Kommersiell applikation
Bygg text-, bild-, video- och ljudgenerering i tjänstens betalda funktioner.
Återförsäljarlicens
Skicka projektbeskrivning och åtkomstupplägg. Begär skriftliga villkor för användning och vidareförsäljning.
Dokument på webbplatsen
Officiella villkor, licensavtal och databehandlingspolicy finns tillgängliga före anslutning.

Begär återförsäljarlicens · Officiella villkor och licensavtal