Your first chat.
Your first API call.

01 / Try a Real Task

Get an answer before connecting anything.

Create your free account, open chat, choose OHS3, and try a task you actually have. For example:

Write a Python function that removes duplicate lines from a text file while keeping their first order.

The Free plan includes 5 OHS3 replies per day, up to 30 per month, shared between chat and API. See current plans and limits.

02 / Use the API

One key for your chat completion calls.

1. Create an account and open API keys, or open your existing account's keys.
2. Create an Ohshi API key. Copy it when it is shown and keep it private.
3. Replace YOUR_OHSHI_KEY in one of the examples below. Use ohs3 to start without connecting a provider.

Python

Install the openai package, then set OHSHI_API_KEY in your local environment to the key you created.

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://www.ohshi.space/v1",
    api_key=os.environ["OHSHI_API_KEY"],
)

response = client.chat.completions.create(
    model="ohs3",
    messages=[{
        "role": "user",
        "content": "Write a Python function to remove duplicate lines."
    }],
)

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

curl

Run this in a Bash-compatible terminal with your own Ohshi key.

curl https://www.ohshi.space/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OHSHI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"ohs3","messages":[{"role":"user","content":"Say hello in one sentence."}]}'

Keep your API key on your server or local machine. Do not put it in browser code, screenshots, or a public repository.

03 / Add Your AI Access

Bring Gemini or DeepSeek when you need them.

Add your Gemini API key from Google AI Studio or your DeepSeek API key in Connected accounts. Your provider bills that key for usage. Choose a model in chat, or use its exact model ID from your account's API docs.

Your ohs_ key and the API base URL stay the same. Google, ChatGPT, and DeepSeek chat account connections are also offered in Beta; availability and limits depend on the provider. A consumer subscription is not a guaranteed API allowance.

If your first request fails

401 / Invalid key

Use an Ohshi ohs_ key in the Authorization header. Provider keys belong in Connected accounts.

429 / Limit reached

Check your allowance and the retry information in the response. OHS3 has both daily and monthly limits.

503 / Model unavailable

The model host may be busy or unavailable. If the response provides Retry-After, wait that long before retrying.