Documentation

Build with Simpledot.

One API for every AI model. Send a single request, get the best answer — here's everything you need to get started.

Introduction

Simpledot gives you one API for every leading AI model. Send a single request and Simpledot queries multiple models in parallel, runs the responses through our judge system, and returns only the best answer — no model picking required.

Quickstart

Install the SDK with your package manager of choice:

npm install @simpledot/sdk
# or
pnpm add @simpledot/sdk

Authentication

Create an API key from your dashboard and pass it when you initialize the client. Keep your key secret — never expose it in client-side code.

import { Simpledot } from '@simpledot/sdk'

const simpledot = new Simpledot({
  apiKey: process.env.SIMPLEDOT_KEY
})

Asking a question

Use ask() to send a request. Simpledot returns the best answer along with which model produced it.

const answer = await simpledot.ask({
  prompt: 'Explain this stack trace',
  task: 'code',
  models: 'all'
})

console.log(answer.text)
console.log('Best from:', answer.model)

Task types

Set the task field to route your request appropriately. Supported values:

  • textGeneral questions and conversation
  • codeWriting, explaining, and debugging code
  • imageImage generation from a prompt
  • researchLong-form research and summarization
  • writingDrafting and editing content

The judge system

After every model responds, Simpledot scores the responses for correctness, relevance, and clarity, then returns the highest scoring answer. You can inspect the full breakdown if you want transparency into the decision.

const answer = await simpledot.ask({
  prompt: 'Summarize this contract',
  task: 'research',
  explain: true
})

console.log(answer.scores)
// { claude: 98.2, gpt: 95.1, gemini: 93.7 }

SDK reference

The full SDK reference — including streaming, image responses, and error handling — is coming soon. In the meantime, reach out to our team for early access details.