Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview łączy generowanie obrazów z tekstu, tworzenie na podstawie referencji i edycję w wielu turach. Tencent dokumentuje obsługę do 20 obrazów referencyjnych, automatyczny dobór rozmiaru oraz jawnie określane wymiary wyjściowe sięgające 4096 × 4096 pikseli do szczegółowych prac wizualnych.

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

O modelu

Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.

HY Image 3.5 Preview to ujednolicony model generowania i edycji obrazów firmy Tencent. Przyjmuje opis tekstowy z opcjonalnymi obrazami referencyjnymi i pozwala kontynuować to samo zadanie wizualne w kilku turach. Wynikiem jest obraz dla określonej sceny, kompozycji lub edycji. Przykłady Tencent obejmują zdjęcia produktów, plakaty kampanii, wizualizacje projektów interfejsów i koncepcje materiałów. Wybierz, czy zadanie wymaga nowego obrazu, kompozycji opartej na referencjach, czy ukierunkowanej zmiany istniejącego wyniku.

Producent oznacza tę edycję jako hy-image-v3.5-preview i dokumentuje limit promptu wynoszący 100 tys. tokenów. Wejściem jest chronologiczna rozmowa zawierająca tekst i obrazy, w której ostatnia wiadomość użytkownika podaje bieżącą instrukcję. Wcześniejsze wiadomości dostarczają kontekstu do kolejnych edycji. Różni się to od procesu z pojedynczym promptem w HY Image 3.0 i jego osobnych limitów wejścia. W ciągłym zadaniu projektowym zachowaj odpowiednie założenia, role referencji i wybrany obraz, aby kolejna instrukcja mogła rozwijać zamierzony stan wizualny.

Przygotuj obrazy referencyjne PNG lub JPEG/JPG. W udokumentowanym procesie wejście referencyjne może zawierać do 20 obrazów, każdy o rozmiarze nieprzekraczającym 20 MB. Obraz można dostarczyć jako wskazany lub zakodowany zasób. Jeśli rozmowa zawiera zbyt wiele obrazów, przewodnik producenta opisuje usuwanie w pierwszej kolejności starszych obrazów. Utrzymuj zwięzły aktywny zestaw referencji, zamiast zakładać, że każdy historyczny obraz pozostanie w kontekście. Ustawienie zmiany rozmiaru wejścia zachowuje mniejsze obrazy, a większe skaluje proporcjonalnie w kierunku docelowej powierzchni w pikselach; domyślny cel wynosi 1 048 576 pikseli. Zachowaj dość widocznych szczegółów produktu, materiału lub układu, które mają pokierować wynikiem.

Przygotowanie rozmiaru wyjścia ma dwie odrębne ścieżki. Przy automatycznym doborze generate_max_pixels określa docelową powierzchnię: 1 048 576 pikseli dla poziomu 1K, 2 359 296 dla domyślnego poziomu 1,5K lub 4 194 304 dla 2K. FAQ producenta podaje, że samo ustawienie docelowej powierzchni domyślnie wybiera proporcje kwadratu. Gdy pominięto oba ustawienia rozmiaru, model korzysta z opisu i domyślnego poziomu 1,5K. Poziomy te nie tworzą automatycznego ustawienia 4K. Użyj poziomu powierzchni, gdy zadaniu odpowiada kwadratowy obraz. Aby opis decydował o proporcjach przy domyślnym poziomie 1,5K, pomiń oba ustawienia rozmiaru; zażądaj konkretnych wymiarów, gdy układ wymaga określonego formatu pionowego lub szerokiego.

Dla jawnych wymiarów producent dopuszcza boki o dodatnich całkowitych długościach od 256 do 8192 pikseli, przy całkowitej powierzchni nieprzekraczającej 16 777 216 pikseli. Kwadrat 4096 × 4096 mieści się w tym limicie. Zakres długości boków i maksymalna powierzchnia obowiązują jednocześnie, więc bok długości 8192 pikseli nie pozwala uzyskać obrazu 8192 × 8192. Podaj wymaganą szerokość i wysokość wprost, gdy docelowy układ potrzebuje konkretnego rozmiaru, zamiast zakładać, że poziom docelowej powierzchni wyznacza te same wymiary. Uwzględnij w prompcie szczegóły wrażliwe na kadrowanie oraz potrzebną pustą przestrzeń.

Model obsługuje edycję w wielu turach przez zwracaną historię rozmowy. Tencent odróżnia ostatecznie dostarczony obraz od obrazu pośredniego używanego jako kontekst kolejnej edycji, a jego przykłady przy kontynuacji zachowują rozumowanie asystenta, żądanie narzędzia i wynik wygenerowanego obrazu. Przy kompozycji produktowej najpierw ustal obiekt i kadr, potem poproś o zmianę oświetlenia lub nowe tło, wskazując elementy, które powinny zachować wygląd. Przechowuj wybrany wynik wraz z jego historią, aby następna tura pracowała na tym obrazie, a nie na odrzuconym wariancie. W udokumentowanym procesie Tencent zarówno odnośniki do obrazu końcowego, jak i obrazów historii wygasają po 12 godzinach, dlatego zachowaj pliki obrazowe przed wykorzystaniem ich w późniejszej edycji.

