Voice Quickstart

export INCEPTION_API_KEY="your_api_key_here"

$env:INCEPTION_API_KEY = "your_api_key_here"

pip install inceptionai

npm install inceptionai

curl https://api.inceptionlabs.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $INCEPTION_API_KEY" \
  -d '{
    "model": "mercury-2.5",
    "messages": [
      {"role": "system", "content": "You are speaking in a voice interface. Follow these rules strictly:\n1. NEVER use markdown, asterisks, bold, bullet points, numbered lists, or headers.\n2. Keep every response as short as possible.\n3. If a tool requires missing information, ask for ONE thing at a time."},
      {"role": "user", "content": "Hey, what'\''s up?"}
    ],
    "reasoning_effort": "medium",
    "temperature": 0.75,
    "max_completion_tokens": 8192,
    "realtime": true
  }'

from inceptionai import Inception

client = Inception()  # reads INCEPTION_API_KEY from the environment

SYSTEM_PROMPT = (
    "You are speaking in a voice interface. Follow these rules strictly:\n"
    "1. NEVER use markdown, asterisks, bold, bullet points, numbered lists, or headers.\n"
    "2. Keep every response as short as possible.\n"
    "3. If a tool requires missing information, ask for ONE thing at a time."
)

completion = client.chat.completions.create(
    model="mercury-2.5",
    messages=[
        {"role": "system", "content": SYSTEM_PROMPT},
        {"role": "user", "content": "Hey, what's up?"},
    ],
    reasoning_effort="medium",
    temperature=0.75,
    max_completion_tokens=8192,
    realtime=True,
)
print(completion.choices[0].message.content)

import Inception from 'inceptionai';

const client = new Inception(); // reads INCEPTION_API_KEY from the environment

const SYSTEM_PROMPT = [
  'You are speaking in a voice interface. Follow these rules strictly:',
  '1. NEVER use markdown, asterisks, bold, bullet points, numbered lists, or headers.',
  '2. Keep every response as short as possible.',
  '3. If a tool requires missing information, ask for ONE thing at a time.',
].join('\n');

const completion = await client.chat.completions.create({
  model: 'mercury-2.5',
  messages: [
    { role: 'system', content: SYSTEM_PROMPT },
    { role: 'user', content: "Hey, what's up?" },
  ],
  reasoning_effort: 'medium',
  temperature: 0.75,
  max_completion_tokens: 8192,
  realtime: true,
});
console.log(completion.choices[0]?.message.content);