Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview matndan tasvir yaratish, namunaga asoslangan yaratish va ko‘p bosqichli suhbatda tahrirlashni birlashtiradi. Tencent batafsil vizual ishlar uchun 20 tagacha namuna tasviri, avtomatik o‘lcham tanlash va 4096 × 4096 tasvirgacha aniq chiqish o‘lchamlarini hujjatlashtiradi.

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

Model haqida

Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.

HY Image 3.5 Preview — Tencent’ning tasvir yaratish va tahrirlashni birlashtirgan modeli. U ixtiyoriy namuna tasvirlari bilan yozma topshiriqni qabul qiladi va bir xil vizual vazifani bir necha suhbat bosqichi bo‘ylab davom ettirishni qo‘llaydi. Natija — belgilangan sahna, kompozitsiya yoki tahrir uchun tasvir. Tencent misollariga mahsulot tasvirlari, kampaniya plakatlari, interfeys dizayni vizuallari va material g‘oyalari kiradi. Vazifaga yangi tasvirmi, namunalar yo‘naltirgan kompozitsiyami yoki mavjud natijaga aniq o‘zgarishmi kerakligini tanlang.

Ishlab chiqaruvchi nashrni hy-image-v3.5-preview deb belgilaydi va 100K tokenlik topshiriq chegarasini hujjatlashtiradi. Kirish — matn va tasvirlarni o‘z ichiga olgan xronologik suhbat; oxirgi foydalanuvchi xabari joriy ko‘rsatmani beradi. Avvalgi xabarlar bosqichma-bosqich tahrirlash uchun kontekst beradi. Bu HY Image 3.0 ning bitta topshiriqli jarayoni va alohida kirish chegaralaridan farq qiladi. Uzluksiz dizayn vazifasida keyingi ko‘rsatma kerakli vizual holat ustiga qurilishi uchun tegishli topshiriq, namuna vazifalari va tanlangan tasvirni saqlang.

PNG yoki JPEG/JPG namuna tasvirlarini tayyorlang. Hujjatlashtirilgan jarayonda namuna kirishlari 20 tagacha tasvirni qamrab olishi mumkin, har biri 20 MB dan katta bo‘lmasligi kerak. Tasvir havola qilingan yoki kodlangan material sifatida berilishi mumkin. Suhbatda tasvirlar haddan ko‘p bo‘lsa, ishlab chiqaruvchi qo‘llanmasi avval eskilarini qisqartirishni tasvirlaydi. Har bir tarixiy tasvir kontekstda qolishiga tayanmasdan, faol namuna to‘plamini maqsadli tuting. Kirish o‘lchamini o‘zgartirish boshqaruvi kichikroq tasvirlarni saqlaydi va kattalarini piksel maydoni maqsadiga mutanosib kichraytiradi; standart maqsad 1,048,576 piksel. Natijani yo‘naltirishi kerak bo‘lgan mahsulot, material yoki maket uchun yetarli ko‘rinadigan detalni saqlang.

Chiqish o‘lchami uchun ikki alohida tayyorgarlik yo‘li bor. Avtomatik o‘lchamlashda generate_max_pixels maqsad maydonni belgilaydi: 1K darajasi uchun 1,048,576 piksel, standart 1.5K uchun 2,359,296 yoki 2K uchun 4,194,304. Ishlab chiqaruvchi FAQ siga ko‘ra faqat maydon maqsadi berilsa standart nisbat kvadrat bo‘ladi. Ikkala o‘lcham boshqaruvi ham berilmasa, model topshiriq va standart 1.5K darajasidan foydalanadi. Bu darajalar avtomatik 4K sozlamasini yaratmaydi. Kvadrat tasvir vazifaga mos bo‘lsa maydon darajasidan foydalaning. Standart 1.5K da nisbatlarni topshiriq yo‘naltirishi uchun ikkala o‘lcham boshqaruvini ham tashlab keting; maket aniq vertikal yoki keng o‘lcham talab qilsa, aniq o‘lchamlarni so‘rang.

