DEVELOPER DOCSVinKet AI API
Integrate vintage fashion AI into your app. From a single photo: brand, era, condition, market price, multilingual descriptions, and virtual try-on.
Quick start
Get your API key from the dashboard, then make your first call:
cURL
curl -X POST https://www.vinket.eu/api/v1/analyze \
-H "Authorization: Bearer vk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"image_url": "https://example.com/jacket.jpg"}'Node.js
const res = await fetch('https://www.vinket.eu/api/v1/analyze', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + apiKey,
'Content-Type': 'application/json',
},
body: JSON.stringify({ image_url: imageUrl }),
})
const { brand, era, category, condition, suggested_price } = await res.json()Python
import requests
r = requests.post('https://www.vinket.eu/api/v1/analyze',
headers={'Authorization': f'Bearer {api_key}'},
json={'image_url': image_url})
data = r.json()
print(f"{data['brand']} — {data['era']} — EUR {data['suggested_price']}")Endpoints
POST/api/v1/analyzeFull item analysis from photo
POST/api/ai/pipelineRun full 12-block AI pipeline
POST/api/ai/translate-listingTranslate to 21 EU languages
POST/api/ai/background-removeBackground removal (cascade)
GET/api/ai/eco-scoreCO2 and water savings estimate
GET/api/searchFull-text search with filters
GET/api/v1/itemsList items (Enterprise)
POST/api/v1/batch/uploadBatch CSV analysis
Response format
POST /api/v1/analyze — response
{
"brand": "Levi's",
"era": "1990s",
"category": "denim",
"condition": "good",
"size_estimate": "L",
"color": "indigo blue",
"suggested_price_eur": 45,
"price_range": { "low": 30, "high": 65 },
"rarity": "common",
"titles": {
"it": "Levi's Giacca Denim Anni 90",
"en": "Levi's Denim Jacket 1990s"
},
"descriptions": {
"it": "Autentica giacca Levi's in denim...",
"en": "Authentic Levi's denim jacket..."
},
"counterfeit_score": 12,
"eco_score": 78,
"co2_saved_kg": 20.0,
"seo_keywords": ["vintage levis", "90s denim", ...],
"hashtags": ["#vintagelevis", "#90sdenim", ...]
}Rate limits
Plan
Requests/min
Monthly calls
AI Starter (Free)
30
100
AI Studio (EUR 99)
120
10,000
AI Enterprise
500
Unlimited