Chevereto v1 Compatible API

API Documentation

เชื่อมต่อระบบอัปโหลดรูปภาพอัตโนมัติด้วย RESTful API รองรับการส่งไฟล์ตรง, การสร้างและจัดรูปภาพเข้าสู่โฟลเดอร์/อัลบั้มอัตโนมัติ

คุณยังไม่ได้เข้าสู่ระบบ

เข้าสู่ระบบเพื่อรับ Personal API Key สำหรับบันทึกภาพลงในคลังและโฟลเดอร์ส่วนตัวของคุณ

เข้าสู่ระบบทันที

POST https://img.jvflix.cc/api/1/upload

Content-Type: multipart/form-data

พารามิเตอร์ที่รองรับ (Request Parameters)

Parameter	Type	Required	Description (คำอธิบายการทำงาน)
key	string	Optional	API Key ประจำตัวสมาชิก (หากไม่ระบุจะถูกจัดเก็บเป็นภาพ Guest ไม่ระบุตัวตน)
source	file	Required*	ไฟล์รูปภาพแบบ Binary / Multipart (*ต้องระบุอย่างใดอย่างหนึ่งระหว่าง `source` หรือ `source_url`)
source_url	string	Required*	ลิงก์ URL ของรูปภาพภายนอกเพื่อให้เซิร์ฟเวอร์ดูดมา หรือ Base64 Data String
album_name	string	Optional	📁 ชื่อโฟลเดอร์ / อัลบั้มปลายทาง (Auto-Create): • ระบุชื่อโฟลเดอร์ที่ต้องการนำรูปเข้าไปเก็บ • ถ้ามีโฟลเดอร์ชื่อนี้อยู่แล้ว: รูปจะถูกนำไปรวมในโฟลเดอร์เดิมทันที • ถ้ายังไม่มีโฟลเดอร์ชื่อนี้: ระบบจะ สร้างโฟลเดอร์ใหม่อัตโนมัติ แล้วย้ายรูปใส่ให้ทันที
album_id	integer	Optional	📁 รหัส ID ของโฟลเดอร์ / อัลบั้ม: ใช้ในกรณีที่ต้องการระบุรหัสตัวเลข ID ของโฟลเดอร์ตรง ๆ ที่สร้างไว้อยู่แล้ว (เช่น `1`)
format	string	Optional	รูปแบบข้อมูลตอบกลับ: `json` (default), `txt` (ตอบกลับเฉพาะ URL ตรง), `redirect`

โครงสร้างข้อมูลตอบกลับ (JSON Response)

{
  "status_code": 200,
  "success": {
    "message": "image uploaded",
    "code": 200
  },
  "image": {
    "name": "r27P3rf8",
    "extension": "webp",
    "filename": "photo.webp",
    "size": 112742,
    "date": "2026-08-30 11:41:20",
    "url": "https://cdn.jvflix.cc/stream/261670?hash=db242c",
    "url_viewer": "https://img.jvflix.cc/image/r27P3rf8",
    "display_url": "https://cdn.jvflix.cc/stream/261670?hash=db242c",
    "album_id": 1,
    "html_embed": "<a href=\"https://img.jvflix.cc/image/r27P3rf8\"><img src=\"https://cdn.jvflix.cc/stream/261670?hash=db242c\" alt=\"photo.webp\" /></a>",
    "bbcode_embed": "[url=https://img.jvflix.cc/image/r27P3rf8][img]https://cdn.jvflix.cc/stream/261670?hash=db242c[/img][/url]",
    "markdown_embed": "[![photo.webp](https://cdn.jvflix.cc/stream/261670?hash=db242c)](https://img.jvflix.cc/image/r27P3rf8)"
  },
  "status_txt": "OK"
}

ตัวอย่างการเรียกใช้งานพร้อมระบุโฟลเดอร์ (Code Examples)

อัปโหลดไฟล์จากเครื่อง พร้อมระบุให้สร้าง/เก็บเข้าโฟลเดอร์ชื่อ My_Folder:

# 1. ส่งรูปเข้าโฟลเดอร์ (ถ้ายังไม่มีโฟลเดอร์ ระบบจะสร้างให้อัตโนมัติ)
curl -X POST https://img.jvflix.cc/api/1/upload \
  -F "key=YOUR_API_KEY" \
  -F "album_name=My_Folder" \
  -F "source=@/path/to/image.jpg"

# 2. ส่งรูปเข้าโฟลเดอร์โดยอ้างอิงจาก ID
curl -X POST https://img.jvflix.cc/api/1/upload \
  -F "key=YOUR_API_KEY" \
  -F "album_id=1" \
  -F "source=@/path/to/image.jpg"

import requests

url = "https://img.jvflix.cc/api/1/upload"
payload = {
    "key": "YOUR_API_KEY",
    "album_name": "My_Folder", # ระบุชื่อโฟลเดอร์ (สร้างให้อัตโนมัติถ้ายังไม่มี)
    "format": "json"
}

files = [
    ("source", ("photo.jpg", open("photo.jpg", "rb"), "image/jpeg"))
]

response = requests.post(url, data=payload, files=files)
result = response.json()

print("Direct CDN URL:", result["image"]["url"])
print("Folder ID:", result["image"]["album_id"])

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

async function upload() {
  const form = new FormData();
  form.append('key', 'YOUR_API_KEY');
  form.append('album_name', 'My_Folder'); // ระบุชื่อโฟลเดอร์
  form.append('source', fs.createReadStream('./photo.jpg'));

  const response = await axios.post('https://img.jvflix.cc/api/1/upload', form, {
    headers: form.getHeaders(),
  });

  console.log('CDN URL:', response.data.image.url);
  console.log('Folder ID:', response.data.image.album_id);
}

upload();

<?php
$ch = curl_init();
$cfile = new CURLFile('photo.jpg', 'image/jpeg', 'photo.jpg');

$data = array(
    'key' => 'YOUR_API_KEY',
    'album_name' => 'My_Folder', // ระบุชื่อโฟลเดอร์
    'source' => $cfile
);

curl_setopt($ch, CURLOPT_URL, 'https://img.jvflix.cc/api/1/upload');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo "CDN URL: " . $result['image']['url'];
?>

บันทึกโค้ดนี้เป็นไฟล์ tg-gallery.sxcu แล้วดับเบิ้ลคลิกเพื่อติดตั้งลงโปรแกรม ShareX:

{
  "Version": "15.0.0",
  "Name": "TG-Gallery",
  "DestinationType": "ImageUploader",
  "RequestMethod": "POST",
  "RequestURL": "https://img.jvflix.cc/api/1/upload",
  "Body": "MultipartFormData",
  "Arguments": {
    "key": "YOUR_API_KEY",
    "album_name": "ShareX_Captures",
    "format": "json"
  },
  "FileFormName": "source",
  "URL": "$json:image.url$",
  "ThumbnailURL": "$json:image.display_url$"
}