이미지

이미지 생성

텍스트 프롬프트로 이미지를 생성합니다. 기본적으로 OpenAI 호환 동기 JSON을 반환하며(client.images.generate()와 바로 호환), stream: true를 전달하면 SSE 이벤트 스트림을 반환합니다. inputImages / input_references로 image-to-image도 지원합니다.

POST/api/v1/images/generations

인증

Authorization필수

string · header

Authorization 헤더에 Bearer 토큰으로 API 키를 전달합니다.

Body

model필수

string

사용할 이미지 생성 모델. 공급자 접두사 형식, 예: "openai/gpt-image-2".

minLength: 1

Example: "openai/gpt-image-2"

prompt필수

string

원하는 이미지의 텍스트 설명.

minLength: 1

Example: "a red cat on a sofa"

n

integer

생성할 이미지 수, 1–10.

1–10

Example: 1

size

string

이미지 크기 — 명시적 픽셀("2048x2048") 또는 티어("2K", "4K"). 공급자에게 그대로 전달되며 지원 크기는 모델마다 다릅니다.

Example: "1024x1024"

stream

boolean

응답 형태 선택: 생략 또는 false = OpenAI 호환 동기 JSON(기본값), true = SSE 이벤트 스트림.

input_references

string[]

이미지-투-이미지(i2i)용 소스 이미지(data: 또는 https: URL), 최대 8장. inputImages의 별칭(업계 관례 필드명 호환)이며 둘 다 먼저 콘텐츠 심사를 거칩니다. 모델 라우트가 i2i를 지원하지 않으면 warning이 아닌 400을 반환합니다.

≤ 8 images

aspect_ratio

enum<string>

생성 이미지의 종횡비. 일부 모델 라우트에서 기본 지원됩니다 — 각 모델의 실제 지원 파라미터는 GET /api/v1/images/models 응답의 supported_parameters에서 확인하세요. 미지원 라우트는 이 필드를 무시하고 응답의 warnings[]에 기록합니다(요청 자체는 성공).

1:11:21:41:82:12:33:23:44:14:34:55:48:19:1616:99:19.519.5:99:2020:99:2121:9auto

Example: "16:9"

resolution

enum<string>

해상도 티어. 실제 픽셀은 공급자별로 환산됩니다. 일부 모델 라우트에서 기본 지원됩니다 — 각 모델의 실제 지원 파라미터는 GET /api/v1/images/models 응답의 supported_parameters에서 확인하세요. 미지원 라우트는 이 필드를 무시하고 응답의 warnings[]에 기록합니다(요청 자체는 성공).

5121K2K4K

Example: "2K"

quality

enum<string>

렌더링 품질. 일부 모델 라우트에서 기본 지원됩니다 — 각 모델의 실제 지원 파라미터는 GET /api/v1/images/models 응답의 supported_parameters에서 확인하세요. 미지원 라우트는 이 필드를 무시하고 응답의 warnings[]에 기록합니다(요청 자체는 성공).

autolowmediumhigh

background

enum<string>

배경 처리. transparent는 알파 지원 output_format(png/webp)이 필요합니다. 일부 모델 라우트에서 기본 지원됩니다 — 각 모델의 실제 지원 파라미터는 GET /api/v1/images/models 응답의 supported_parameters에서 확인하세요. 미지원 라우트는 이 필드를 무시하고 응답의 warnings[]에 기록합니다(요청 자체는 성공).

autotransparentopaque

output_format

enum<string>

반환되는 이미지 바이트의 인코딩. 일부 모델 라우트에서 기본 지원됩니다 — 각 모델의 실제 지원 파라미터는 GET /api/v1/images/models 응답의 supported_parameters에서 확인하세요. 미지원 라우트는 이 필드를 무시하고 응답의 warnings[]에 기록합니다(요청 자체는 성공).

pngjpegwebpsvg

Example: "png"

output_compression

integer

webp/jpeg 출력의 압축 수준(0–100). png에서는 무시됩니다. 일부 모델 라우트에서 기본 지원됩니다 — 각 모델의 실제 지원 파라미터는 GET /api/v1/images/models 응답의 supported_parameters에서 확인하세요. 미지원 라우트는 이 필드를 무시하고 응답의 warnings[]에 기록합니다(요청 자체는 성공).

0–100

Example: 100

seed

integer

결정론적 샘플링 시드. 동일한 시드+파라미터는 같은 결과를 재현해야 하지만 모든 공급자가 보장하지는 않습니다. 일부 모델 라우트에서 기본 지원됩니다 — 각 모델의 실제 지원 파라미터는 GET /api/v1/images/models 응답의 supported_parameters에서 확인하세요. 미지원 라우트는 이 필드를 무시하고 응답의 warnings[]에 기록합니다(요청 자체는 성공).

심층 가이드 →

POST /api/v1/images/generations

1
2
3
4
5
6
7
8
curl https://bazaarlink.ai/api/v1/images/generations \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "a red cat on a sofa",
    "size": "1024x1024"
  }'

응답 예시

성공. 기본값(또는 stream: false)은 아래 동기 JSON을, stream: true면 SSE 이벤트 스트림을 반환합니다(이벤트 프로토콜은 심층 가이드 참조). 라우트가 무시한 파라미터는 최상위 warnings[]에 표시됩니다(정보 제공용).

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "created": 1753500000,
  "data": [
    {
      "url": "https://bazaarlink.ai/api/v1/images/proxy/eyJhbGciOi..."
    }
  ],
  "warnings": [
    {
      "param": "aspect_ratio",
      "action": "dropped",
      "reason": "'aspect_ratio' is not yet mapped for this model's upstream and was ignored; the image was still generated using the model's default."
    }
  ]
}