Quickstart

from openai import OpenAI

client = OpenAI(
    base_url="https://api.protege.sh/v1",
    api_key=os.environ["PROTEGE_API_KEY"],
)

const client = new OpenAI({
  baseURL: "https://api.protege.sh/v1",
  apiKey: process.env.PROTEGE_API_KEY,
});

curl https://api.protege.sh/v1/chat/completions \
  -H "Authorization: Bearer $PROTEGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "invoice_extraction",
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Extract the total."}]
  }'

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Extract the total."}],
    extra_body={"task": "invoice_extraction"},
)

const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "Extract the total." }],
  // @ts-expect-error - `task` is a Protégé extension
  task: "invoice_extraction",
});