API reference

Endpoints, request shapes, and conventions for the Deepshi API.

The Deepshi API is an OpenAI-compatible REST API. The Endpoints section in the sidebar has full per-endpoint reference pages with request/response schemas and an interactive playground.

Base URL

https://api.deepshi.ai/v1

Authentication

All requests require a bearer token:

Authorization: Bearer YOUR_DEEPSHI_API_KEY

See Authentication.

Endpoints

Method & path	Description
GET /v1/models	List the available models
POST /v1/chat/completions	Generate a chat completion (streaming, tools, JSON, reasoning)

Conventions

• Format: JSON request and response bodies, matching the OpenAI schema.
• Streaming: Set "stream": true for Server-Sent Events. The final chunk carries a usage object with cost. See Streaming.
• Usage & cost: Every successful response includes a usage object. Deepshi adds usage.cost.total_cost, the USD cost of the request, drawn from your balance.
• Errors: Standard HTTP status codes with a JSON error object. See Errors.