Skip to main content
The Deepshi API is an OpenAI-compatible REST API. The text launch exposes two endpoints; 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 sk-bf-...
See Authentication.

Endpoints

Method & pathDescription
GET /v1/modelsList the models your key can use
POST /v1/chat/completionsGenerate 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; add "stream_options": {"include_usage": true} for a final usage chunk. 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.
The Endpoints pages are generated from the Deepshi OpenAPI specification. Each page lets you inspect the full request and response schema and send a test request from the browser.