Public APIAPI
Getting Started
Introduction
The Tsukyio API is a RESTful interface designed for high-performance media asset retrieval and tool automation. All responses are served in JSON format with standard HTTP status codes.
Base URL
https://tsukyio.com/apiAuthentication
Bearer Token tsk_...
User KeyAdmin Key
Rate Limits
User: 120-300 req/min
Admin: 600 req/min
Error Codes
| Code | Meaning |
|---|---|
| 401 | Unauthorized: Missing or invalid API key. |
| 403 | Forbidden: Key lacks required permissions (e.g. User key on Admin route). |
| 429 | Too Many Requests: Rate limit exceeded. |
Pagination
Endpoints that return lists use cursor-based offset pagination. The response includes a pagination object:
"pagination": {
"total": 1250,
"limit": 50,
"offset": 0,
"hasMore": true
}Download Workflow
How to properly handle vault assets in your application.
Step 1
Call /vault/all or search to find the assetId of the resource you need.
Step 2
If not pre-fetched, call /vault/download/sign with the asset ID to get a short-lived URL.
Step 3
Use the URL for streaming (HTML5 video/audio) or direct download. URLs expire after 60 minutes.