1. Upload Multipart/Form-data (File ảnh hoặc nhạc)
Copy
curl -X POST https://cdn.kimidev.net/api/upload \
-H "X-API-Key: YOUR_API_KEY " \
-F "file=@/path/to/my-file.mp3"
2. Upload từ URL từ xa
Copy
curl -X POST https://cdn.kimidev.net/api/upload/url \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY " \
-d '{"url": "https://picsum.photos/800/600", "customName": "photo.jpg"}'
3. Upload từ Base64
Copy
curl -X POST https://cdn.kimidev.net/api/upload/base64 \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY " \
-d '{"base64": "data:image/png;base64,iVBORw0KGgo...", "filename": "avatar.png"}'
4. Phân phối & Biến đổi ảnh qua URL (CDN)
Ảnh gốc: https://cdn.kimidev.net/i/:filename?key=YOUR_KEY
Thu nhỏ kích thước: https://cdn.kimidev.net/i/:filename?key=YOUR_KEY &w=400&h=300&fit=cover
Nén chất lượng & đổi định dạng: https://cdn.kimidev.net/i/:filename?key=YOUR_KEY &format=webp&q=75
Đen trắng + làm mờ: https://cdn.kimidev.net/i/:filename?key=YOUR_KEY &grayscale=true&blur=5
5. Phân phối & Streaming Nhạc / Audio (MP3, WAV, OGG)
Link trực tiếp / Streaming: https://cdn.kimidev.net/i/:filename?key=YOUR_KEY
Hỗ trợ HTTP Range 206 (tua nhanh, phát trực tuyến tức thì mượt mà trên mọi trình duyệt).
Mã nhúng HTML5: <audio controls src="https://cdn.kimidev.net/i/:filename?key=YOUR_KEY "></audio>
6. Chống Trùng Lặp Thông Minh (SHA-256 Deduplication)
Copy
Mặc định hệ thống tự động kiểm tra mã băm SHA-256 để chống lưu file trùng lặp (trả về "isDuplicate": true và link tệp cũ, không tốn thêm dung lượng). Nếu bạn muốn cho phép tải bản sao mới , gửi thêm tham số allowDuplicate=true:
curl -X POST https://cdn.kimidev.net/api/upload \
-H "X-API-Key: YOUR_API_KEY " \
-F "file=@/path/to/my-file.jpg" \
-F "allowDuplicate=true"