Tencent: Hy Image 3.5 Preview
HY Image 3.5 Preview combineert tekst-naar-beeldgeneratie, creatie op basis van referenties en bewerking over meerdere gespreksbeurten. Tencent documenteert maximaal 20 referentieafbeeldingen, automatische formaatkeuze en expliciete uitvoerformaten tot een afbeelding van 4096 × 4096 voor gedetailleerd visueel werk.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
HY Image 3.5 Preview is het uniforme model van Tencent voor het genereren en bewerken van afbeeldingen. Het accepteert een geschreven briefing met optionele referentieafbeeldingen en ondersteunt het voortzetten van dezelfde visuele taak over meerdere gespreksbeurten. Het resultaat is een afbeelding voor een bepaalde scène, compositie of bewerking. De voorbeelden van Tencent omvatten productbeelden, campagneposters, visualisaties van interfaceontwerpen en materiaalconcepten. Bepaal of de taak een nieuwe afbeelding, een compositie met referenties als uitgangspunt of een gerichte wijziging van een bestaand resultaat vereist.
De producent noemt de editie hy-image-v3.5-preview en documenteert een promptlimiet van 100K tokens. De invoer is een chronologisch gesprek met tekst en afbeeldingen, waarbij het laatste gebruikersbericht de actuele instructie bevat. Eerdere berichten bieden context voor iteratieve bewerking. Dit verschilt van de workflow met één prompt van HY Image 3.0 en de bijbehorende afzonderlijke invoerlimieten. Bewaar voor een doorlopende ontwerptaak de relevante briefing, de rollen van de referenties en de gekozen afbeelding, zodat de volgende instructie kan voortbouwen op de bedoelde visuele toestand.
Bereid referentieafbeeldingen in PNG of JPEG/JPG voor. De referentie-invoer mag in de gedocumenteerde workflow maximaal 20 afbeeldingen bevatten, elk niet groter dan 20 MB. Een afbeelding kan als bestand via een verwijzing of als gecodeerd bestand worden aangeleverd. Als het gesprek te veel afbeeldingen bevat, beschrijft de handleiding van de producent dat oudere afbeeldingen als eerste worden verwijderd. Houd de actieve referenties gericht en vertrouw er niet op dat elk historisch beeld in de context blijft. De instelling voor het aanpassen van de invoergrootte behoudt kleinere afbeeldingen en schaalt grotere proportioneel naar een beoogd pixeloppervlak; het standaarddoel is 1,048,576 pixels. Behoud voldoende zichtbare details voor het product, materiaal of de opmaak die het resultaat moet sturen.
Er zijn twee verschillende manieren om het uitvoerformaat voor te bereiden. Bij automatische formaatkeuze bepaalt generate_max_pixels een beoogd oppervlak: 1,048,576 pixels voor het niveau 1K, 2,359,296 voor het standaardniveau 1.5K of 4,194,304 voor 2K. Volgens de FAQ van de producent geldt standaard een vierkante verhouding wanneer alleen een instelling voor het beoogde oppervlak wordt opgegeven. Als beide formaatinstellingen ontbreken, gebruikt het model de briefing en het standaardniveau 1.5K. Deze niveaus leveren geen automatische 4K-instelling op. Gebruik een oppervlakteniveau wanneer een vierkante afbeelding bij de taak past. Laat beide formaatinstellingen weg om de briefing de verhoudingen op het standaardniveau 1.5K te laten bepalen; vraag expliciete afmetingen aan wanneer de opmaak een bepaald staand of breed formaat vereist.
Voor expliciete afmetingen staat de producent positieve gehele zijlengtes van 256 tot 8192 pixels toe, met een totaal oppervlak van maximaal 16,777,216 pixels. Een vierkant van 4096 × 4096 voldoet aan die limiet. Het bereik voor de zijlengtes en het maximale oppervlak gelden samen, dus een zijde van 8192 pixels betekent niet dat een afbeelding van 8192 × 8192 is toegestaan. Vraag de benodigde breedte en hoogte expliciet aan wanneer de uiteindelijke opmaak een bepaald formaat vereist, in plaats van aan te nemen dat een niveau voor het beoogde oppervlak dezelfde afmetingen oplevert. Benoem in de prompt de details die bij uitsnijden behouden moeten blijven en de vereiste vrije ruimte.
Het model ondersteunt bewerking over meerdere gespreksbeurten via de teruggegeven gespreksgeschiedenis. Tencent maakt onderscheid tussen de uiteindelijk geleverde afbeelding en de tussentijdse afbeelding die als context voor de volgende bewerking wordt gebruikt. De voorbeelden behouden bij het voortzetten de redenering van de assistent, het toolverzoek en het gegenereerde beeldresultaat. Leg voor een productcompositie eerst het onderwerp en de kadrering vast; vraag daarna om een andere belichting of achtergrond en geef aan wat er hetzelfde moet blijven uitzien. Bewaar het gekozen resultaat samen met de geschiedenis, zodat de volgende beurt op die afbeelding voortbouwt en niet op een verworpen variant. In de gedocumenteerde workflow van Tencent verlopen zowel de uiteindelijke afbeeldingslinks als die uit de geschiedenis na 12 uur. Bewaar de beeldbestanden daarom voordat je erop vertrouwt voor een latere bewerking.
De gedocumenteerde instellingen omvatten een seed, een eigen watermerkvoetnoot van maximaal 16 tekens en optionele aanvulling via extern zoeken, die standaard uitstaat. De seed is een niet-negatief geheel getal; bij nul of weglaten kiest de producent willekeurig. Deze instellingen dienen andere doelen dan de briefing zelf. Beschrijf voor een productbeeld op basis van een referentie het uiterlijk van het product, de camerahoek, het oppervlak, de belichting en de beoogde opmaak. Gebruik vervolgens de referentie om de herkenningsdetails te sturen. Geef voor een poster de hiërarchie en exacte tekst, in plaats van de boodschap te laten verzinnen.
De praktische richtlijnen van Tencent adviseren om tekst en opmaak te controleren, vooral waar productspecificaties, organisatienamen of andere feitelijke formuleringen ertoe doen. Controleer de voltooide afbeelding op onderwerp, verhoudingen, materiaal, uitsnede en belettering. Bewaar het uiteindelijke bestand met de briefing en instellingen en gebruik voor de volgende bewerking een concrete instructie die is gekoppeld aan een zichtbaar probleem.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations tencent/hy-image-v3.5-preview
tencent/hy-image-v3.5-previewAan de slag
HY Image 3.5 Preview combineert tekst-naar-beeldgeneratie, creatie op basis van referenties en bewerking over meerdere gespreksbeurten. Tencent documenteert maximaal 20 referentieafbeeldingen, automatische formaatkeuze en expliciete uitvoerformaten tot een afbeelding van 4096 × 4096 voor gedetailleerd visueel werk.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoertypen
text,image- Uitvoertypen
image
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten tencent/hy-image-v3.5-preview | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 1K, 1.5K, 2K, 4K | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 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 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 1 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 20 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| Configuratieafbeeldingsuitvoertoken | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheid/ 1K afbeeldingstokens | Kosten Uitvoer · afbeeldingsuitvoertoken · Schatting uitsluitend ter vergelijking $0.0032 / 1K afbeeldingstokens |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.0131072 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Afbeeldingen
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
Resultaten ophalen en opslaan
Ailoot Ultra · Afbeeldingen
Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
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.
Alle voltooide resultaten bewaren
Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra tencent/hy-image-v3.5-preview
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Tencent: Hy Image 3.5 Preview
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:model,prompt,resolution,aspect_ratio,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·tencent/hy-image-v3.5-preview:n.minimum:1;n.maximum:1