Image Upload API Documentation

API Overview

This API is used to upload image files to the server and supports uploading multiple image formats.

API Details

Request Information

Request URL: https://imageproxy.zhongzhuan.chat/api/upload

Request Method: POST

Content-Type: multipart/form-data

Request Parameters

Parameter	Type	Required	Description
file	File	Yes	The image file to upload

Request Examples

cURL Example

JavaScript Example

Python Example

Response Information

Success Response

HTTP Status Code: 200 OK

Response Format: JSON

Field	Type	Description
url	String	The accessible URL of the image after a successful upload
created	Number	Creation timestamp (milliseconds)

Response Example

{
    "url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/2316ce07a01000cf14a628c8b29e97a8",
    "created": 1757403998946
}

Error Responses

Possible error status codes:

Status Code	Description
400	Invalid request parameters (e.g., no file provided)
413	File too large
415	Unsupported file format
500	Internal server error

Error Response Example

{
    "error": "Unsupported file format",
    "code": 415
}

Usage Notes

Supported File Formats: Common image formats such as JPG, PNG, GIF, WebP, etc.

File Size Limit: It is recommended that a single file does not exceed 10MB

Returned URL: Can be used directly to display the image; the link remains valid long-term

Timestamp Format: Unix timestamp in milliseconds

Important Notes

Uploaded images are processed through a proxy service to ensure access stability

It is recommended to appropriately compress images on the client side to improve upload speed

The returned image URL supports cross-origin access

Before uploading, ensure you have a network connection and the appropriate permissions

Self-hosted Image Hosting API

Image Upload API Documentation#

API Overview#

API Details#

Request Information#

Request Parameters#

Request Examples#

cURL Example#

JavaScript Example#

Python Example#

Response Information#

Success Response#

Response Example#

Error Responses#

Error Response Example#

Usage Notes#

Important Notes#