Skip to main content
POST
문서 Playground는 파일 업로드를 지원하지 않습니다: 아래의 cURL, Python 또는 JavaScript 코드 예제를 사용하여 테스트해 주세요.
임시 저장: 업로드된 이미지는 72시간 동안만 저장됩니다. 이 기간이 지나면 이미지 URL이 만료됩니다. 유효 기간 내에 이미지를 사용하거나 본인의 스토리지 서비스에 미리 저장해 주세요.
중요 변경사항: 더 나은 성능과 비용 관리를 위해 생성 API에서 base64 이미지 데이터를 직접 전달하는 것은 더 이상 지원되지 않습니다. 본 API를 사용하여 이미지를 업로드하고 URL을 획득한 후 생성 API를 호출해 주세요.

왜 이미지를 먼저 업로드해야 하나요?

  1. 성능 최적화 - base64 인코딩은 데이터를 33% 팽창시킵니다. 먼저 업로드하면 요청 본문 크기를 크게 줄일 수 있습니다
  2. 이미지 재사용 - 한 번 업로드하면 URL을 여러 번 사용할 수 있어 중복 전송이 필요 없습니다

사용 흐름

Authorizations

string
필수
모든 API는 Bearer Token 인증이 필요합니다API Key 획득:API Key 관리 페이지에서 API Key를 획득하세요요청 헤더에 추가:

Body

file
필수
이미지 파일지원 형식: JPEG (.jpg, .jpeg), PNG (.png), WebP (.webp), GIF (.gif)최대 파일 크기: 20MB

Response

string
이미지의 공개 접근 URL, 생성 API에서 직접 사용 가능 (72시간 유효)
string
원본 파일명
string
감지된 MIME 유형, 예: image/jpeg
integer
파일 크기(바이트)
integer
업로드 시간의 Unix 타임스탬프(초)

전체 예제: 이미지 생성 워크플로우

Python