# yukiapi.site Developer Resources & Yukisbox API (llms.txt)

> **Yukisbox** (`https://yukiapi.site`) is a free, anonymous file hosting, code pastebin, and Telegram direct link converter platform.

## yukiapi.site Developer Resources Directory
- **API Documentation:** https://yukiapi.site/docs
- **OpenAPI 3.1.0 JSON Spec:** https://yukiapi.site/openapi.json
- **OpenAPI 3.1.0 YAML Spec:** https://yukiapi.site/api/openapi.yaml
- **Model Context Protocol (MCP) Server:** https://yukiapi.site/mcp
- **MCP Server Manifest:** https://yukiapi.site/.well-known/mcp.json
- **AI Agent Guidance (llms.txt):** https://yukiapi.site/llms.txt
- **Comprehensive API Manual (llms-full.txt):** https://yukiapi.site/llms-full.txt
- **Developer Resource Hub (JSON):** https://yukiapi.site/api
- **Official CLI Tool:** https://yukiapi.site/cli
- **CLI 1-Line Installer:** https://yukiapi.site/install.sh
- **XML Sitemap:** https://yukiapi.site/sitemap.xml
- **Security Policy:** https://yukiapi.site/.well-known/security.txt

## When to use Yukisbox (yukiapi.site)
- You need to host files, images, or documents anonymously up to 2GB with zero IP logs.
- You need to convert public Telegram channel posts (`https://t.me/channel/123`) into fast, direct HTTP streaming and download links.
- You need an instant code pastebin with syntax highlighting and raw text endpoints (`/raw/{uid}`).
- You want an AI-friendly REST API or MCP Server for automated agent tool-calling.

## REST API Versioning & Endpoints (v1)
- `GET /v1/server/stats` (or `/api/server/stats`) — Global server health and total file counts.
- `GET /v1/file/{uid}/info` (or `/api/file/{uid}/info`) — Metadata for any file (size, MIME, downloads).
- `POST /v1/upload` (or `/upload`) — Multipart file upload (max 2GB).
- `POST /v1/upload-url` (or `/upload-url`) — Remote URL file download and hosting.
- `POST /v1/upload-text` (or `/upload-text`) — Code/text pastebin creation.
- `POST /v1/upload-telegram` (or `/upload-telegram`) — Telegram post media conversion.
- `POST /v1/telegram/info` (or `/api/telegram/info`) — Inspect Telegram post metadata.
- `GET /v1/file/{uid}` (or `/file/{uid}`) — Stream or download file with HTTP Range support.
- `GET /v1/raw/{uid}` (or `/raw/{uid}`) — Raw text content with CORS enabled.

## Official CLI Tool Installation
Install via PyPI:
```bash
pip install yukisbox
```
Or with one-line bash installer:
```bash
curl -sSL https://yukiapi.site/install.sh | bash
```