Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview мәтіннен кескін жасауды, үлгіге сүйенген генерацияны және бірнеше кезекті өңдеуді біріктіреді. Tencent егжей-тегжейлі визуалдық жұмыс үшін 20-ға дейін үлгі кескінді, автоматты өлшем таңдауын және 4096 × 4096 кескінге дейінгі нақты нәтиже өлшемдерін құжаттайды.

Ailoot Ultra · Суреттер POST /v1/images/generations tencent/hy-image-v3.5-preview

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

HY Image 3.5 Preview — Tencent компаниясының кескін жасау мен өңдеуді біріктіретін моделі. Ол қосымша үлгі кескіндері бар жазбаша тапсырманы қабылдайды және сол визуалдық жұмысты бірнеше кезек бойы жалғастыруды қолдайды. Нәтиже — анықталған көрініске, композицияға немесе өңдеуге арналған кескін. Tencent мысалдарына тауар кескіндері, науқан постерлері, интерфейс дизайнының визуалдары және материал тұжырымдамалары кіреді. Тапсырмаға жаңа кескін, үлгілер бағыттайтын композиция немесе бар нәтижені нысаналы өзгерту қажет екенін таңдаңыз.

Өндіруші нұсқаны hy-image-v3.5-preview деп белгілейді және сұрауға 100K токендік шек құжаттайды. Оның кірісі — мәтін мен кескіндері бар хронологиялық әңгіме; соңғы пайдаланушы хабары ағымдағы нұсқауды береді. Алдыңғы хабарлар итерациялық өңдеуге контекст ұсынады. Бұл HY Image 3.0 моделінің бір сұраулы үдерісі мен бөлек кіріс шектерінен өзгеше. Үздіксіз дизайн тапсырмасында келесі нұсқау жоспарланған визуалдық күйге сүйенуі үшін тиісті тапсырманы, үлгі рөлдері мен таңдалған кескінді сақтаңыз.

PNG немесе JPEG/JPG үлгі кескіндерін дайындаңыз. Құжатталған үдерісте үлгі кірістері 20-ға дейін кескін қамти алады, әрқайсысы 20 МБ-тан аспайды. Кескін сілтемемен берілген немесе кодталған материал ретінде ұсынылуы мүмкін. Әңгімеде кескін тым көп болса, өндіруші нұсқаулығы алдымен ескі кескіндерді қысқартуды сипаттайды. Барлық тарихи кескін контексте қалады деп күтпей, белсенді үлгілер жиынтығын нақты ұстаңыз. Кіріс өлшемін өзгерту басқаруы кіші кескіндерді сақтап, ірілерін пиксель ауданының нысаналы мәніне қарай пропорционалды масштабтайды; әдепкі нысана — 1 048 576 пиксель. Нәтижені бағыттауы тиіс тауардың, материалдың не орналасудың жеткілікті көрінетін бөлшектерін сақтаңыз.

Нәтиже өлшемін дайындаудың екі бөлек жолы бар. Автоматты өлшем таңдауда generate_max_pixels нысаналы ауданды белгілейді: 1K деңгейі үшін 1 048 576 пиксель, әдепкі 1.5K деңгейі үшін 2 359 296, 2K үшін 4 194 304. Өндірушінің FAQ бөлімінде аудан нысанасы жалғыз берілсе, әдепкіде шаршы арақатынас таңдалатыны айтылады. Екі өлшем басқаруы да берілмесе, модель тапсырма мен әдепкі 1.5K деңгейін қолданады. Бұл деңгейлер автоматты 4K параметрін жасамайды. Тапсырмаға шаршы кескін лайық болса, аудан деңгейін қолданыңыз. Әдепкі 1.5K деңгейінде пропорцияны тапсырма бағыттасын десеңіз, екі өлшем басқаруын да бермеңіз; макет нақты тік не кең өлшемді қажет етсе, өлшемдерді тікелей сұраңыз.

Нақты өлшемдер үшін өндіруші әр жақтың ұзындығын 256–8192 пиксель аралығындағы оң бүтін санмен беруге рұқсат етеді; жалпы аудан 16 777 216 пиксельден аспауы тиіс. 4096 × 4096 шаршысы осы шекке сай. Жақ аралығы мен аудан шегі бірге қолданылады, сондықтан 8192 пиксельдік жиек 8192 × 8192 кескінге рұқсат бермейді. Соңғы макетке нақты өлшем қажет болса, аудан деңгейі сол өлшемдерді анықтайды деп болжамай, қажетті ен мен биіктікті тікелей сұраңыз. Қиылуға сезімтал бөлшектер мен қажетті бос кеңістікті сұрауда анық көрсетіңіз.

