Skip to Content
Getting started

Getting started

Make your first Vinci API call in three steps.

1. Get an API key

  1. Sign in to the Vinci app.
  2. Go to Account → API keys.
  3. Issue a key. It looks like vinci_live_… and is shown once — copy it now. (We only store a hash; if you lose it, rotate to get a new one.)

Keep keys secret. Treat them like a password; never commit them to source control.

2. Make a request

Vinci’s API is OpenAI-compatible, so most OpenAI SDKs and tools work by changing two things: the base URL and the API key.

curl https://vinci.getsimpledirect.com/api/v1/chat/completions \
  -H "Authorization: Bearer $VINCI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vinci-piccolo",
    "messages": [{ "role": "user", "content": "Explain async/await in one sentence." }]
  }'

3. Use it from an SDK

Python (the official openai package):

from openai import OpenAI
 
client = OpenAI(
    base_url="https://vinci.getsimpledirect.com/api/v1",
    api_key="vinci_live_...",  # or os.environ["VINCI_API_KEY"]
)
 
resp = client.chat.completions.create(
    model="vinci-piccolo",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

JavaScript / TypeScript:

import OpenAI from 'openai';
 
const client = new OpenAI({
  baseURL: 'https://vinci.getsimpledirect.com/api/v1',
  apiKey: process.env.VINCI_API_KEY,
});
 
const resp = await client.chat.completions.create({
  model: 'vinci-piccolo',
  messages: [{ role: 'user', content: 'Hello!' }],
});
console.log(resp.choices[0].message.content);

Next

IntroductionOverview