Hy-Image-3.5 Preview 이미지 생성

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "hy-image-v3.5-preview",
    "prompt": "A golden retriever running on a beach in warm evening light",
    "size": "16:9",
    "resolution": "2K"
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/images/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "hy-image-v3.5-preview",
        "prompt": "A golden retriever running on a beach in warm evening light",
        "size": "16:9",
        "resolution": "2K"
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "hy-image-v3.5-preview",
    prompt: "A golden retriever running on a beach in warm evening light",
    size: "16:9",
    resolution: "2K"
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K..."
    }
  ]
}

POST

images

generations

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "hy-image-v3.5-preview",
    "prompt": "A golden retriever running on a beach in warm evening light",
    "size": "16:9",
    "resolution": "2K"
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/images/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "hy-image-v3.5-preview",
        "prompt": "A golden retriever running on a beach in warm evening light",
        "size": "16:9",
        "resolution": "2K"
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "hy-image-v3.5-preview",
    prompt: "A golden retriever running on a beach in warm evening light",
    size: "16:9",
    resolution: "2K"
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K..."
    }
  ]
}

비동기 API입니다. 제출 후 data[0].task_id에서 작업 ID를 얻고 작업 조회로 상태와 이미지를 확인하세요. 3~5초 간격 폴링과 클라이언트 전체 대기 시간 5분을 권장합니다. completed 또는 failed에서 중지하세요.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "hy-image-v3.5-preview",
    "prompt": "A golden retriever running on a beach in warm evening light",
    "size": "16:9",
    "resolution": "2K"
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/images/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "hy-image-v3.5-preview",
        "prompt": "A golden retriever running on a beach in warm evening light",
        "size": "16:9",
        "resolution": "2K"
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "hy-image-v3.5-preview",
    prompt: "A golden retriever running on a beach in warm evening light",
    size: "16:9",
    resolution: "2K"
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K..."
    }
  ]
}

요청 헤더

string

필수

Bearer 인증: Bearer <token>. <token>은 APIMart API Key입니다.

요청 매개변수

string

필수

고정값: hy-image-v3.5-preview.

string

필수

이미지 생성 또는 편집 설명. 중국어와 영어를 지원하며 비워둘 수 없습니다.

string

기본값:"auto"

출력 화면비 또는 정확한 픽셀 크기.

화면비: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9.
정확한 픽셀: 예를 들어 2000x1104. 아래 픽셀 제한을 따라야 합니다.
auto 또는 생략: 모델이 프롬프트에 따라 화면비를 결정합니다.

정확한 픽셀을 지정하면 resolution은 크기 선택에 사용되지 않습니다.

string

기본값:"1K"

출력 해상도: 1K, 2K 또는 4K. 기본값은 1K.정확한 픽셀 지정 시 이 필드는 크기 선택에 사용되지 않습니다. 항상 지원하는 값을 사용하세요. 미지원 값은 HTTP 400을 반환합니다.

integer

정확한 출력 너비(픽셀). height와 함께 지정해야 하며 size와 resolution보다 우선합니다.너비는 256~8192이며 너비 × 높이는 8,294,400 이하여야 합니다. 16의 배수를 권장합니다.

integer

정확한 출력 높이(픽셀). width와 함께 지정해야 합니다.높이는 256~8192이며 너비 × 높이는 8,294,400 이하여야 합니다. 16의 배수를 권장합니다.

string[]

공개 참조 이미지 URL 목록, 최대 5장. 생략하면 텍스트 기반 생성, 제공하면 같은 API에서 참조 이미지 기반 생성입니다.JPEG, PNG, WEBP를 지원하며 장당 7MB 미만을 권장합니다. URL은 공개 접근 가능해야 합니다.

string

이미지에 포함하지 않을 내용.

integer

난수 시드. 음이 아닌 정수여야 합니다. 0 또는 생략 시 무작위입니다.

integer

기본값:"1"

요청당 1장만 생성하며 1만 허용합니다. 다른 값은 HTTP 400을 반환합니다.

크기 선택

