모델

Tencent: Hy Image 3.5 Preview

Markdown · JSON

Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview는 텍스트 이미지 생성, 참조 기반 제작, 여러 차례 대화를 통한 편집을 결합합니다. Tencent는 최대 20개의 참조 이미지, 자동 크기 선택, 세밀한 시각 작업을 위한 최대 4096 × 4096 이미지의 명시적 출력 크기를 문서화합니다.

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

HY Image 3.5 Preview는 Tencent의 통합 이미지 생성 및 편집 모델입니다. 작성한 지시서와 선택 사항인 참조 이미지를 받아 같은 시각 작업을 여러 차례 대화로 이어갈 수 있습니다. 결과는 정해진 장면, 구도, 편집에 해당하는 이미지입니다. Tencent의 예시에는 제품 이미지, 캠페인 포스터, 인터페이스 디자인 이미지, 소재 콘셉트가 포함됩니다. 새 이미지, 참조를 반영한 구도, 기존 결과의 특정 변경 중 작업에 필요한 방식을 선택하세요.

제작사는 에디션을 hy-image-v3.5-preview로 식별하고 프롬프트 한도를 100K 토큰으로 명시합니다. 입력은 텍스트와 이미지가 포함된 시간순 대화이며 마지막 사용자 메시지가 현재 지시를 제공합니다. 이전 메시지는 반복 편집의 맥락을 제공합니다. 이는 HY Image 3.0의 단일 프롬프트 작업 및 별도의 입력 제한과 다릅니다. 이어지는 디자인 작업에서는 관련 지시서, 참조 역할, 선택한 이미지를 유지해 다음 지시가 의도한 시각 상태에서 발전하도록 하세요.

PNG 또는 JPEG/JPG 참조 이미지를 준비하세요. 문서의 작업 흐름은 참조 입력 최대 20개를 허용하며 각 이미지는 20 MB 이하여야 합니다. 이미지는 참조하거나 인코딩한 자료로 제공할 수 있습니다. 대화에 이미지가 너무 많으면 제작사 가이드는 오래된 이미지부터 줄이는 방식을 설명합니다. 모든 과거 이미지가 맥락에 남아 있을 것으로 기대하지 말고 활성 참조 세트를 집중적으로 유지하세요. 입력 크기 조정 설정은 작은 이미지를 유지하고 큰 이미지를 픽셀 면적 목표에 맞춰 비례 축소하며, 기본 목표는 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시간 뒤 만료되므로 나중 편집에 사용하기 전에 이미지 자료를 보관해야 합니다.

문서의 설정에는 시드, 최대 16자의 사용자 지정 워터마크 각주, 선택 사항인 외부 검색 보강이 포함되며 외부 검색은 기본적으로 꺼져 있습니다. 시드는 음이 아닌 정수이며 0을 지정하거나 생략하면 제작사가 무작위로 선택합니다. 이 설정들의 목적은 지시서 자체와 다릅니다. 참조 기반 제품 이미지에서는 제품 외관, 카메라 각도, 바닥면, 조명, 원하는 레이아웃을 설명한 다음 참조로 식별 디테일을 안내하세요. 포스터에서는 메시지를 임의로 만들게 두지 말고 위계와 정확한 문구를 제공하세요.

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

시작하기

HY Image 3.5 Preview는 텍스트 이미지 생성, 참조 기반 제작, 여러 차례 대화를 통한 편집을 결합합니다. Tencent는 최대 20개의 참조 이미지, 자동 크기 선택, 세밀한 시각 작업을 위한 최대 4096 × 4096 이미지의 명시적 출력 크기를 문서화합니다.

허용 입력
텍스트 · 이미지
결과
이미지

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 모드
미지정 flex 모드를 선택한 경우
최대 추론 수준
미지정 최대 추론 수준에 default 조정값을 적용하는 경우

비교용 예상 요금

설정별 가격

각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.

설정요금표예측 수량과금 단위요금
설정기본 토큰 요금요금표기본 요금예측 수량—과금 단위—요금
입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰
출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰
설정이미지 출력 토큰요금표—예측 수량—과금 단위/ 1K 이미지 토큰요금
출력 · 이미지 출력 토큰 · 비교 전용 추정치 $0.0032 / 1K 이미지 토큰
설정예상 생성 비용요금표—예측 수량1회 생성 예상치과금 단위—요금
출력 · 예상 생성 비용 · 비교 전용 추정치 $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

자세히 보기

Claude Code, OpenCode, Hermes, 자체 앱에 Ailoot를 연결하세요.

회사와 그 프로젝트 포트폴리오

회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.

할인받아 토큰을 구매하세요.

정기 작업에는 구독 할인, 토큰 구매에는 최대 50% 프로모션 코드.

구독
정기 요청에 맞는 할인 요금제를 선택하세요.
최대 50% 프로모션 코드
구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다.
이력의 지출
요청마다 모델, 토큰, 금액을 저장합니다.

구독 선택 · 모델 가격 보기

판매하는 제품에 API를 연결하세요.

Ailoot 공식 이용 조건과 라이선스 계약으로 SaaS, 앱, 봇에 사용하세요. 재판매에는 리셀러 라이선스를 요청하세요.

상업용 앱
서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요.
리셀러 라이선스
프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요.
사이트의 문서
연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다.

리셀러 라이선스 요청 · 공식 이용 조건과 라이선스 계약