Endpoints overview
Copy Page as Markdown
SubQ exposes OpenAI-compatible endpoints under the https://api.subq.ai/v1 base
URL. Authenticate every request with Authorization: Bearer $SUBQ_API_KEY.
| Method | Path | Use it to |
|---|---|---|
POST | /v1/chat/completions | Generate text from SubQ using Chat Completions messages. |
POST | /v1/responses | Stateful generation with instructions, web search, and server-managed history. |
POST / GET / DELETE | /v1/files | Upload and manage org-scoped files for Chat Completions and Responses. |
GET | /v1/models | List the model IDs available to your API key. |
Start with Chat Completions API for
stateless generation or drop-in OpenAI migrations. Use Responses API
for multi-turn and long-context workflows — system instructions, built-in web search, and
server-side history via previous_response_id. Use the Files API
to upload documents and reference them by file_id in Chat Completions or Responses. Use
Models API when your application needs to discover supported
model IDs at runtime.