Hy Image 3.5 Preview API
Model pembuatan gambar dari Tencent yang mendukung input teks dan gambar, menghasilkan gambar hingga 4K untuk kebutuhan kreatif profesional.
Hy Image 3.5 Preview adalah model pembuatan dan penyuntingan gambar dari Tencent yang menerima input teks maupun gambar dan menghasilkan gambar. Model ini dapat menerima hingga 5 gambar referensi per permintaan, mendukung pembuatan dan penyuntingan multi-giliran berdasarkan konteks sebelumnya, serta menyediakan berbagai rasio aspek keluaran dengan resolusi 1K, 2K, dan 4K.
Model ini kuat dalam pemahaman semantik bahasa Mandarin, rendering teks multibahasa dan tipografi, serta rendering fotorealistis untuk tekstur kulit, serat kain, dan pencahayaan tepi. Penyuntingan dengan gambar referensi juga dijaga konsistensinya. API-nya menggunakan protokol Chat/Messages dengan input multi-gambar, konteks sunting multi-giliran, dan penulisan ulang chain-of-thought.
Hy Image 3.5 Preview diposisikan sebagai model hemat biaya untuk pembuatan gambar profesional, bukan sebagai pemimpin skor benchmark. Model ini cocok untuk visual iklan, infografis, desain UI, retouching foto, papan cerita episode, materi film dan TV, ilustrasi kreatif, visual merek, serta materi e-commerce. Karena masih berstatus pratinjau, perilaku, batasan, dan harga dapat berubah.
Diperbarui:
ID MODEL
hy-image-v3.5-preview- Masukan
- text / image
- Keluaran
- image
Sorotan
- Input teks dan gambar, keluaran gambar
- Hingga 5 gambar referensi per permintaan
- Penyuntingan multi-giliran dengan konteks
- Resolusi keluaran 1K, 2K, dan 4K
- Rendering teks multibahasa
- Waktu pembuatan median sekitar 15,5 detik
Penyedia
Bandingkan harga API antarpenyedia. Pilih penyedia untuk melihat semua biaya dan ketentuan.
| Ketersediaan | |
|---|---|
Statistik historis bukan pemeriksaan langsung. Data yang hilang tidak berarti gangguan.
Mulai cepat
Kirim tugas gambar, periksa status, lalu simpan gambar. Contoh menggunakan curl dan pustaka standar Python 3.
POST https://openapi.felo.ai/api/v1/images/generations
1Siapkan kunci API
Buat kunci dari akun Felo API Platform Anda dan tetapkan sebagai variabel lingkungan.
export FELO_API_KEY="YOUR_API_KEY"2Kirim permintaan pertama
Nilai opsional berbeda per model dan tidak ditetapkan di sini. Periksa di Playground. Kolom sejajar dengan model dan prompt, tanpa pembungkus 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"
}'3Polling tugas
Pengiriman mengembalikan task_id. Periksa setiap 3 detik saat queued atau running; berhenti saat succeeded, failed, atau interrupted. Tunggu maksimal 30 menit. Simpan created.json untuk melanjutkan pemeriksaan tanpa mengirim ulang.
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")
PY4Unduh output
Setelah berhasil, simpan outputs dari task.json. Mendukung URL HTTPS, objek URL, dan b64_json. Segera unduh URL bertanda tangan; unduhan gambar 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 mengedit gambar, ganti URL contoh dengan URL gambar HTTPS atau data URL gambar base64 Anda. Kirim sekali, lalu ikuti langkah pemeriksaan 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 didukung
- n
- seed
- size
- resolution
- aspect_ratio
- input_references
Ingin referensi lengkap?
Referensi API →Pertanyaan umum
Mengenal Hy Image 3.5 Preview?
Hy Image 3.5 Preview adalah model pembuatan dan penyuntingan gambar dari Tencent yang menerima input teks maupun gambar dan menghasilkan gambar. Model ini dapat menerima hingga 5 gambar referensi per permintaan, mendukung pembuatan dan penyuntingan multi-giliran berdasarkan konteks sebelumnya, serta menyediakan berbagai rasio aspek keluaran dengan resolusi 1K, 2K, dan 4K. Model ini kuat dalam pemahaman semantik bahasa Mandarin, rendering teks multibahasa dan tipografi, serta rendering fotorealistis untuk tekstur kulit, serat kain, dan pencahayaan tepi. Penyuntingan dengan gambar referensi juga dijaga konsistensinya. API-nya menggunakan protokol Chat/Messages dengan input multi-gambar, konteks sunting multi-giliran, dan penulisan ulang chain-of-thought. Hy Image 3.5 Preview diposisikan sebagai model hemat biaya untuk pembuatan gambar profesional, bukan sebagai pemimpin skor benchmark. Model ini cocok untuk visual iklan, infografis, desain UI, retouching foto, papan cerita episode, materi film dan TV, ilustrasi kreatif, visual merek, serta materi e-commerce. Karena masih berstatus pratinjau, perilaku, batasan, dan harga dapat berubah.
Bagaimana penggunaan ditagih?
Tagihan Anda bergantung pada penyedia yang digunakan, tarifnya, dan penggunaan Anda. Masukan yang lebih panjang atau ketentuan lain dapat memiliki harga berbeda.
Input apa yang didukung Hy Image 3.5 Preview?
Model ini menerima input teks dan input gambar, serta menghasilkan gambar. Setiap permintaan dapat menyertakan hingga 5 gambar referensi.
Berapa resolusi dan rasio aspek keluaran yang tersedia?
Keluaran tersedia dalam resolusi 1K, 2K, dan 4K dengan berbagai rasio aspek. Pemilihan ukuran otomatis dapat menghasilkan orientasi berbeda antar proses, sehingga pengaturan ukuran manual disarankan untuk produksi.
Apakah model ini mendukung penyuntingan multi-giliran?
Ya. Model ini mendukung pembuatan dan penyuntingan percakapan multi-giliran berdasarkan konteks sebelumnya, serta penyuntingan dengan gambar referensi yang konsisten.
Apa keunggulan utama dibanding generasi sebelumnya?
Menurut pengujian internal Tencent, kemampuan keseluruhan sekitar 30% lebih tinggi daripada generasi sebelumnya. Klaim ini perlu verifikasi independen.
Di mana model ini tersedia?
Model ini tersedia di Tencent Yuanbao dan ima, terintegrasi ke workbench Tencent Cloud ADP, serta ditawarkan melalui node mitra di ComfyUI untuk pembuatan gambar dari teks dan penyuntingan gambar.