APIMaster.ai

Hy Image 3.5 Preview · API 레퍼런스 및 요금

텍스트나 참조 이미지로 이미지를 생성하고 여러 단계에 걸쳐 편집할 수 있습니다.

유효한 APIMaster API 키로 Bearer 인증을 사용해 JSON 요청을 보내세요.

POST /v1/wand/hunyuan-image/v35-generation · Content-Type: application/json

요청 매개변수

필드 유형 설명
model string hy-image-v3.5-preview (필수).
messages object[] 시간순 메시지입니다. 마지막 user 메시지는 현재 지시이며 이전 메시지는 편집에 필요한 문맥입니다. 필수입니다.
size string 너비x높이 형식의 크기입니다. 예시는 4096x4096입니다. 각 변은 256~8192픽셀이며 전체 면적은 16,777,216픽셀 이하입니다.
seed int64 0부터 2⁶³−1까지의 정수입니다. 생략하거나 0을 쓰면 무작위 시드를 사용합니다.
generate_max_pixels integer size가 없을 때 적용됩니다. 값은 1,048,576, 2,359,296(기본값), 4,194,304 중 하나입니다. 중간값은 가까운 단계로 반올림됩니다. 4K에는 size를 사용하세요.
resize_max_pixels integer 이 면적을 넘는 참조 이미지를 비율을 유지하면서 축소합니다. 기본값은 1,048,576픽셀입니다.
session string 라우팅과 KV 캐시를 재사용할 수 있도록 동일 편집 세션에서 값을 유지하세요.
footnote string 오른쪽 아래의 사용자 지정 워터마크입니다. 최대 16개의 유니코드 문자입니다.
use_search_tool object {"value":true} 또는 {"value":false}를 사용합니다. 검색은 기본적으로 꺼져 있습니다.

메시지는 role(user, assistant, tool)과 content 배열로 구성됩니다. 텍스트에는 type=text와 text, 이미지에는 type=image_url과 image_url:{url:...}를 사용하세요. 공개 URL이나 MIME 접두사가 있는 데이터 URI를 지원합니다. 이미지는 각 20MB 이하, 문맥당 최대 20장이며 문맥 한도는 100,000토큰입니다. 도구 결과에 해당 tool_call_id를 반환하고 생성된 이미지에 is_generate:true를 지정하세요.

assistant 메시지는 reasoning과 tool_calls를 그대로 반환할 수 있습니다. 도구만 호출한다면 content를 생략할 수 있습니다. 호출 형식은 {id,type:"function",function:{name,arguments}}이며 arguments는 JSON 문자열입니다.

curl -X POST "https://apimaster.ai/v1/wand/hunyuan-image/v35-generation" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hy-image-v3.5-preview","size":"1024x1024","messages":[{"role":"user","content":[{"type":"text","text":"흰 배경 위의 파란 원"}]}]}'

응답

응답에 연속된 JSON 프레임이 포함될 수 있으니 실제 Content-Type에 따라 처리하세요. 최종 이미지 URL은 choices[0].delta.image.url에 있으며 크기는 width와 height에 표시됩니다. 성공하더라도 finish_reason은 null일 수 있습니다. URL을 확인하고 만료 전에 다운로드하세요. 다음 편집에서는 assembled_history를 재사용할 수 있습니다. 오류가 나거나 연결이 끊기면 request_id를 보관하세요. 생성 요청을 반복하면 요금이 다시 부과될 수 있습니다.

요금

게이트웨이는 잔액을 먼저 예약하며 tokenhub_usage.total_tokens 기준으로 한 번 정산합니다. APIMaster의 현재 가격은 모델 카드에서 확인하세요.