우선순위: width / height 쌍 → size의 정확한 픽셀 → size의 화면비 또는 auto와 resolution 조합. 정확한 픽셀은 너비와 높이가 각각 256~8192, 총 픽셀 수가 8,294,400 이하여야 합니다. 둘 다 16의 배수를 권장합니다.

정확한 픽셀 예시

{
  "model": "hy-image-v3.5-preview",
  "prompt": "A minimalist seaside travel poster with a warm sunset",
  "width": 2000,
  "height": 1104
}

width와 height를 생략하고 대신 "size": "2000x1104"를 전달할 수도 있습니다.

참조 이미지 생성 예시

{
  "model": "hy-image-v3.5-preview",
  "prompt": "Make the car in the reference image red, preserving the original background and lighting",
  "image_urls": ["https://example.com/car.png"],
  "size": "16:9",
  "resolution": "2K",
  "negative_prompt": "blur, text watermarks",
  "seed": 42,
  "n": 1
}

예시 URL을 실제 공개 접근 가능한 이미지 주소로 바꾸세요. 여러 참조 이미지는 image_urls에 추가하되 총 5장 이하여야 합니다.

제출 응답

integer

응답 상태 코드. 성공은 200.

array

작업 제출 결과.

표시 작업 필드 표시

string

submitted는 제출 성공이며 이미지 생성 완료를 의미하지 않습니다.

string

상태와 결과 조회에 사용하는 작업 ID.

작업 결과 조회

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01K... \
  --header 'Authorization: Bearer <token>'

성공 응답 예시(이미지 URL은 자리표시자):

{
  "code": 200,
  "data": {
    "id": "task_01K...",
    "status": "completed",
    "result": {
      "images": [
        {
          "url": ["https://example.com/generated-image.png"]
        }
      ]
    }
  }
}

pending / processing: 폴링 계속.
completed: data.result.images[0].url[0]에서 이미지 주소 확인. url은 문자열 배열입니다.
failed: 폴링을 중지하고 data.error.message에서 원인을 확인하세요. 전액 환불됩니다. 프롬프트 위반이나 콘텐츠 심사 불통과도 실패로 처리됩니다.

이미지는 플랫폼 CDN에 저장됩니다. 조회 결과의 expires_at 시각 전에 다운로드하여 보관하세요.

요금

이미지당 과금합니다. 실제 가격은 모델 요금을 확인하세요.

화면비 사용 시 resolution 등급에 따라 과금합니다.
정확한 픽셀 사용 시 이미지의 짧은 변으로 등급을 정합니다:

등급	짧은 변
1K	1024픽셀 이하
2K	1025~2048픽셀
4K	2048픽셀 초과

작업 실패 시 전액 환불됩니다.

일반적인 매개변수 오류

다음은 동기적으로 HTTP 400을 반환하며 작업 생성 및 과금이 없습니다:

문제	해결
빈 `prompt`	비어 있지 않은 프롬프트 제공
`n`이 `1`이 아님	요청당 1장만 생성
음수 `seed`	음이 아닌 정수 사용. `0`은 무작위
미지원 `resolution`	`1K`, `2K` 또는 `4K` 사용
`size`의 미지원 화면비	위의 10가지 화면비 또는 `auto` 사용
픽셀 범위 초과	너비와 높이는 각각 256~8192, 총 픽셀 수는 8,294,400 이하
참조 이미지 5장 초과	`image_urls`를 최대 5장으로 줄이기

개요

모델

텍스트 시리즈

이미지 시리즈

비디오 시리즈

오디오 시리즈

모더레이션 시리즈

업로드 관리

작업 관리

계정 관리

Hy-Image-3.5 Preview 이미지 생성

요청 헤더

요청 매개변수

크기 선택

정확한 픽셀 예시

참조 이미지 생성 예시

제출 응답

작업 결과 조회

요금

일반적인 매개변수 오류

​요청 헤더

​요청 매개변수

​크기 선택

​정확한 픽셀 예시

​참조 이미지 생성 예시

​제출 응답

​작업 결과 조회

​요금

​일반적인 매개변수 오류

요청 헤더

요청 매개변수

크기 선택

정확한 픽셀 예시

참조 이미지 생성 예시

제출 응답

작업 결과 조회

요금

일반적인 매개변수 오류