Skip to content

Random Anime Image API

1. Basic Usage

API Call Demo
API Call Demo

Since image files are stored on the server, ensure a stable network connection for the best experience.

Base API URL

txt
https://zeapi.ink/v1/api/sjecy

Retrieve a random anime image via GET request:

txt
https://zeapi.ink/v1/api/sjecy

Shell Request Example

shell
curl https://zeapi.ink/v1/api/sjecy

Retrieve JSON Format Output

Add the format=json parameter to the URL to get image information in JSON format:

txt
https://zeapi.ink/v1/api/sjecy?format=json

Shell Request Example (JSON Format)

shell
curl https://zeapi.ink/v1/api/sjecy?format=json

POST Request Example (JSON Format)

Retrieve image information by sending JSON data via POST request:

shell
curl -X POST -H "Content-Type: application/json" -d '{"format":"json"}' https://zeapi.ink/v1/api/sjecy

2. Request Parameters

ParameterTypeRequiredDefault ValueDescription
formatstringNoimageOutput format, options: json (returns image info) or image (returns raw image data)

3. JSON Response Format

Success Response Example (JSON Format)

json
{
    "status": "success",
    "image": "img_123.jpg",
    "url": "https://zeapi.ink/v1/api/images/img_123.jpg"
}

Success Response Example (image Format)

Returns the raw binary image data with the Content-Type set based on the image extension (e.g., image/jpeg).

Error Response Example (Image Not Found)

json
{ "code": 404, "error": "Image not found: img_123.jpg" }

Error Response Example (Server Error)

json
{ "code": 500, "error": "Server error: [error description]" }

4. Response Fields Description

FieldTypeDescription
codeintResponse status code (200 for success, 404 for image not found, 500 for server error)
statusstringOperation result status (JSON format only, success for successful requests)
errorstringError message (returned only on error)
imagestringImage filename (JSON format only, e.g., img_123.jpg)
urlstringFull URL of the image (JSON format only, e.g., https://zeapi.ink/v1/api/images/img_123.jpg)

Released under the MIT License.