Image upload API documentation

Interface overview

This interface is used to upload image files to the server and supports the upload of multiple image formats.

Interface details

Request information

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

Request method: POST

Content-Type: multipart/form-data

Request parameters

Parameter name	Type	Required	Description
file	File	Yes	Image file to upload

Request example

cURL example

JavaScript Example

Python example

Response information

Successful response

HTTP status code: 200 OK

Response format: JSON

Field name	Type	Description
url	String	Image access link after successful upload
created	Number	Creation timestamp (milliseconds)

Response example

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

Error response

Possible error status codes:

Status code	Description
400	Request parameter error (such as: file not provided)
413	File too large
415	Unsupported file format
500	Server internal error

Error response example

{
    "error": "File format not supported",
    "code": 415
}

Instructions for use

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

File size limit: It is recommended that a single file should not exceed 10MB

Returned URL: can be used directly to display images, and the link is valid for a long time

Timestamp format: Unix timestamp, unit is milliseconds

Notes

-Uploaded images will be processed through the proxy service to ensure access stability

It is recommended to properly compress images on the client to increase upload speed

The returned image link supports cross-domain access

Please ensure you have an internet connection and appropriate permissions before uploading

Self-built image bed API

Image upload API documentation#

Interface overview#

Interface details#

Request information#

Request parameters#

Request example#

cURL example#

JavaScript Example#

Python example#

Response information#

Successful response#

Response example#

Error response#

Error response example#

Instructions for use#

Notes#