Image Convert API

API chuyển đổi định dạng ảnh và xóa nền. Cần API key riêng để thực hiện.

v1https://api.videsk.vn/api

Cập nhật lần cuối: 9 tháng 6, 2026

1. Xác thực

Gọi API lập trình cần API key riêng. Gửi trên mỗi request:

X-Videsk-Access-Token

Send your registered API key as a header on every integration request.

Keep it safe

Never expose your API key in browser-side javascript. Always proxy requests.

http

X-Videsk-Access-Token: <api_key_cua_ban>

Keep your key secret!

Để đăng ký API key, vui lòng liên hệ [email protected].

2. Endpoints

Chuyển JPEG, PNG, WebP, BMP, TIFF, GIF, ICO, SVG, HEIC, AVIF sang jpeg/png/webp/bmp/tiff. Tùy chọn removeBackground=true.

POST/tools/image-convertv1

Chuyển đổi một ảnh

Field	Bắt buộc	Mô tả
`file`*	string	File ảnh nguồn (JPEG, PNG, WebP, BMP, TIFF, GIF, ICO, SVG, HEIC, AVIF)
`targetFormat`*	string	jpeg, png, webp, bmp, hoặc tiff
`quality`	integer	1–100 (mặc định 100)
`removeBackground`	boolean	true / false — xóa nền trước khi convert

Gửi API key đã đăng ký trong X-Videsk-Access-Token. Headers: X-Original-Size, X-Converted-Size.

REQUEST EXAMPLE

bash

curl -X POST https://api.videsk.vn/api/tools/image-convert \
  -H "X-Videsk-Access-Token: <your_api_key>" \
  -F "[email protected]" \
  -F "targetFormat=webp" \
  -F "quality=85" \
  --output output.webp

POST/tools/image-convert/zipv1

Tạo ZIP batch

GET/tools/image-convert/zip/{batchId}v1

Tải ZIP batch

3. Giới hạn & lỗi

Tài nguyên	Giới hạn
`Kích thước file`	string

Lỗi trả JSON { "message": "..." } với HTTP 400/413/422/429/500.

Dùng thử trên web