API 참조

참조 이미지 업로드

POST/v1/image-assets

첫 번째이자 유일한 multipart 파트는 file이어야 하며 파일명을 포함해야 합니다. 애니메이션이 아닌 JPEG/PNG/WebP만 허용하며 업로드 시와 재인코딩 후 모두 10 MiB 이하여야 합니다.

인증과 권한

현재 GloopAPI 키를 사용하세요. 사용 가능한 모델, 기능과 권한은 해당 카탈로그와 엔드포인트 문서에 따라 달라집니다.

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

요청 헤더

Idempotency-Keystring필수
동일한 키로 원래 요청 의도를 유지하세요. 네트워크 중단 후 먼저 복구를 조회하고 불명확한 상태를 무조건 재전송하지 마세요.

최소 길이
1
최대 길이
191

요청 본문 · multipart/form-data

유형: object
필수 필드: file
추가 속성: false

요청 본문 필수

filestring필수
파일명을 포함하는 유일한 이미지 파트입니다. 애니메이션이 아닌 JPEG/PNG/WebP <=10MiB입니다.

형식
"binary"

응답과 오류

HTTP 200

참조 이미지 업로드 성공

application/json

유형: object
필수 필드: idmime_typesize_byteswidthheightexpires_at

file_idstring선택 사항
동일 계정/키의 관리형 파일 공개 ID입니다.
idstring필수
해당 상세 경로에 사용하는 이 객체의 공개 식별자입니다.
mime_typestring필수
검증된 파일 MIME 유형입니다.
size_bytesinteger필수
바이트 단위 파일 크기입니다.
widthinteger필수
픽셀 단위 이미지 너비입니다.
heightinteger필수
픽셀 단위 이미지 높이입니다.
expires_atinteger필수
Unix 초이며 0은 고정 만료 시각이 없음을 뜻합니다. 업로드는 관리형 파일에 연결되며 조회에는 동일한 계정과 키가 필요합니다.

HTTP 400

요청 필드 또는 매개변수가 유효하지 않습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 401

키가 없거나 유효하지 않거나 만료 또는 폐기되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 403

IP, 계정, 모델 또는 도구 권한이 부족합니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 404

객체/기능을 사용할 수 없거나 기능 스위치가 비활성화되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 409

멱등성/견적 충돌, 준비되지 않은 객체 또는 여전히 참조 중인 상태입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 429

요청/대기열 속도 제한입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 500

내부 인증 또는 데이터 저장 오류입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 503

서비스, 가격 또는 스토리지를 사용할 수 없습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항