Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview menggabungkan generasi teks ke gambar, kreasi berbasis referensi, dan penyuntingan multigiliran. Tencent mendokumentasikan hingga 20 gambar referensi, pemilihan ukuran otomatis, serta ukuran keluaran eksplisit hingga gambar 4096 × 4096 untuk pekerjaan visual terperinci.

Ailoot Ultra · Gambar POST /v1/images/generations tencent/hy-image-v3.5-preview

Tentang model

Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.

HY Image 3.5 Preview adalah model generasi dan penyuntingan gambar terpadu Tencent. Model menerima brief tertulis dengan gambar referensi opsional dan mendukung kelanjutan tugas visual yang sama dalam beberapa giliran. Hasil berupa gambar untuk adegan, komposisi, atau suntingan tertentu. Contoh Tencent mencakup citra produk, poster kampanye, visual desain antarmuka, dan konsep material. Pilih apakah tugas memerlukan gambar baru, komposisi berbantuan referensi, atau perubahan terarah pada hasil yang sudah ada.

Produsen menyebut edisi ini sebagai hy-image-v3.5-preview dan mendokumentasikan batas prompt 100K token. Masukannya berupa percakapan kronologis berisi teks serta gambar, dengan pesan pengguna terakhir menyediakan instruksi saat ini. Pesan terdahulu memberi konteks untuk penyuntingan berulang. Ini berbeda dari alur prompt tunggal HY Image 3.0 dan batas masukannya yang terpisah. Untuk tugas desain berkelanjutan, simpan brief relevan, peran referensi, dan gambar pilihan agar instruksi berikutnya dapat membangun keadaan visual yang dimaksud.

Siapkan gambar referensi PNG atau JPEG/JPG. Masukan referensi dapat memuat hingga 20 gambar, masing-masing maksimal 20 MB dalam alur terdokumentasi. Gambar dapat diberikan sebagai aset yang dirujuk atau terenkode. Jika percakapan membawa terlalu banyak gambar, panduan produsen menjelaskan pemangkasan gambar lama terlebih dahulu. Jaga kumpulan referensi aktif tetap terarah, alih-alih mengandalkan setiap gambar historis tetap dalam konteks. Kendali pengubahan ukuran masukan mempertahankan gambar kecil dan menskalakan gambar besar secara proporsional menuju sasaran luas piksel; sasaran bawaannya 1.048.576 piksel. Pertahankan detail terlihat yang cukup untuk produk, material, atau tata letak yang perlu memandu hasil.

Ukuran keluaran memiliki dua jalur persiapan berbeda. Dengan penentuan ukuran otomatis, generate_max_pixels menetapkan luas sasaran: 1.048.576 piksel untuk tingkat 1K, 2.359.296 untuk tingkat bawaan 1.5K, atau 4.194.304 untuk 2K. FAQ produsen menyatakan pengaturan luas sasaran yang diberikan sendiri secara bawaan menggunakan rasio persegi. Ketika kedua kendali ukuran tidak diberikan, model menggunakan brief dan tingkat bawaan 1.5K. Tingkat tersebut tidak membuat pengaturan 4K otomatis. Gunakan tingkat luas ketika gambar persegi sesuai tugas. Agar brief memandu proporsi pada tingkat bawaan 1.5K, hilangkan kedua kendali ukuran; minta dimensi eksplisit ketika tata letak memerlukan ukuran potret atau lebar tertentu.

Untuk dimensi eksplisit, produsen mengizinkan sisi bilangan bulat positif 256 hingga 8192 piksel, dengan luas total maksimal 16.777.216 piksel. Persegi 4096 × 4096 memenuhi batas itu. Rentang sisi dan batas luas berlaku bersama-sama, sehingga tepi 8192 piksel tidak mengizinkan gambar 8192 × 8192. Minta lebar dan tinggi wajib secara eksplisit ketika tata letak akhir membutuhkan ukuran tertentu, alih-alih menganggap tingkat luas sasaran menentukan dimensi yang sama. Nyatakan detail peka potongan serta ruang kosong yang diperlukan dalam prompt.

Model mendukung penyuntingan multigiliran melalui riwayat percakapan yang dikembalikan. Tencent membedakan gambar akhir yang dikirim dari gambar perantara yang digunakan sebagai konteks suntingan berikutnya, dan contohnya mempertahankan penalaran asisten, permintaan alat, serta hasil gambar generasi saat melanjutkan. Untuk komposisi produk, tetapkan subjek dan pembingkaian terlebih dahulu; kemudian minta perubahan pencahayaan atau latar baru sambil menentukan yang tampilannya harus tetap. Simpan hasil pilihan bersama riwayatnya agar giliran berikutnya bekerja pada gambar itu, bukan variasi yang dibuang. Dalam alur Tencent yang didokumentasikan, tautan gambar akhir maupun riwayat kedaluwarsa setelah 12 jam, sehingga simpan aset gambar sebelum mengandalkannya untuk suntingan berikutnya.