Udokumentowane ustawienia obejmują ziarno losowe, własny dopisek znaku wodnego o długości do 16 znaków i opcjonalne wspomaganie wyszukiwaniem zewnętrznym, domyślnie wyłączone. Ziarno jest nieujemną liczbą całkowitą; zero lub pominięcie pozwala producentowi wybrać je losowo. Te ustawienia mają inne zadania niż sam opis. Dla wizualizacji produktu na podstawie referencji opisz wygląd produktu, kąt kamery, powierzchnię, światło i zamierzony układ, a następnie użyj referencji do określenia szczegółów identyfikujących. Dla plakatu podaj hierarchię i dokładne brzmienie tekstu, zamiast pozostawiać wymyślenie komunikatu modelowi.

Praktyczne wskazówki Tencent zalecają sprawdzanie tekstu i układu, zwłaszcza gdy znaczenie mają specyfikacje produktów, nazwy organizacji lub inne informacje faktograficzne. Sprawdź gotowy obraz pod kątem obiektu, proporcji, materiału, kadrowania i napisów. Zachowaj końcowy plik wraz z opisem i ustawieniami, a do następnej edycji użyj konkretnej instrukcji powiązanej z widocznym problemem.

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

tencent/hy-image-v3.5-preview

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

Start

Akceptowane dane wejściowe: Tekst · Obrazy
Wyniki: Obrazy

Dostępne w Ailoot · dane wejściowe i metody

Ailoot Ultra · Obrazy POST /v1/images/generations

Wejście: text, image
Wyjście: image

Pole	Typ	Wymaganie	Wartości i limity	Domyślnie
Pole`model`	Typ`string`	WymaganieWymagane	Wartości i limity tencent/hy-image-v3.5-preview	Domyślnie—
Pole`prompt`	Typ`string`	WymaganieWymagane	Wartości i limity Minimalna długość: 1	Domyślnie—
Pole`resolution`	Typ`string`	WymaganieOpcjonalne	Wartości i limity 1K, 1.5K, 2K, 4K	Domyślnie—
Pole`aspect_ratio`	Typ`string`	WymaganieOpcjonalne	Wartości i limity 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	Domyślnie—
Pole`n`	Typ`integer`	WymaganieOpcjonalne	Wartości i limity Minimum: 1 Maksimum: 1	Domyślnie—
Pole`input_references`	Typ`array`	WymaganieOpcjonalne	Wartości i limity Minimalna liczba elementów: 0 Maksymalna liczba elementów: 20	Domyślnie—
Pole`provider`	Typ`object`	WymaganieOpcjonalne	Wartości i limity	Domyślnie—

Parametry i cykl życia metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_types`	Kontrakttext, image

Cykl życia: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Rzeczywiście zwrócony task_id lub wpis w bibliotece multimediów

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cennik

Jak obliczana jest ostateczna opłata

Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.

Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.

Tryb szybki: Nie określono Gdy wybrany jest tryb szybki
Tryb flex: Nie określono Gdy wybrany jest tryb flex
Maksymalna intensywność rozumowania: Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)

Szacunkowe stawki do porównania

Ceny według konfiguracji

Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.

Konfiguracja	Tabela stawek	Przewidywana ilość	Jednostka rozliczeniowa	Opłata
KonfiguracjaBazowe stawki za tokeny	Tabela stawekStawka podstawowa	Przewidywana ilość—	Jednostka rozliczeniowa—	Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów
Konfiguracjatoken obrazu wyjściowego	Tabela stawek—	Przewidywana ilość—	Jednostka rozliczeniowa/ 1K tokenów obrazu	Opłata Wyjście · token obrazu wyjściowego · Szacunek tylko do porównania $0.0032 / 1K tokenów obrazu
KonfiguracjaSzacowany koszt generowania	Tabela stawek—	Przewidywana ilośćszacunek dla jednego generowania	Jednostka rozliczeniowa—	Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.0131072 szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.

Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →

Przykładowe żądania

Ailoot Ultra · Obrazy

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

Odbieranie i zapisywanie wyników

Ailoot Ultra · Obrazy

Pobierz każdy zwrócony obraz lub zapisz jego zawartość Base64

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

Inne odczyty treści

Odczytaj istniejące zasoby należące do Ciebie

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.

Zachowaj wszystkie ukończone wyniki

Zapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość Base64.

Zachowaj pełną odpowiedź i nagłówki, wszystkie rzeczywiście uzyskane wyniki, pierwotnie zwrócone identyfikatory oraz wszystkie pola zużycia. Odzyskaj pierwotną operację bez ponownego wysyłania żądania utworzenia.

Jeśli trzeba sprawdzić pierwotną odpowiedź

Zachowaj zwrócony X-Client-Request-ID do uzgodnienia danych. Odczytuj wyłącznie rzeczywiście zwrócone wartości task_id/asset_id lub własną bibliotekę multimediów; nigdy nie buduj adresu URL zadania na podstawie identyfikatora operacji i nigdy nie wysyłaj ponownie żądania utworzenia.

Pola odpowiedzi

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelu

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

Aliasy ścieżek metod

/v1/images

Powiązane ID modeli

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

Jakie dane wejściowe i wyniki są dostępne?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
Jakich pól używa żądanie?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
Jakie limity obowiązują?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview