API overview

Copy Page as Markdown

SubQ serves two model families, each on its own endpoints:

  • SubQ Snap (subq-snap-1.2) returns typed decisions about text and images on the Decisions API. Available to every account.
  • SubQ Savant (subq-savant-1.4) Early access generates text over up to 4M tokens of context on Chat Completions and Responses, both OpenAI-compatible. Request access.

The Files, Conversations, and Models endpoints support them. See Models for what each model accepts.

Request flow

  1. Create an account at console.subq.ai
  2. Generate an API key from the console
  3. Set the SubQ base URL in your HTTP client or OpenAI SDK
  4. Choose an endpoint and send a request using a SubQ model.
  5. Enable streaming on Chat Completions or Responses when your product needs tokens as they are generated

Base URL

Send API requests to:

https://api.subq.ai/v1

Append the endpoint path to it: Chat Completions is https://api.subq.ai/v1/chat/completions. In an OpenAI SDK, set baseURL (TypeScript) or base_url (Python) to the base URL and the SDK adds the path.

Treat each endpoint page as the contract for its supported models, fields, and response formats.

Endpoints

EndpointMethodPathModelUse it to
ModelsGET/v1/models—List the model IDs available to your API key at runtime.
DecisionsPOST/v1/systemonesubq-snap-1.2Return typed yes/no, choice, and score decisions about text or images, with probabilities and confidence.
Chat CompletionsPOST/v1/chat/completionssubq-savant-1.4 Early accessGenerate text from messages, statelessly.
ResponsesPOST/v1/responsessubq-savant-1.4 Early accessRun multi-turn and long-context workflows with instructions, built-in web search, and server-side history via previous_response_id.
ConversationsPOST / GET / DELETE/v1/conversationsUsed with subq-savant-1.4Create, inspect, retag, and delete a conversation's history, independent of any single turn.
FilesPOST / GET / DELETE/v1/filesUsed with subq-savant-1.4Upload documents once and reference them by file_id in Chat Completions or Responses.

Next steps