Source: https://ailoot.ai/models/id/tencent-hy-image-v3-5-preview/ Canonical: https://ailoot.ai/models/id/tencent-hy-image-v3-5-preview/ Language: id # Tencent: Hy Image 3.5 Preview [Markdown](https://ailoot.ai/models/id/tencent-hy-image-v3-5-preview/index.md) · [JSON](https://ailoot.ai/models/id/tencent-hy-image-v3-5-preview/facts.json) ## [Tencent: Hy Image 3.5 Preview](https://ailoot.ai/models/id/tencent-hy-image-v3-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`](https://ailoot.ai/models/id/tencent-hy-image-v3-5-preview/#method-0) 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`](https://ailoot.ai/models/id/#m=tencent%2Fhy-image-v3.5-preview&route=Ultra&caller=tencent%2Fhy-image-v3.5-preview&fmt=images) Tencent /`tencent/hy-image-v3.5-preview` ### Mulai 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. 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 →](https://ailoot.ai/docs/id/billing/reserve/) ### Contoh permintaan #### Ailoot Ultra · Gambar curl ```bash 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"