Kendali terdokumentasi mencakup seed, catatan kaki watermark khusus hingga 16 karakter, dan augmentasi pencarian eksternal opsional yang secara bawaan nonaktif. Seed berupa bilangan bulat nonnegatif; nol atau penghilangan membiarkan produsen memilih secara acak. Kendali ini memiliki tujuan berbeda dari brief itu sendiri. Untuk visual produk berbasis referensi, jelaskan tampilan produk, sudut kamera, permukaan, pencahayaan, serta tata letak yang dimaksud, lalu gunakan referensi untuk memandu detail pengenal. Untuk poster, berikan hierarki dan kata-kata tepat, alih-alih membiarkan pesannya diciptakan sendiri.

Panduan praktis Tencent menyarankan pemeriksaan teks serta tata letak, terutama ketika spesifikasi produk, nama organisasi, atau kata-kata faktual lain penting. Periksa gambar selesai untuk subjek, proporsi, material, potongan, dan huruf. Simpan aset akhir bersama brief serta pengaturannya, lalu gunakan instruksi konkret yang terkait masalah terlihat untuk suntingan berikutnya.

Ailoot Ultra · Gambar POST /v1/images/generations tencent/hy-image-v3.5-preview

tencent/hy-image-v3.5-preview

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

Mulai

Masukan yang diterima: Teks · Gambar
Hasil: Gambar

Tersedia di Ailoot · masukan & metode

Ailoot Ultra · Gambar POST /v1/images/generations

Masukan: text, image
Keluaran: image

Kolom	Jenis	Persyaratan	Nilai & batasan	Bawaan
Kolom`model`	Jenis`string`	PersyaratanWajib	Nilai & batasan tencent/hy-image-v3.5-preview	Bawaan—
Kolom`prompt`	Jenis`string`	PersyaratanWajib	Nilai & batasan Panjang minimum: 1	Bawaan—
Kolom`resolution`	Jenis`string`	PersyaratanOpsional	Nilai & batasan 1K, 1.5K, 2K, 4K	Bawaan—
Kolom`aspect_ratio`	Jenis`string`	PersyaratanOpsional	Nilai & batasan 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	Bawaan—
Kolom`n`	Jenis`integer`	PersyaratanOpsional	Nilai & batasan Minimum: 1 Maksimum: 1	Bawaan—
Kolom`input_references`	Jenis`array`	PersyaratanOpsional	Nilai & batasan Item minimum: 0 Item maksimum: 20	Bawaan—
Kolom`provider`	Jenis`object`	PersyaratanOpsional	Nilai & batasan	Bawaan—

Parameter metode dan siklus hidup

Parameter	Kontrak
Parameter`content_type`	Kontrakapplication/json
Parameter`required`	Kontrakmodel, prompt
Parameter`material_types`	Kontraktext, image

Siklus hidup: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Paket

Cara menghitung biaya akhir

Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.

Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.

Mode Fast: Tidak ditentukan Saat mode fast dipilih
Mode Flex: Tidak ditentukan Saat mode flex dipilih
Upaya penalaran maksimum: Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default

Perkiraan tarif untuk perbandingan

Harga menurut konfigurasi

Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.

Konfigurasi	Jadwal tarif	Jumlah perkiraan	Satuan penagihan	Biaya
KonfigurasiTarif dasar token	Jadwal tarifTarif dasar	Jumlah perkiraan—	Satuan penagihan—	Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token
Konfigurasitoken gambar keluaran	Jadwal tarif—	Jumlah perkiraan—	Satuan penagihan/ 1K token gambar	Biaya Keluaran · token gambar keluaran · Perkiraan hanya untuk perbandingan $0.0032 / 1K token gambar
KonfigurasiPerkiraan biaya pembuatan	Jadwal tarif—	Jumlah perkiraanestimasi satu kali pembuatan	Satuan penagihan—	Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.0131072 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai.

Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →

Contoh permintaan

Ailoot Ultra · Gambar

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

Terima dan simpan hasil

Ailoot Ultra · Gambar

Unduh setiap gambar yang dikembalikan atau simpan konten Base64-nya

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Pembacaan konten lain

Baca aset yang sudah ada dan menjadi milik Anda

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.

Simpan semua hasil yang selesai

Simpan setiap gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.

Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.

Jika respons asli perlu diperiksa

Simpan X-Client-Request-ID yang dikembalikan untuk rekonsiliasi. Baca hanya nilai task_id/asset_id yang benar-benar dikembalikan atau pustaka media milik Anda; jangan pernah membuat URL tugas dari ID operasi dan jangan pernah mengirim ulang permintaan pembuatan.

Kolom respons

Kolom	Jenis
Kolom`created`	Jenis
Kolom`data[].url`	Jenis
Kolom`data[].b64_json`	Jenis
Kolom`usage`	Jenis

Alias

Alias model

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

Alias jalur metode

/v1/images

ID pemanggil terkait

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

Input dan hasil apa yang tersedia?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
Kolom apa yang digunakan permintaan?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
Batasan apa yang berlaku?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview