Hy Image 3.5 Preview API
Model penjanaan dan penyuntingan imej pratonton daripada Tencent yang menyokong input teks dan imej, sehingga 5 imej rujukan, serta output sehingga 4K untuk kegunaan kreatif profesional.
Hy Image 3.5 Preview ialah model imej daripada Tencent yang tersedia dalam versi pratonton. Ia menerima input teks dan imej serta menghasilkan output imej, dengan sokongan penjanaan teks-ke-imej dan penyuntingan imej-ke-imej. Setiap permintaan boleh membawa sehingga 5 imej rujukan, dan model ini menyokong penciptaan serta penyuntingan percakapan berbilang pusingan berdasarkan konteks sebelumnya. Output boleh dijana dalam pelbagai nisbah aspek pada resolusi 1K, 2K dan 4K, dengan keupayaan pemaparan teks dan tipografi berbilang bahasa.
Model ini sesuai untuk tugasan kreatif komersial seperti visual pengiklanan, infografik, reka bentuk UI, retouching foto, kecantikan potret, kad pengetahuan, poster komersial, papan cerita episod, bahan filem dan TV, ilustrasi kreatif, visual jenama serta bahan e-dagang. Ia juga menyokong penyuntingan imej rujukan yang konsisten dan pemaparan realistik tekstur kulit, tenunan fabrik serta pencahayaan rim, menjadikannya sesuai untuk penghasilan komersial yang menuntut hasil realistik.
Dari segi prestasi, Tencent menyatakan keupayaan keseluruhan model ini kira-kira 30% lebih tinggi daripada generasi sebelumnya dalam ujian dalaman mereka, dan ia diposisikan sebagai model kos efektif untuk penciptaan imej profesional. Syarikat juga menyatakan keupayaannya setanding Seedream 5.0 Pro dan sedikit lebih baik daripada Nano-Banana Pro serta Qwen-Image-3.0 Pro. Masa penjanaan median kira-kira 15.5 saat, imej persegi 2K mengambil masa kira-kira 20 saat, manakala penyuntingan kira-kira 23 saat. Sebagai keluaran pratonton, tingkah laku, had dan harga masih boleh berubah, dan dakwaan peningkatan 30% itu perlu pengesahan bebas.
Dikemas kini:
ID MODEL
hy-image-v3.5-preview- Input
- text / image
- Output
- image
Sorotan
- Sehingga 5 imej rujukan setiap permintaan
- Output 1K, 2K dan 4K
- Penyuntingan percakapan berbilang pusingan
- Pemaparan teks berbilang bahasa
- Tekstur kulit dan fabrik realistik
- Tersedia dalam Yuanbao, ima dan ADP
Penyedia
Bandingkan harga API merentas penyedia. Pilih penyedia untuk melihat semua caj dan syarat.
| Ketersediaan | |
|---|---|
Statistik sejarah bukan pemeriksaan langsung. Ketiadaan data tidak bermaksud gangguan.
Mula pantas
Hantar tugas imej, semak status, kemudian simpan imej. Contoh menggunakan curl dan pustaka standard Python 3.
POST https://openapi.felo.ai/api/v1/images/generations
1Tetapkan kunci API
Cipta kunci daripada akaun Felo API Platform anda dan tetapkan sebagai pemboleh ubah persekitaran.
export FELO_API_KEY="YOUR_API_KEY"2Hantar permintaan pertama
Nilai pilihan berbeza mengikut model dan tidak ditetapkan di sini. Semak dalam Playground. Medan sejajar dengan model dan prompt, tanpa pembalut input.
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"
}'3Tinjau tugas
Penghantaran mengembalikan task_id. Semak setiap 3 saat semasa queued atau running; berhenti pada succeeded, failed atau interrupted. Tunggu maksimum 30 minit. Simpan created.json untuk menyambung semakan tanpa menghantar semula.
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")
PY4Muat turun output
Selepas berjaya, simpan outputs daripada task.json. Menyokong URL HTTPS, objek URL dan b64_json. Muat turun URL bertandatangan segera; muat turun imej tidak memerlukan kunci API.
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
Untuk menyunting imej, ganti URL contoh dengan URL imej HTTPS atau data URL imej base64 anda. Hantar sekali, kemudian gunakan langkah semakan dan penyimpanan yang sama.
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"
}
}
]
}'Parameter yang disokong
- n
- seed
- size
- resolution
- aspect_ratio
- input_references
Mahukan rujukan penuh?
Rujukan API →Soalan lazim
Mengenali Hy Image 3.5 Preview?
Hy Image 3.5 Preview ialah model imej daripada Tencent yang tersedia dalam versi pratonton. Ia menerima input teks dan imej serta menghasilkan output imej, dengan sokongan penjanaan teks-ke-imej dan penyuntingan imej-ke-imej. Setiap permintaan boleh membawa sehingga 5 imej rujukan, dan model ini menyokong penciptaan serta penyuntingan percakapan berbilang pusingan berdasarkan konteks sebelumnya. Output boleh dijana dalam pelbagai nisbah aspek pada resolusi 1K, 2K dan 4K, dengan keupayaan pemaparan teks dan tipografi berbilang bahasa. Model ini sesuai untuk tugasan kreatif komersial seperti visual pengiklanan, infografik, reka bentuk UI, retouching foto, kecantikan potret, kad pengetahuan, poster komersial, papan cerita episod, bahan filem dan TV, ilustrasi kreatif, visual jenama serta bahan e-dagang. Ia juga menyokong penyuntingan imej rujukan yang konsisten dan pemaparan realistik tekstur kulit, tenunan fabrik serta pencahayaan rim, menjadikannya sesuai untuk penghasilan komersial yang menuntut hasil realistik. Dari segi prestasi, Tencent menyatakan keupayaan keseluruhan model ini kira-kira 30% lebih tinggi daripada generasi sebelumnya dalam ujian dalaman mereka, dan ia diposisikan sebagai model kos efektif untuk penciptaan imej profesional. Syarikat juga menyatakan keupayaannya setanding Seedream 5.0 Pro dan sedikit lebih baik daripada Nano-Banana Pro serta Qwen-Image-3.0 Pro. Masa penjanaan median kira-kira 15.5 saat, imej persegi 2K mengambil masa kira-kira 20 saat, manakala penyuntingan kira-kira 23 saat. Sebagai keluaran pratonton, tingkah laku, had dan harga masih boleh berubah, dan dakwaan peningkatan 30% itu perlu pengesahan bebas.
Bagaimana penggunaan dicaj?
Bil anda bergantung pada penyedia yang anda gunakan, harganya dan penggunaan anda. Input yang lebih panjang atau syarat lain mungkin dikenakan harga berbeza.
Apakah jenis input yang disokong oleh Hy Image 3.5 Preview?
Model ini menerima input teks dan imej, serta menghasilkan output imej. Ia menyokong penjanaan teks-ke-imej dan penyuntingan imej-ke-imej.
Berapa banyak imej rujukan boleh dihantar dalam satu permintaan?
Sehingga 5 imej rujukan dibenarkan bagi setiap permintaan.
Apakah resolusi output yang tersedia?
Output boleh dijana pada resolusi 1K, 2K dan 4K, dengan sokongan pelbagai nisbah aspek.
Apakah tugas yang paling sesuai untuk model ini?
Model ini sesuai untuk visual pengiklanan, infografik, reka bentuk UI, retouching foto, kecantikan potret, kad pengetahuan, poster komersial, papan cerita episod, bahan filem dan TV, ilustrasi kreatif, visual jenama serta bahan e-dagang.
Adakah model ini menyokong penyuntingan berbilang pusingan?
Ya, ia menyokong penciptaan dan penyuntingan percakapan berbilang pusingan berdasarkan konteks sebelumnya, dengan API yang menggunakan protokol Chat/Messages.
Bagaimana prestasi Hy Image 3.5 Preview berbanding model lain?
Tencent menyatakan keupayaannya setanding Seedream 5.0 Pro dan sedikit lebih baik daripada Nano-Banana Pro serta Qwen-Image-3.0 Pro. Keupayaan keseluruhannya dilaporkan kira-kira 30% lebih tinggi daripada generasi sebelumnya dalam ujian dalaman Tencent.