Vipixel API

Access Vietnamese cultural stock images programmatically

Authentication

External API access requires an API key. Website visitors don't need a key.

Get Your Free API Key

Using Your API Key

Include your API key in requests using one of these methods:

# Authorization header (recommended)
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"

Rate Limits

Tier	Rate Limit	Daily Limit	Price
Free	10 req/min	100 req/day	$0
Pro	60 req/min	5,000 req/day	Contact us
Enterprise	300 req/min	50,000 req/day	Contact us

Rate limit headers are included in all API responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Base URL

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

Endpoints

GET /search

Semantic search for images using AI

Parameters

`q`	Search query (required)
`limit`	Number of results (max 100, default 20)
`category`	Filter: business, lifestyle, education
`style`	Filter: photo, illustration

Example

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

GET /browse

Browse all images with pagination and filters

Parameters

`limit`	Number of results (max 100, default 20)
`offset`	Pagination offset
`category`	Filter by category
`style`	Filter by style
`sort`	Sort by: recent, popular, downloads

Example

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

GET /images/:id

Get details for a specific image

Example

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

Response Format

{
  "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"
}

License

All images are free for personal and commercial use. Attribution appreciated but not required.