Skip to content

OpenAPI description of the image, search, tag, user-image, and favorite endpoints registered by the LONG Hub backend.
Successful JSON responses use the envelope { "error": null, "data": ... }; validation and server errors use { "error": "..." }.
Endpoints returning no data respond with HTTP 204 and an empty body.
Endpoints not listed here are not intended for public use, but you can still invoke them anyway, you just need to experiment yourself.

Servers

http://localhost:8000Local backend (the default listen address)

Authentication

Most read-only operations do not require authorization or authentication. You can directly invoke these endpoints. To use writing or account-related operations, see below.

Two types of authorization are supported, and either of them can be used to authenticate both on web and via API:

Appkey

TIP

Authenticating via appkey should be preferred over sessions.

You need an appkey to authenticate this way. Go to Settings > Appkeys and create one.
Keep your appkey at a secure place, you will not see it after the creation dialog closes.

To authenticate, use the Authorization header with Appkey type:

http
POST https://api.longhub.top/image/sign
Authorization: Key <YOUR_APP_KEY>
...

Session