문서

API 참조

HTTPS 참조 이미지 가져오기

POST/v1/image-assets/import

업로드가 비활성화되면 경로는 즉시 404를 반환합니다. 단일 JSON 객체가 필수이며 알 수 없는 필드는 거부하고 본문은 8192바이트로 제한합니다. 실패하거나 준비되지 않은 가져오기를 생성 재시도로 취급하지 마세요.

인증과 권한

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

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

요청 헤더

  • Idempotency-Keystring필수

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

    최소 길이
    1
    최대 길이
    191

요청 본문 · application/json

유형
object
필수 필드
url
추가 속성
false

요청 본문 필수

  • urlstring필수

    공개 HTTPS 이미지 URL이며 SSRF와 이미지 콘텐츠 검증을 적용합니다.

    형식
    "uri"

응답과 오류

HTTP 200

HTTPS 참조 이미지 가져오기 성공

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

HTTP 401

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

application/json

유형
object
필수 필드
error

HTTP 403

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

application/json

유형
object
필수 필드
error

HTTP 404

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

application/json

유형
object
필수 필드
error

HTTP 409

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

application/json

유형
object
필수 필드
error

HTTP 429

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

application/json

유형
object
필수 필드
error

HTTP 500

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

application/json

유형
object
필수 필드
error

HTTP 503

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

application/json

유형
object
필수 필드
error
개발할 준비가 되셨나요? 열기: 콘솔 API 키를 생성하거나 살펴보기: 기능.