Модель қайтарылған әңгіме тарихы арқылы бірнеше кезекті өңдеуді қолдайды. Tencent соңғы жеткізілген кескін мен келесі өңдеуге контекст ретінде қолданылатын аралық кескінді ажыратады; жалғастыру мысалдары ассистенттің пайымдауын, құрал сұрауын және генерацияланған кескін нәтижесін сақтайды. Тауар композициясы үшін алдымен нысан мен кадрлауды орнатып, кейін сыртқы көрінісін сақтау керек нәрселерді көрсете отырып жарықты немесе фонды өзгертуді сұраңыз. Келесі кезек алынып тасталған нұсқамен емес, сол кескінмен жұмыс істеуі үшін таңдалған нәтиже мен тарихын бірге сақтаңыз. Tencent құжаттаған үдерісте соңғы және тарих кескіндерінің сілтемелері 12 сағаттан кейін жарамсыз болады, сондықтан кейінгі өңдеуде оларға сүйенбес бұрын кескін материалдарын сақтаңыз.

Құжатталған басқаруларға seed, 16 таңбаға дейінгі жеке сутаңба ескертпесі және әдепкіде өшірулі қосымша сыртқы іздеу арқылы толықтыру кіреді. Seed — теріс емес бүтін сан; нөл не мәнді бермеу өндірушінің кездейсоқ таңдауына жол береді. Бұл басқарулардың мақсаттары тапсырманың өзінен бөлек. Үлгіге негізделген тауар кескіні үшін тауардың көрінісін, камера бұрышын, бетті, жарық пен жоспарланған орналасуды сипаттап, тануға қажет бөлшектерді үлгі арқылы бағыттаңыз. Постер үшін хабарын ойдан шығаруға қалдырмай, иерархия мен нақты мәтінді беріңіз.

Tencent практикалық нұсқаулығы мәтін мен орналасуды, әсіресе тауар сипаттамалары, ұйым атаулары немесе өзге нақты сөздер маңызды жерлерде тексеруді ұсынады. Аяқталған кескіннің нысанын, пропорцияларын, материалын, қиылуын және жазуларын тексеріңіз. Соңғы материалды тапсырмасы және параметрлерімен бірге сақтап, келесі өңдеуге көрінетін мәселемен байланысты нақты нұсқау беріңіз.

Ailoot Ultra · Суреттер POST /v1/images/generations tencent/hy-image-v3.5-preview

tencent/hy-image-v3.5-preview

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

Бастау

Қабылданатын кіріс деректері: Мәтін · Суреттер
Нәтижелер: Суреттер

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Суреттер POST /v1/images/generations

Кіріс: text, image
Шығыс: image

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер tencent/hy-image-v3.5-preview	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`resolution`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1K, 1.5K, 2K, 4K	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 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	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 1	Әдепкі—
Өріс`input_references`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 20	Әдепкі—
Өріс`provider`	Түрі`object`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкі—

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, prompt
Параметр`material_types`	Параметр талаптарыtext, image

Өмірлік цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифтер

Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим: Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Болжамды мөлшер	Есептеу бірлігі	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Болжамды мөлшер—	Есептеу бірлігі—	Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
Баптаушығыс кескін токені	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігі/ 1K сурет токені	Төлем Шығыс · шығыс кескін токені · Тек салыстыруға арналған бағалау $0.0032 / 1K сурет токені
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Есептеу бірлігі—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.0131072 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Суреттер

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

Нәтижелерді алу және сақтау

Ailoot Ultra · Суреттер

Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз

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

Басқа мазмұнды оқу

Өзіңізге тиесілі қолда бар материалдарды оқу

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.

Барлық дайын нәтижені сақтау

Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.

Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.

Бастапқы жауапты тексеру қажет болса

Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз.

Жауап өрістері

Өріс	Түрі
Өріс`created`	Түрі
Өріс`data[].url`	Түрі
Өріс`data[].b64_json`	Түрі
Өріс`usage`	Түрі

Балама атаулар

Модельдердің балама атаулары

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

Әдіс жолдарының балама атаулары

/v1/images

Шақыруға арналған байланысты ID

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
Сұрау қандай өрістерді пайдаланады?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
Қандай шектеулер қолданылады?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview