Wine Sommelier API
Add an AI sommelier
to your app in minutes
Multi-turn conversational API for wine recommendations, food pairings, tasting notes, and cellar advice. Send a message, get expert wine guidance back.
Start a conversation
curl -X POST https://fastcork.com/v1/chat \
-H "Authorization: Bearer fc-your_key" \
-H "Content-Type: application/json" \
-d '{"message":"What red wine pairs best with duck confit?"}'
# Response includes sessionId — use it to continue the conversation
{
"sessionId": "sess_abc123",
"response": { ... }
}
Continue the conversation
curl -X POST https://fastcork.com/v1/chat \
-H "Authorization: Bearer fc-your_key" \
-H "Content-Type: application/json" \
-d '{"message":"What about something under $40?","sessionId":"sess_abc123"}'
What the sommelier covers
- Food and wine pairing recommendations
- Specific bottle and producer recommendations
- Tasting notes and flavor profiles
- Serving temperature and decanting guidance
- Cellar management — when to drink, how to store
- Wine region and appellation education
- Wine list analysis from an uploaded image
Wine list image analysis
Pass an image of a restaurant wine list alongside the user's food order and the API recommends the best pairing from what's actually available — not generic suggestions.
curl -X POST https://fastcork.com/v1/chat \
-H "Authorization: Bearer fc-your_key" \
-H "Content-Type: application/json" \
-d "{
"message": "I am having the duck breast, which wine from this list?",
"sessionId": "sess_abc123",
"images": ["$(base64 -i winelist.jpg)"],
"lang": "en"
}"
Multi-language support
The sommelier detects the user's language and responds in kind — English, Traditional Chinese, Japanese, French, and more. Wine names and producer names always stay in their original romanised form.
Pricing
Each chat message counts as one request at $0.003. Start with $5 prepaid (~1,667 messages). Metered billing activates automatically after the credit is used.