Quickstart

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

Prerequisites

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

1. Create an API key

Sign in at deepshi.ai.
Open the API keys section of your dashboard.
Click Create key, give it a name, and copy the value.

Your key 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." }
    ]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.deepshi.ai/v1",
    api_key="YOUR_DEEPSHI_API_KEY",  # your Deepshi key
)

resp = client.chat.completions.create(
    model="deepshi-3.0",
    messages=[{"role": "user", "content": "Say hello in one sentence."}],
)

print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.deepshi.ai/v1",
  apiKey: process.env.DEEPSHI_API_KEY, // your Deepshi key
});

const resp = await client.chat.completions.create({
  model: "deepshi-3.0",
  messages: [{ role: "user", content: "Say hello in one sentence." }],
});

console.log(resp.choices[0].message.content);

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,
    "cost": { "total_cost": 0.000018 }
  }
}

The usage.cost.total_cost field is the exact USD amount this request deducted from your balance. See Credits & billing.

3. Pick a model

Swap the model field to call any model in the catalog: Deepshi’s own models for highly uncensored responses, or a frontier model from a provider like OpenAI or Anthropic. The catalog covers text, image, video, and music models. 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.

Generate images

Create images from a text prompt.

Handle errors

Understand status codes and retries.

Overview

Get started

Changelog

Prerequisites

1. Create an API key

2. Make your first call

3. Pick a model

Next steps

Stream responses

Call tools

Reasoning

Generate images

Handle errors

​Prerequisites

​1. Create an API key

​2. Make your first call

​3. Pick a model

​Next steps

Stream responses

Call tools

Reasoning

Generate images

Handle errors

Prerequisites

1. Create an API key

2. Make your first call

3. Pick a model

Next steps