메인 콘텐츠로 건너뛰기
POST
Text-to-image: generate an image from a text prompt
오른쪽의 대화형 플레이그라운드에서 온라인으로 테스트할 수 있습니다. 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)

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

텍스트-이미지 엔드포인트는 호출당 이미지 1개를 반환합니다(n는 효과가 없습니다). 따라서 요청을 병렬로 실행합니다:

매개변수 참조

quality, output_format, background, style 및 기타 OpenAI 스타일 필드는 자동으로 무시됩니다. 출력은 항상 PNG입니다.

응답 형식

응답 필드
  • b64_json는 data:image/png;base64, 접두사가 없는 plain base64입니다. 직접 디코딩하면 PNG를 얻을 수 있습니다.
  • url 필드는 없으며, revised_prompt도 없습니다.
  • 1024×1024 PNG는 약 1.5–1.7MB( base64로는 2.1–2.3MB)이며, 1536×1536은 약 4–5MB입니다. 클라이언트의 응답 크기 제한을 확인하십시오.
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.