Skip to main content
This guide takes you from a fresh account to your first response from the Deepshi API.

​
Prerequisites

  • A Deepshi account with credits on it.
  • An API key (you’ll create one below).
  • curl, or Python / Node.js if you prefer an SDK.

​
1. Create an API key

  1. Sign in at deepshi.ai.
  2. Open the API keys section of your dashboard.
  3. Click Create key, give it a name, and copy the value.
Your key looks like sk-bf-xxxxxxxx. It is shown only once, so store it somewhere safe. See Authentication for details.
Treat your key like a password. Anyone with it can spend your credits. Never commit it to source control or expose it in client-side code.

​
2. Make your first call

The API is OpenAI-compatible. The base URL is https://api.deepshi.ai/v1 and you authenticate with a bearer token. 
curl https://api.deepshi.ai/v1/chat/completions \
  -H "Authorization: Bearer $DEEPSHI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepshi-3.0",
    "messages": [
      { "role": "user", "content": "Say hello in one sentence." }
    ]
  }'
You’ll get back a standard OpenAI chat completion object: 
{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1748000000,
  "model": "deepshi-3.0",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello there!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 12, "completion_tokens": 4, "total_tokens": 16 }
}

​
3. Pick a model

deepshi-3.0 is Deepshi’s multimodal flagship. Swap the model field to call anything in the catalog. For example, use deepshi-2.0 for the most uncensored responses, or a frontier model like the latest from OpenAI or Anthropic. See Models for the full list, and fetch the live catalog any time: 
curl https://api.deepshi.ai/v1/models \
  -H "Authorization: Bearer $DEEPSHI_API_KEY"

​
Next steps

Stream responses

Render tokens as they’re generated.

Call tools

Let the model call your functions.

Reasoning

Use models that think before they answer.

Handle errors

Understand status codes and retries.