Tencent: Hy Image 3.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

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

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

Pengenalan

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 →

Contoh permintaan

Ailoot Ultra · Imej

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 · Imej

Muat turun setiap imej yang dikembalikan atau simpan kandungan 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 kandungan lain

Baca aset sedia ada yang 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 imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.

Simpan respons dan pengepala yang lengkap, setiap output sebenar, pengecam asal yang dikembalikan serta semua medan penggunaan. Pulihkan operasi asal tanpa menghantar permintaan penciptaan sekali lagi.

Jika respons asal perlu disemak

Simpan X-Client-Request-ID yang dikembalikan untuk penyelarasan rekod. Baca hanya nilai task_id/asset_id sebenar yang dikembalikan atau pustaka media milik anda; jangan sekali-kali bina URL tugas daripada ID operasi atau hantar semula permintaan penciptaan.

Medan respons

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

Alias

Alias model

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

Alias laluan kaedah

/v1/images

ID pemanggil berkaitan

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

Apakah input dan hasil yang tersedia?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
Apakah medan yang digunakan oleh permintaan?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
Apakah had yang terpakai?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview