Vipixel API

Truy cập hình ảnh stock văn hóa Việt Nam qua API

Xác thực

Truy cập API từ bên ngoài yêu cầu API key. Người dùng website không cần key.

Nhận API Key miễn phí

AI Agent Skill

Tải skill để AI coding agent (Claude Code, Antigravity, v.v.) tự động tìm kiếm hình ảnh Vipixel.

Cài đặt

Tải và giải nén vào thư mục .claude/skills/ của project
Mở file .claude/skills/vipixel-search/.env
Thay vx_your_api_key_here bằng API key của bạn (lấy ở trên)
Sử dụng: gõ /vipixel hoặc "find image" trong agent

Tải vipixel-search.zip SKILL.md only

# Hoặc cài bằng command line
curl -L https://vipixel.vibery.app/api/skill -o vipixel-search.zip
unzip vipixel-search.zip -d .claude/skills/
# Thêm API key
echo "VIPIXEL_API_KEY=vx_your_key" > .claude/skills/vipixel-search/.env

Sử dụng API Key

Thêm API key vào request bằng một trong các cách sau:

# Authorization header (khuyến nghị)
curl -H "Authorization: Bearer vx_your_api_key" \
  https://vipixel.vibery.app/api/v1/search?q=office

# X-API-Key header
curl -H "X-API-Key: vx_your_api_key" \
  https://vipixel.vibery.app/api/v1/search?q=office

# Query parameter
curl "https://vipixel.vibery.app/api/v1/search?q=office&api_key=vx_your_api_key"

Giới hạn tốc độ

Gói	Giới hạn tốc độ	Giới hạn hàng ngày	Giá
Miễn phí	10 req/phút	100 req/ngày	$0
Pro	60 req/phút	5,000 req/ngày	Liên hệ
Enterprise	300 req/phút	50,000 req/ngày	Liên hệ

Headers giới hạn tốc độ được bao gồm trong tất cả phản hồi API: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

URL cơ sở

https://vipixel.vibery.app/api/v1

Điểm cuối API

GET /search

Tìm kiếm ngữ nghĩa hình ảnh sử dụng AI

Tham số

`q`	Từ khóa tìm kiếm (bắt buộc)
`limit`	Số lượng kết quả (tối đa 100, mặc định 20)
`category`	Lọc: business, lifestyle, education
`style`	Lọc: photo, illustration

Ví dụ

GET /api/v1/search?q=vietnamese+coffee+shop&limit=10

GET /browse

Duyệt tất cả hình ảnh với phân trang và bộ lọc

Tham số

`limit`	Số lượng kết quả (tối đa 100, mặc định 20)
`offset`	Vị trí phân trang
`category`	Lọc theo danh mục
`style`	Lọc theo phong cách
`sort`	Sắp xếp theo: recent, popular, downloads

Ví dụ

GET /api/v1/browse?category=business&style=illustration&limit=20

GET /images/:id

Lấy chi tiết của một hình ảnh cụ thể

Ví dụ

GET /api/v1/images/vx-business-illus-001

Định dạng phản hồi

{
  "results": [
    {
      "id": "vx-business-illus-001",
      "description": "Vietnamese professional in modern office",
      "category": "business",
      "style": "illustration",
      "aspect_ratio": "16:9",
      "image_url": "https://cdn.vipixel.vibery.app/...",
      "score": 0.89,
      "vietnamese_elements": ["ao dai", "lotus"],
      "tags": ["business", "professional"]
    }
  ],
  "total": 269,
  "method": "semantic"
}

Giấy phép

Tất cả hình ảnh miễn phí cho mục đích cá nhân và thương mại. Ghi nhận nguồn được đánh giá cao nhưng không bắt buộc.