Felo API PlatformFelo API Platform
Назад до моделей

Hy Image 3.5 Preview API

Hy Image 3.5 Preview — це модель генерації та редагування зображень від Tencent, орієнтована на професійне комерційне використання з підтримкою до 5 референсних зображень і роздільністю до 4K.

Hy Image 3.5 Preview — це попередня версія моделі зображень від Tencent, представлена 22 вересня 2026 року. Вона призначена для професійного створення зображень: рекламних візуалів, інфографіки, UI-дизайну, комерційних постерів, матеріалів для кіно та телебачення, а також творчих ілюстрацій. Модель підтримує генерацію зображень за текстовим описом і редагування за зображеннями, приймаючи до 5 референсних зображень за запит, і здатна вести багатоетапне діалогове створення та редагування з урахуванням попереднього контексту.

Hy Image 3.5 Preview забезпечує вихідні зображення в роздільності 1K, 2K і 4K з різними співвідношеннями сторін. Вона підтримує багатомовний рендеринг тексту та типографіку, а також фотореалістичне відтворення текстури шкіри, переплетення тканин і контурного освітлення. Завдяки сильному розумінню китайської семантики та реалістичному стилю модель добре підходить для комерційних завдань, де потрібна точність і якість. API використовує протокол Chat/Messages з підтримкою кількох зображень на вході, контексту багатоетапного редагування та ланцюжка міркувань для переписування запитів.

Модель позиціонується як економічно ефективне рішення для професійного створення зображень, а не як лідер за бенчмарками. За внутрішнім тестуванням Tencent, її загальна спроможність приблизно на 30% вища за попереднє покоління. Водночас це попередня версія, тому поведінка, обмеження та ціни можуть змінитися до фінального релізу. Користувачам рекомендується вручну встановлювати розмір зображення, оскільки автоматичний вибір може призводити до різних орієнтацій між запусками.

ОбмеженоБезкоштовний пробний період

Оновлено:

MODEL ID

hy-image-v3.5-preview
Вхід
text / image
Вихід
image

Ключові можливості

  • До 5 референсних зображень за запит
  • Роздільність виходу 1K, 2K і 4K
  • Багатомовний рендеринг тексту
  • Фотореалістичні текстури шкіри й тканин
  • Багатоетапне редагування з контекстом
  • API за протоколом Chat/Messages

Постачальники

1 постачальників

Порівняйте ціни API у різних постачальників. Виберіть постачальника, щоб переглянути всі тарифи й умови.

Постачальник · Деталі тарифів
Доступність

Швидкий старт

Надішліть завдання зображення, перевіряйте стан і збережіть зображення. Приклади використовують curl і стандартну бібліотеку Python 3.

POST https://openapi.felo.ai/api/v1/images/generations

1Отримайте API-ключ

Створіть ключ у своєму обліковому записі Felo API Platform і встановіть його як змінну середовища.

export FELO_API_KEY="YOUR_API_KEY"

2Зробіть перший запит

Необов’язкові значення залежать від моделі та тут не задані. Перевірте їх у Playground. Поля розташовані поруч із model і prompt, без обгортки input.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "hy-image-v3.5-preview"
}'

3Опитувати завдання

Надсилання повертає task_id. При queued або running перевіряйте кожні 3 секунди; при succeeded, failed або interrupted зупиніться. Очікуйте до 30 хвилин. Збережіть created.json для продовження без повторного надсилання.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4Завантажити вихід

Після успіху збережіть outputs із task.json. Підтримуються HTTPS URL, об’єкти URL і b64_json. Підписані посилання завантажуйте вчасно; для зображень API-ключ не потрібен.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY
input_references

Для редагування замініть URL прикладу своїм HTTPS URL зображення або base64 data URL. Надішліть один раз, далі використовуйте ті самі кроки перевірки та збереження.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "hy-image-v3.5-preview",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

Підтримувані параметри

  • n
  • seed
  • size
  • resolution
  • aspect_ratio
  • input_references

Потрібна повна довідка?

Довідка API →

Часті запитання

Що таке Hy Image 3.5 Preview?

Hy Image 3.5 Preview — це попередня версія моделі зображень від Tencent, представлена 22 вересня 2026 року. Вона призначена для професійного створення зображень: рекламних візуалів, інфографіки, UI-дизайну, комерційних постерів, матеріалів для кіно та телебачення, а також творчих ілюстрацій. Модель підтримує генерацію зображень за текстовим описом і редагування за зображеннями, приймаючи до 5 референсних зображень за запит, і здатна вести багатоетапне діалогове створення та редагування з урахуванням попереднього контексту. Hy Image 3.5 Preview забезпечує вихідні зображення в роздільності 1K, 2K і 4K з різними співвідношеннями сторін. Вона підтримує багатомовний рендеринг тексту та типографіку, а також фотореалістичне відтворення текстури шкіри, переплетення тканин і контурного освітлення. Завдяки сильному розумінню китайської семантики та реалістичному стилю модель добре підходить для комерційних завдань, де потрібна точність і якість. API використовує протокол Chat/Messages з підтримкою кількох зображень на вході, контексту багатоетапного редагування та ланцюжка міркувань для переписування запитів. Модель позиціонується як економічно ефективне рішення для професійного створення зображень, а не як лідер за бенчмарками. За внутрішнім тестуванням Tencent, її загальна спроможність приблизно на 30% вища за попереднє покоління. Водночас це попередня версія, тому поведінка, обмеження та ціни можуть змінитися до фінального релізу. Користувачам рекомендується вручну встановлювати розмір зображення, оскільки автоматичний вибір може призводити до різних орієнтацій між запусками.

Як нараховується оплата за використання?

Рахунок залежить від обраного постачальника, його цін і вашого використання. Довші вхідні дані або інші умови можуть мати інші ціни.

Які типи входу підтримує Hy Image 3.5 Preview?

Модель приймає текстовий опис і зображення. За один запит можна передати до 5 референсних зображень.

Які роздільності вихідних зображень доступні?

Підтримуються роздільності 1K, 2K і 4K, а також різні співвідношення сторін.

Для яких завдань найкраще підходить ця модель?

Вона орієнтована на професійне створення зображень: рекламні візуали, комерційні постери, інфографіку, UI-дизайн, ретуш портретів і матеріали для медіа.

Чим Hy Image 3.5 Preview відрізняється від попереднього покоління?

За внутрішнім тестуванням Tencent, загальна спроможність моделі приблизно на 30% вища за попереднє покоління. Водночас це попередня версія, і поведінка може змінитися.

Чи підтримує модель багатоетапне редагування?

Так, вона підтримує багатоетапне діалогове створення та редагування з урахуванням попереднього контексту, а також узгоджене редагування за референсними зображеннями.

Схожі моделі