이미지 업로드 API 문서

인터페이스 개요

이 인터페이스는 이미지 파일을 서버에 업로드하는 데 사용되며 다양한 이미지 형식의 업로드를 지원합니다.

인터페이스 세부정보

정보 요청

요청 URL: https://imageproxy.zhongzhuan.chat/api/upload

요청 방법: POST

콘텐츠 유형: 다중 부분/양식 데이터

요청 매개변수

매개변수 이름	유형	필수	설명
파일	파일	예	업로드할 이미지 파일

요청 예시

cURL 예

``배쉬
컬 -X POST
https://imageproxy.zhongzhuan.chat/api/upload
-H '콘텐츠 유형: 다중 부분/양식 데이터'
-F '파일=@/path/to/your/image.jpg'


#### 자바스크립트 예
``자바스크립트
const formData = 새로운 FormData();
formData.append('file', fileInput.files[0]);

fetch('https://imageproxy.zhongzhuan.chat/api/upload', {
  메소드: 'POST',
  본문: formData
})
.then(응답 => response.json())
.then(데이터 => {
  console.log('업로드 성공:', data);
})
.catch(오류 => {
  console.error('업로드 실패:', error);
});

파이썬 예제

``파이썬
수입요청

URL = "https://imageproxy.zhongzhuan.chat/api/upload"
files = {'파일': open('image.jpg', 'rb')}

응답 = 요청.포스트(url, 파일=파일)
인쇄(응답.json())


### 응답정보

#### 응답 성공
**HTTP 상태 코드**: `200 OK`

**응답 형식**: JSON

| 필드명 | 유형 | 설명 |
|---------|------|------|
| URL | 문자열 | 업로드 성공 후 이미지 액세스 링크 |
| 생성됨 | 번호 | 생성 타임스탬프(밀리초) |

#### 응답 예시
``json
{
    "url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/2316ce07a01000cf14a628c8b29e97a8",
    "생성됨": 1757403998946
}

오류 응답

가능한 오류 상태 코드:

상태 코드	설명
400	요청 매개변수 오류(예: 파일이 제공되지 않음)
413	파일이 너무 큼
415	지원되지 않는 파일 형식
500	서버 내부 오류

오류 응답 예시

``json
{
"error": "지원되지 않는 파일 형식",
"코드": 415
}


## 사용 지침

1. **지원되는 파일 형식**: JPG, PNG, GIF, WebP 등 일반적인 이미지 형식입니다.
2. **파일 크기 제한**: 단일 파일은 10MB를 초과하지 않는 것이 좋습니다.
3. **반환된 URL**: 이미지를 표시하는 데 직접 사용할 수 있으며 링크는 오랫동안 유효합니다.
4. **타임스탬프 형식**: Unix 타임스탬프, 단위는 밀리초

## 메모

- 업로드된 이미지는 접근 안정성 확보를 위해 프록시 서비스를 통해 처리됩니다.
- 업로드 속도를 높이려면 클라이언트에서 이미지를 적절하게 압축하는 것이 좋습니다.
- 반환된 이미지 링크는 도메인 간 액세스를 지원합니다.
- 업로드하기 전에 인터넷 연결과 적절한 권한이 있는지 확인하십시오.

자체 구축된 이미지 베드 API

이미지 업로드 API 문서#

인터페이스 개요#

인터페이스 세부정보#

정보 요청#

요청 매개변수#

요청 예시#

cURL 예#

파이썬 예제#

오류 응답#

오류 응답 예시#