Source: https://ailoot.ai/models/ms/tencent-hy-image-v3-5-preview/ Canonical: https://ailoot.ai/models/ms/tencent-hy-image-v3-5-preview/ Language: ms # Tencent: Hy Image 3.5 Preview [Markdown](https://ailoot.ai/models/ms/tencent-hy-image-v3-5-preview/index.md) · [JSON](https://ailoot.ai/models/ms/tencent-hy-image-v3-5-preview/facts.json) ## [Tencent: Hy Image 3.5 Preview](https://ailoot.ai/models/ms/tencent-hy-image-v3-5-preview/) HY Image 3.5 Preview menggabungkan penjanaan teks-ke-imej, penciptaan berasaskan rujukan dan penyuntingan berbilang giliran. Tencent mendokumenkan sehingga 20 imej rujukan, pemilihan saiz automatik dan saiz output eksplisit sehingga imej 4096 × 4096 untuk kerja visual terperinci. - [**Ailoot Ultra · Imej** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/ms/tencent-hy-image-v3-5-preview/#method-0) Tentang model Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih. HY Image 3.5 Preview ialah model penjanaan dan penyuntingan imej bersepadu Tencent. Ia menerima arahan bertulis dengan imej rujukan pilihan dan menyokong penerusan tugas visual sama merentas beberapa giliran. Hasilnya ialah imej untuk adegan, komposisi atau suntingan ditetapkan. Contoh Tencent merangkumi imejan produk, poster kempen, visual reka bentuk antara muka dan konsep bahan. Pilih sama ada tugas memerlukan imej baharu, komposisi berpandukan rujukan atau perubahan terarah pada hasil sedia ada. Pengeluar mengenal pasti edisi sebagai hy-image-v3.5-preview dan mendokumenkan had prompt 100K token. Inputnya ialah perbualan kronologi yang mengandungi teks serta imej, dengan mesej pengguna terakhir membekalkan arahan semasa. Mesej terdahulu memberikan konteks untuk penyuntingan berulang. Ini berbeza daripada aliran prompt tunggal HY Image 3.0 dan had inputnya yang berasingan. Untuk tugas reka bentuk berterusan, simpan arahan relevan, peranan rujukan dan imej pilihan supaya arahan seterusnya dapat membina berdasarkan keadaan visual dimaksudkan. Sediakan imej rujukan PNG atau JPEG/JPG. Input rujukan boleh mengandungi sehingga 20 imej, setiap satu tidak melebihi 20 MB dalam aliran yang didokumenkan. Imej boleh diberikan sebagai aset dirujuk atau berkod. Jika perbualan membawa terlalu banyak imej, panduan pengeluar menerangkan pemangkasan imej lama dahulu. Pastikan set rujukan aktif terarah tanpa bergantung pada setiap imej sejarah kekal dalam konteks. Kawalan pengubahan saiz input mengekalkan imej lebih kecil dan menskalakan imej lebih besar secara berkadar ke sasaran luas piksel; sasaran lalainya ialah 1,048,576 piksel. Kekalkan butiran kelihatan mencukupi untuk produk, bahan atau susun atur yang perlu memandu hasil. Saiz output mempunyai dua laluan persediaan berbeza. Dengan saiz automatik, generate\_max\_pixels menetapkan luas sasaran: 1,048,576 piksel untuk peringkat 1K, 2,359,296 untuk peringkat 1.5K lalai atau 4,194,304 untuk 2K. FAQ pengeluar menyatakan tetapan sasaran luas yang diberikan bersendirian menggunakan nisbah segi empat sama secara lalai. Apabila kedua-dua kawalan saiz tidak diberikan, model menggunakan arahan dan peringkat 1.5K lalai. Peringkat itu tidak mewujudkan tetapan 4K automatik. Gunakan peringkat luas apabila imej segi empat sama sesuai dengan tugas. Untuk membolehkan arahan memandu perkadaran pada peringkat 1.5K lalai, jangan sertakan mana-mana daripada kedua-dua kawalan saiz; minta dimensi eksplisit apabila susun atur memerlukan saiz potret atau lebar tertentu. Untuk dimensi eksplisit, pengeluar membenarkan sisi integer positif daripada 256 hingga 8192 piksel, dengan jumlah luas tidak melebihi 16,777,216 piksel. Segi empat sama 4096 × 4096 memenuhi had itu. Julat sisi dan siling luas terpakai bersama, jadi pinggir 8192 piksel tidak membenarkan imej 8192 × 8192. Minta lebar serta tinggi diperlukan secara eksplisit apabila susun atur akhir memerlukan saiz khusus, tanpa menganggap peringkat luas sasaran menentukan dimensi sama. Nyatakan butiran sensitif pemotongan serta ruang kosong diperlukan dengan jelas dalam prompt. Model menyokong penyuntingan berbilang giliran melalui sejarah perbualan yang dikembalikan. Tencent membezakan imej akhir diserahkan daripada imej perantaraan yang digunakan sebagai konteks suntingan seterusnya, dan contohnya mengekalkan penaakulan pembantu, permintaan alat serta hasil imej terjana ketika meneruskan. Untuk komposisi produk, tetapkan subjek dan pembingkaian dahulu; kemudian minta perubahan pencahayaan atau latar belakang baharu sambil menetapkan rupa yang perlu kekal. Simpan hasil pilihan bersama sejarahnya supaya giliran seterusnya menggunakan imej itu, bukannya variasi dibuang. Dalam aliran Tencent yang didokumenkan, pautan imej akhir serta sejarah tamat selepas 12 jam, jadi simpan aset imej sebelum bergantung padanya untuk suntingan kemudian. Kawalan yang didokumenkan termasuk seed, nota kaki tera air tersuai sehingga 16 aksara dan penambahan carian luaran pilihan, yang dimatikan secara lalai. Seed ialah integer bukan negatif; sifar atau ketiadaan membolehkan pengeluar memilih secara rawak. Kawalan ini mempunyai tujuan berbeza daripada arahan itu sendiri. Untuk visual produk berasaskan rujukan, huraikan rupa produk, sudut kamera, permukaan, pencahayaan dan susun atur dimaksudkan, kemudian gunakan rujukan untuk memandu butiran pengenalan. Untuk poster, berikan hierarki dan perkataan tepat tanpa membiarkan mesejnya direka. Panduan praktikal Tencent mengesyorkan semakan teks dan susun atur, khususnya apabila spesifikasi produk, nama organisasi atau perkataan berfakta lain penting. Periksa imej siap dari segi subjek, perkadaran, bahan, pemotongan dan tulisan. Simpan aset akhir bersama arahan serta tetapannya, dan gunakan arahan konkrit berkait dengan isu kelihatan untuk suntingan seterusnya. **Ailoot Ultra · Imej** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview` [`tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/ms/#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` ### Pengenalan HY Image 3.5 Preview menggabungkan penjanaan teks-ke-imej, penciptaan berasaskan rujukan dan penyuntingan berbilang giliran. Tencent mendokumenkan sehingga 20 imej rujukan, pemilihan saiz automatik dan saiz output eksplisit sehingga imej 4096 × 4096 untuk kerja visual terperinci. Input yang diterima Teks · Imej Hasil Imej ### Tersedia di Ailoot · input & kaedah **Ailoot Ultra · Imej** `POST /v1/images/generations` Input `text`, `image` Output `image` | Medan | Jenis | Keperluan | Nilai & had | Lalai | | --- | --- | --- | --- | --- | | Medan`model` | Jenis`string` | KeperluanDiperlukan | Nilai & had tencent/hy-image-v3.5-preview | Lalai— | | Medan`prompt` | Jenis`string` | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— | | Medan`resolution` | Jenis`string` | KeperluanPilihan | Nilai & had 1K, 1.5K, 2K, 4K | Lalai— | | Medan`aspect_ratio` | Jenis`string` | KeperluanPilihan | Nilai & had 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 | Lalai— | | Medan`n` | Jenis`integer` | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 1 | Lalai— | | Medan`input_references` | Jenis`array` | KeperluanPilihan | Nilai & had Item minimum: 0 Item maksimum: 20 | Lalai— | | Medan`provider` | Jenis`object` | KeperluanPilihan | Nilai & had | Lalai— | Parameter kaedah dan kitar hayat | Parameter | Kontrak | | --- | --- | | Parameter`content_type` | Kontrakapplication/json | | Parameter`required` | Kontrakmodel, prompt | | Parameter`material_types` | Kontraktext, image | Kitar hayat: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · task\_id sebenar yang dikembalikan atau rekod pustaka media `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Pelan harga ##### Cara caj akhir dikira Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan. Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih. Mod pantas Tidak dinyatakan Apabila mod pantas dipilih Mod flex Tidak dinyatakan Apabila mod flex dipilih Usaha penaakulan maksimum Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default #### Anggaran kadar untuk perbandingan #### Harga mengikut konfigurasi Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif. | Konfigurasi | Jadual kadar | Kuantiti ramalan | Unit pengebilan | Caj | | --- | --- | --- | --- | --- | | KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Unit pengebilan— | Caj Input · Token input · Anggaran untuk perbandingan sahaja **—** / 1K token Output · Token output · Anggaran untuk perbandingan sahaja **—** / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja **—** / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja **—** / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja **—** / 1K token | | Konfigurasitoken keluaran imej | Jadual kadar— | Kuantiti ramalan— | Unit pengebilan/ 1K token imej | Caj Output · token keluaran imej · Anggaran untuk perbandingan sahaja **$0.0032** / 1K token imej | | KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Unit pengebilan— | Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja **$0.0131072** anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai. | Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. [Cara rizab dan penyelesaian caj berfungsi →](https://ailoot.ai/docs/ms/billing/reserve/) ### Contoh permintaan #### Ailoot Ultra · Imej 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"