Aniq o‘lchamlar uchun ishlab chiqaruvchi tomonlarni 256 dan 8192 pikselgacha musbat butun sonlar bilan, umumiy maydonni esa ko‘pi bilan 16,777,216 piksel deb belgilaydi. 4096 × 4096 kvadrat shu chegaraga mos. Tomon oralig‘i va maydon chegarasi birga amal qiladi, shuning uchun 8192 pikselli qirra 8192 × 8192 tasvirga ruxsat bermaydi. Yakuniy maket aniq o‘lcham talab qilsa, maydon maqsadi darajasi ayni o‘lchamlarni belgilaydi deb o‘ylamasdan kerakli kenglik va balandlikni bevosita so‘rang. Kesimga sezgir detallar va kerakli bo‘sh joyni topshiriqda ochiq saqlang.

Model qaytgan suhbat tarixi orqali ko‘p bosqichli tahrirlashni qo‘llaydi. Tencent yakuniy yetkazilgan tasvirni keyingi tahrir konteksti sifatida ishlatiladigan oraliq tasvirdan ajratadi; misollarida davom ettirishda yordamchining mulohazasi, vosita so‘rovi va yaratilgan tasvir natijasi saqlanadi. Mahsulot kompozitsiyasida avval obyekt va kadr kompozitsiyasini belgilang; keyin nimaning ko‘rinishi saqlanishini aytib, yoritish o‘zgarishi yoki yangi fonni so‘rang. Keyingi bosqich tashlab yuborilgan variantda emas, shu tasvirda ishlashi uchun tanlangan natija va tarixini birga saqlang. Tencent’ning hujjatlashtirilgan jarayonida yakuniy va tarix tasvirlari havolalari 12 soatdan keyin tugaydi, shuning uchun keyingi tahrirda ularga tayanishdan avval tasvir materiallarini saqlang.

Hujjatlashtirilgan boshqaruvlarga seed, 16 belgigacha maxsus suv belgisi izohi va odatda o‘chirilgan ixtiyoriy tashqi qidiruv bilan boyitish kiradi. Seed manfiy bo‘lmagan butun son; nol yoki uning berilmasligi ishlab chiqaruvchiga tasodifiy tanlashga imkon beradi. Bu boshqaruvlar topshiriqning o‘zidan boshqa vazifalarni bajaradi. Namunaga asoslangan mahsulot vizualida mahsulot ko‘rinishi, kamera burchagi, sirt, yoritish va kerakli maketni tasvirlang, keyin tanituvchi detallarni yo‘naltirish uchun namunadan foydalaning. Plakat uchun uning xabari o‘ylab topilishiga yo‘l qo‘ymay, iyerarxiya va aniq so‘zlarni bering.

Tencent’ning amaliy tavsiyasi, ayniqsa mahsulot xususiyatlari, tashkilot nomlari yoki boshqa faktik so‘zlar muhim bo‘lganda matn va maketni tekshirishdir. Tayyor tasvirda obyekt, nisbatlar, material, kesim va yozuvni tekshiring. Yakuniy materialni topshirig‘i va sozlamalari bilan saqlang, keyingi tahrir uchun esa ko‘rinadigan muammoga bog‘langan aniq ko‘rsatmadan foydalaning.

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

tencent/hy-image-v3.5-preview

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

Boshlash

Qabul qilinadigan kirish ma’lumotlari: Matn · Rasmlar
Natijalar: Rasmlar

Ailoot da mavjud · kirish ma’lumotlari va usullar

Ailoot Ultra · Rasmlar POST /v1/images/generations

Kirish: text, image
Chiqish: image

