Skip to main content
POST
Text-to-image: generate an image from a text prompt
오른쪽의 인터랙티브 Playground를 통해 온라인에서 바로 테스트할 수 있습니다. Authorization 항목에 API 키를 입력하고(형식: Bearer sk-xxx), model을(를) 선택한 후 prompt을(를) 입력하고, 필요한 경우 width / height을(를) 설정한 다음 전송하십시오.
사용 사례: 이 페이지는 텍스트를 통한 이미지 생성 전용입니다. 기존 이미지를 수정하거나 두 이미지를 합성하려면 이미지 편집 API를 사용하십시오.
⚠️ 400을 반환하는 세 가지 매개변수이 시리즈는 response_format, seed 또는 negative_prompt을(를) 지원하지 않으며, 이 중 하나라도 전송하면 400 Invalid parameters: xxx이(가) 반환됩니다. gpt-image / DALL·E에서 마이그레이션하는 경우 먼저 response_format을(를) 제거하십시오. 응답은 항상 data[0].b64_json 형식입니다.
⚠️ size 대신 width + height를 사용하십시오이 엔드포인트는 size을(를) 별도의 알림 없이 무시하고 항상 1024×1024 크기로 렌더링합니다. 정수형 width + height을(를) 사용하십시오(항상 함께 지정): 각 변의 길이는 768 이상이어야 하며, width × height ≤ 2,359,296(1536×1536 면적)이어야 합니다.
모든 이미지 API는 동기식입니다. 비동기 작업 ID가 제공되지 않습니다. 클라이언트 연결이 끊어지면 결과는 유실되지만 해당 요청에 대해서는 과금이 계속 진행됩니다. 1024×1024 이미지는 Flash에서 약 17초, 2.6에서 약 30초가 소요됩니다. 클라이언트 타임아웃을 Flash의 경우 최소 120초, 2.6의 경우 최소 180초로 설정하십시오. 자세한 내용은 이미지 API 필수 사항 및 모범 사례를 참고하십시오.

코드 예제

Python (OpenAI SDK)

Python (requests)

cURL

Node.js (fetch)

여러 장의 이미지가 필요한 경우: 병렬 요청 전송

text-to-image 엔드포인트는 1회 호출당 1장의 이미지를 반환하므로(n은 적용되지 않음), 요청을 병렬로 실행하십시오:

파라미터 레퍼런스

quality, output_format, background, style 및 기타 OpenAI 스타일 필드는 조용히 무시됩니다. 출력은 항상 PNG입니다.

응답 형식

응답 필드
  • b64_json은(는) data:image/png;base64, 접두사가 없는 순수 base64입니다. 이를 직접 디코딩하여 PNG를 가져올 수 있습니다.
  • url 필드가 없으며, revised_prompt도 없습니다.
  • 1024×1024 PNG는 약 1.5–1.7 MB(base64 기준 2.1–2.3 MB)이며, 1536×1536은 약 4–5 MB입니다. 클라이언트의 응답 크기 제한을 확인하시기 바랍니다.
usage(으)로 과금을 대조하지 마십시오: prompt_tokens은 항상 1000 × 이미지 수이고 output_tokens는 항상 0이며, 이는 플레이스홀더입니다. 이 시리즈는 이미지당 과금되며, APIYI 콘솔 청구 내역이 공식 기준입니다.

인증

Authorization
string
header
필수

API key from the APIYI console

본문

application/json
model
enum<string>
기본값:MAI-Image-2.6-Flash
필수

Model ID (case-sensitive). 2.6 favors quality, Flash favors speed

사용 가능한 옵션:
MAI-Image-2.6-Flash,
MAI-Image-2.6
prompt
string
필수

Prompt in any language. Put text that should appear in the image in quotes

예시:

"A traditional teahouse storefront with a wooden sign that reads \"Welcome\", red lanterns, warm dusk light, photorealistic"

width
integer
기본값:1024

Output width in pixels. Each side ≥ 768, width × height ≤ 2,359,296 (a 1536×1536 area); must be sent together with height; rounded down to a multiple of 16.

필수 범위: x >= 768
예시:

1024

height
integer
기본값:1024

Output height in pixels, same rules as width

필수 범위: x >= 768
예시:

1024

응답

Image generated

created
integer

Creation timestamp

예시:

1790999642

data
object[]

Image results; always 1 item for text-to-image

usage
object

Placeholder values, not for billing reconciliation. prompt_tokens is always 1000 × images and output_tokens is always 0. The console bill is authoritative.