Hy Image 3.5 Preview API
Tencent Hy Image 3.5 Preview is een preview-model voor tekst-naar-beeld en beeldbewerking, gericht op professionele commerciële beeldcreatie met sterke Chinese taalbegrip.
Tencent Hy Image 3.5 Preview is een preview-release van Tencent voor het genereren en bewerken van beelden. Het model accepteert tekst- en beeldinvoer en levert beeldoutput, met ondersteuning voor tekst-naar-beeld-generatie en beeld-naar-beeld-bewerking. Per verzoek kunnen maximaal 5 referentieafbeeldingen worden meegegeven, en het model ondersteunt meerturnige conversationele creatie en bewerking op basis van eerdere context. Het is beschikbaar in Tencent Yuanbao en ima, geïntegreerd in de Tencent Cloud ADP-workbench en via partnernodes in ComfyUI voor tekst-naar-beeld en beeldbewerking. De API gebruikt het Chat/Messages-protocol met multi-image input, meerturnige bewerkingscontext en chain-of-thought-herschrijving; de API-model-ID is hy-image-v3.5-preview.
Het model is geschikt voor taken zoals advertentievisuals, infographics, UI-ontwerp, fotoretouche, portretverfraaiing, kenniskaarten, commerciële posters, episode-storyboards, film- en tv-materiaal, creatieve illustraties, merkvisuals en e-commerce-materiaal. Het biedt meertalige tekstweergave en typografie, fotorealistische weergave van huidtextuur, stofweefsel en rim lighting, en consistente bewerking op basis van referentieafbeeldingen. Volgens Tencent ligt de algehele capaciteit ongeveer 30% hoger dan de vorige generatie in interne tests, en het model wordt gepositioneerd als kosteneffectief voor professionele beeldcreatie in plaats van als koploper in benchmarkscores. Het heeft een sterk begrip van Chinese semantiek en een realistische stijl die geschikt is voor commerciële oplevering.
Let op: dit is een preview-release, geen definitieve stabiele GA-versie; gedrag, limieten en prijzen kunnen veranderen. De claim van 30% verbetering is gebaseerd op Tencent's eigen evaluatie en vereist onafhankelijke verificatie. Automatische groottekeuze kan per run verschillende oriëntaties opleveren; handmatige grootte-instelling wordt aanbevolen in productie. Prijsstelling en stabiliteit voor 4K zijn in de preview-fase onduidelijk.
Bijgewerkt:
MODEL-ID
hy-image-v3.5-preview- Invoer
- text / image
- Uitvoer
- image
Hoogtepunten
- Tekst-naar-beeld en beeld-naar-beeld-bewerking
- Maximaal 5 referentieafbeeldingen per verzoek
- Meerturnige conversationele creatie
- Uitvoerresoluties van 1K, 2K en 4K
- Meertalige tekstweergave en typografie
- Fotorealistische huid- en stofweergave
Aanbieders
Vergelijk API-prijzen tussen aanbieders. Kies een aanbieder om alle kosten en voorwaarden te bekijken.
| Beschikbaarheid | |
|---|---|
Historische gegevens zijn geen live statuscontrole. Ontbrekende gegevens betekenen geen storing.
Snelstart
Verstuur een afbeeldingstaak, controleer de status en sla de afbeeldingen op. De voorbeelden gebruiken curl en de standaardbibliotheek van Python 3.
POST https://openapi.felo.ai/api/v1/images/generations
1API-sleutel instellen
Maak een sleutel in je Felo API Platform-account en stel deze in als omgevingsvariabele.
export FELO_API_KEY="YOUR_API_KEY"2Je eerste aanvraag doen
Optionele waarden verschillen per model en zijn hier niet ingesteld. Controleer ze in Playground. Velden staan naast model en prompt, zonder input-omslag.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
"model": "hy-image-v3.5-preview"
}'3Taak pollen
De aanvraag retourneert task_id. Controleer elke 3 seconden bij queued of running; stop bij succeeded, failed of interrupted. Maximaal 30 minuten wachten. Bewaar created.json om dezelfde taak verder op te vragen zonder opnieuw te versturen.
python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen
task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800
while task["status"] in ("queued", "running"):
if time.monotonic() >= deadline:
raise TimeoutError(f"Keep task_id={task_id} to resume polling")
time.sleep(3)
with urlopen(Request(url, headers=headers), timeout=60) as response:
task = json.load(response)
if task.get("task_id") != task_id or task.get("kind") != "image":
raise ValueError("Unexpected task response")
print(task["status"])
if task["status"] != "succeeded":
raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY4Uitvoer downloaden
Sla na succes outputs uit task.json op. HTTPS-URL’s, URL-objecten en b64_json worden ondersteund. Download ondertekende URL’s tijdig; daarvoor is geen API-sleutel nodig.
python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen
task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}
for index, output in enumerate(task["outputs"], 1):
item = output if isinstance(output, dict) else {}
url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
mime = item.get("media_type") or "image/png"
if url and url.startswith("https://"):
with urlopen(url, timeout=60) as response:
data = response.read()
mime = response.headers.get_content_type()
elif url and url.startswith("data:image/") and ";base64," in url:
header, encoded = url.split(",", 1)
mime = header[5:].split(";", 1)[0]
data = base64.b64decode(encoded, validate=True)
elif item.get("b64_json"):
data = base64.b64decode(item["b64_json"], validate=True)
else:
raise ValueError("Unrecognized image output")
path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
path.write_bytes(data)
print(path)
PYinput_references
Vervang voor bewerking de voorbeeld-URL door je HTTPS-afbeeldings-URL of een base64-afbeeldings-data-URL. Verstuur één keer en volg dezelfde controle- en opslagstappen.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
"model": "hy-image-v3.5-preview",
"input_references": [
{
"type": "image_url",
"image_url": {
"url": "https://example.com/product.png"
}
}
]
}'Ondersteunde parameters
- n
- seed
- size
- resolution
- aspect_ratio
- input_references
Liever de volledige referentie?
API-referentie →Veelgestelde vragen
Wat is Hy Image 3.5 Preview?
Tencent Hy Image 3.5 Preview is een preview-release van Tencent voor het genereren en bewerken van beelden. Het model accepteert tekst- en beeldinvoer en levert beeldoutput, met ondersteuning voor tekst-naar-beeld-generatie en beeld-naar-beeld-bewerking. Per verzoek kunnen maximaal 5 referentieafbeeldingen worden meegegeven, en het model ondersteunt meerturnige conversationele creatie en bewerking op basis van eerdere context. Het is beschikbaar in Tencent Yuanbao en ima, geïntegreerd in de Tencent Cloud ADP-workbench en via partnernodes in ComfyUI voor tekst-naar-beeld en beeldbewerking. De API gebruikt het Chat/Messages-protocol met multi-image input, meerturnige bewerkingscontext en chain-of-thought-herschrijving; de API-model-ID is hy-image-v3.5-preview. Het model is geschikt voor taken zoals advertentievisuals, infographics, UI-ontwerp, fotoretouche, portretverfraaiing, kenniskaarten, commerciële posters, episode-storyboards, film- en tv-materiaal, creatieve illustraties, merkvisuals en e-commerce-materiaal. Het biedt meertalige tekstweergave en typografie, fotorealistische weergave van huidtextuur, stofweefsel en rim lighting, en consistente bewerking op basis van referentieafbeeldingen. Volgens Tencent ligt de algehele capaciteit ongeveer 30% hoger dan de vorige generatie in interne tests, en het model wordt gepositioneerd als kosteneffectief voor professionele beeldcreatie in plaats van als koploper in benchmarkscores. Het heeft een sterk begrip van Chinese semantiek en een realistische stijl die geschikt is voor commerciële oplevering. Let op: dit is een preview-release, geen definitieve stabiele GA-versie; gedrag, limieten en prijzen kunnen veranderen. De claim van 30% verbetering is gebaseerd op Tencent's eigen evaluatie en vereist onafhankelijke verificatie. Automatische groottekeuze kan per run verschillende oriëntaties opleveren; handmatige grootte-instelling wordt aanbevolen in productie. Prijsstelling en stabiliteit voor 4K zijn in de preview-fase onduidelijk.
Hoe wordt het gebruik gefactureerd?
Je factuur hangt af van de aanbieder die je gebruikt, de prijzen en je verbruik. Langere invoer of andere voorwaarden kunnen andere prijzen hebben.
Welke invoer en uitvoer ondersteunt Hy Image 3.5 Preview?
Het model accepteert tekst- en beeldinvoer en levert beeldoutput. Per verzoek kunnen maximaal 5 referentieafbeeldingen worden meegegeven.
Voor welke taken is het model geschikt?
Het is bedoeld voor professionele beeldcreatie, zoals advertentievisuals, infographics, UI-ontwerp, fotoretouche, portretverfraaiing, kenniskaarten, commerciële posters, storyboards, film- en tv-materiaal, creatieve illustraties, merkvisuals en e-commerce-materiaal.
Ondersteunt het model meerturnige bewerking?
Ja, het ondersteunt meerturnige conversationele creatie en bewerking op basis van eerdere context. De API gebruikt het Chat/Messages-protocol met meerturnige bewerkingscontext.
Welke uitvoerresoluties zijn mogelijk?
Het model ondersteunt uitvoerresoluties van 1K, 2K en 4K en meerdere beeldverhoudingen.
Hoe verhoudt dit model zich tot de vorige generatie?
Volgens Tencent ligt de algehele capaciteit ongeveer 30% hoger dan de vorige generatie in interne tests. Deze claim is gebaseerd op Tencent's eigen evaluatie en vereist onafhankelijke verificatie.
Is dit een definitieve versie?
Nee, het is een preview-release, geen definitieve stabiele GA-versie. Gedrag, limieten en prijzen kunnen veranderen.