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.

View API Reference

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

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.