Maydon	Tur	Talab	Qiymatlar va cheklovlar	Standart
Maydon`model`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar tencent/hy-image-v3.5-preview	Standart—
Maydon`prompt`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar Eng kam uzunlik: 1	Standart—
Maydon`resolution`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar 1K, 1.5K, 2K, 4K	Standart—
Maydon`aspect_ratio`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar 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	Standart—
Maydon`n`	Tur`integer`	TalabIxtiyoriy	Qiymatlar va cheklovlar Eng kam: 1 Eng ko‘p: 1	Standart—
Maydon`input_references`	Tur`array`	TalabIxtiyoriy	Qiymatlar va cheklovlar Elementlarning eng kam soni: 0 Elementlarning eng ko‘p soni: 20	Standart—
Maydon`provider`	Tur`object`	TalabIxtiyoriy	Qiymatlar va cheklovlar	Standart—

Usul parametrlari va hayot sikli

Parametr	Parametr talablari
Parametr`content_type`	Parametr talablariapplication/json
Parametr`required`	Parametr talablarimodel, prompt
Parametr`material_types`	Parametr talablaritext, image

Hayot sikli: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Amalda qaytarilgan task_id yoki media kutubxonasidagi yozuv

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tariflar

Yakuniy to‘lov qanday hisoblanadi

Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.

Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.

Tezkor rejim: Ko‘rsatilmagan Tezkor rejim tanlanganda
Flex rejimi: Ko‘rsatilmagan flex rejimi tanlanganda
Maksimal fikrlash darajasi: Ko‘rsatilmagan Maksimal fikrlash darajasi uchun standart (default) tuzatish qo‘llanganda

Taqqoslash uchun taxminiy tariflar

Sozlamalar bo‘yicha narxlar

Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.

Sozlama	Tariflar jadvali	Prognoz miqdori	Hisob birligi	To‘lov
SozlamaTokenlar uchun bazaviy tariflar	Tariflar jadvaliAsosiy tarif	Prognoz miqdori—	Hisob birligi—	To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token
SozlamaChiqish rasmi tokeni	Tariflar jadvali—	Prognoz miqdori—	Hisob birligi/ 1K rasm tokeni	To‘lov Chiqish · Chiqish rasmi tokeni · Faqat taqqoslash uchun taxmin $0.0032 / 1K rasm tokeni
SozlamaYaratishning taxminiy qiymati	Tariflar jadvali—	Prognoz miqdoribir generatsiya uchun taxmin	Hisob birligi—	To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $0.0131072 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas.

Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →

So‘rov namunalari

Ailoot Ultra · Rasmlar

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

Natijalarni olish va saqlash

Ailoot Ultra · Rasmlar

Har bir qaytarilgan rasmni yuklab oling yoki uning Base64 kontentini saqlang

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

Boshqa kontentni o‘qish

O‘zingizga tegishli mavjud materiallarni o‘qish

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.

Barcha tayyor natijalarni saqlash

Har bir tayyor rasmni saqlang; har bir qaytarilgan URL dan kontentni oling yoki uning Base64 kontentini dekodlang.

To‘liq javob va sarlavhalarni, amalda qaytarilgan barcha natijalarni, dastlab qaytarilgan identifikatorlarni hamda barcha usage maydonlarini saqlang. Yaratish so‘rovini qayta yubormasdan dastlabki operatsiyani tiklang.

Asl javobni tekshirish kerak bo‘lsa

Qaytarilgan X-Client-Request-ID ni ma’lumotlarni solishtirib tekshirish uchun saqlang. Faqat amalda qaytarilgan task_id/asset_id qiymatlari bo‘yicha yoki o‘zingizga tegishli media kutubxonasidan ma’lumot o‘qing; operatsiya ID sidan vazifa URL manzilini hech qachon tuzmang va yaratish so‘rovini qayta yubormang.

Javob maydonlari

Maydon	Tur
Maydon`created`	Tur
Maydon`data[].url`	Tur
Maydon`data[].b64_json`	Tur
Maydon`usage`	Tur

Taxalluslar

Model taxalluslari

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

Usul yo‘llari taxalluslari

/v1/images

Chaqirish uchun tegishli ID lar

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

Qanday kirish ma’lumotlari va natijalar mavjud?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
So‘rov qaysi maydonlardan foydalanadi?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
Qanday cheklovlar amal qiladi?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview