OpenAI-Compatible API

Shopno Cloud API

Access world-class AI models through a single OpenAI-compatible endpoint. Use your own API key with any client that supports the OpenAI API format.

🚀 Quick Start

Create an Account

Register at shopno.freedev.app/register.php and log in to your dashboard.

Generate an API Key

Go to the 🔑 API Keys section in your Dashboard and click "Generate New Key". Your key will look like: sk-shopno-a1b2c3d4...

Make Your First Request

Use the key in the Authorization header with any OpenAI-compatible client.

# Your first API call
curl http://www.surveymentor.org/v1/chat/completions \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "Shopno Cloud 1",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

🔐 Authentication

All API requests require a valid API key sent via the Authorization header:

Authorization: Bearer sk-shopno-YOUR_API_KEY
⚠️ Keep your API key secret! Do not share it publicly or commit it to version control. If compromised, revoke it immediately from your dashboard and generate a new one.

Key Format

Shopno API keys always start with sk-shopno- followed by 48 hexadecimal characters. Example:

sk-shopno-a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6

🤖 Available Models

Shopno Cloud routes your requests to the best available provider for each model. All models are accessed through the same endpoint.

Model ID Model Name Tier Required
Shopno Cloud 1 openai-fast FREE
Shopno Cloud 2 llama3 FREE
Shopno Cloud 3 mistral FREE
Shopno Cloud 4 phi3 FREE
Shopno Cloud 5 gemma FREE
Shopno Cloud 6 gemini-2.5-flash ULTRA
Shopno Cloud 11 gemma-4-31b-it ULTRA
Shopno Cloud 12 llama-3.3-70b-versatile ULTRA
Shopno Cloud 13 meta-llama/llama-3.3-70b-instruct:free FREE
Shopno Cloud 14 deepseek/deepseek-chat ULTRA
Shopno Cloud 18 claude-haiku-4-5 ULTRA
Shopno Cloud 30 stepfun-ai/step-3.7-flash PRO
Shopno Cloud 31 stepfun-ai/step-3.5-flash PRO
Shopno Cloud 32 nvidia/nemotron-3-super-120b-a12b PRO
Shopno Cloud 33 openai/gpt-oss-120b PRO
Shopno Cloud 34 deepseek-ai/deepseek-v4-flash PRO
Shopno Cloud 35 qwen/qwen3.5-397b-a17b PRO
Shopno Cloud 36 nvidia/nemotron-3-nano-30b-a3b PRO
Shopno Cloud 37 nvidia/nemotron-3-nano-omni-30b-a3b-reasoning PRO
Shopno Cloud 38 moonshotai/kimi-k2.6 PRO
Shopno Cloud 39 google/gemma-4-31b-it PRO
Shopno Cloud 40 qwen/qwen3-coder-480b-a35b-instruct PRO
Shopno Cloud 41 meta/llama-3.1-70b-instruct PRO
Shopno Cloud 42 mistralai/mistral-large-3-675b-instruct-2512 PRO
Shopno Cloud 44 mistralai/mistral-medium-3.5-128b PRO
Shopno Cloud 45 nvidia/llama-3.3-nemotron-super-49b-v1.5 PRO
Shopno Cloud 46 meta/llama-3.2-90b-vision-instruct PRO
Shopno Cloud 47 mistralai/mistral-nemotron PRO
Shopno Cloud 48 nvidia/nemotron-nano-12b-v2-vl PRO
Shopno Cloud 51 meta/llama-3.2-11b-vision-instruct PRO
Shopno Cloud 52 bytedance/seed-oss-36b-instruct PRO
Shopno Cloud 53 abacusai/dracarys-llama-3.1-70b-instruct PRO
Shopno Cloud 56 microsoft/phi-4-mini-instruct PRO
Shopno Cloud 58 meta/llama-3.2-1b-instruct PRO
Shopno Cloud 60 microsoft/phi-4-multimodal-instruct PRO
Shopno Cloud 65 meta/llama-guard-4-12b PRO
Shopno Cloud 67 z-ai/glm-5.1 PRO
Shopno Cloud 68 minimaxai/minimax-m2.7 PRO
Shopno Cloud 885 llama-3.1-8b-instant ULTRA
Shopno Cloud 896 gemini-2.0-flash ULTRA
Shopno Cloud 1785 aisingapore/sea-lion-7b-instruct ULTRA
Shopno Cloud 1790 deepseek-ai/deepseek-v4-pro ULTRA
Shopno Cloud 1797 google/gemma-3-12b-it ULTRA
Shopno Cloud 1809 meta/llama-3.3-70b-instruct ULTRA
Shopno Cloud 1810 meta/llama-4-maverick-17b-128e-instruct ULTRA
Shopno Cloud 1811 meta/llama2-70b ULTRA
Shopno Cloud 1815 minimaxai/minimax-m3 ULTRA
Shopno Cloud 1817 mistralai/ministral-14b-instruct-2512 ULTRA
Shopno Cloud 1818 mistralai/mistral-7b-instruct-v0.3 ULTRA
Shopno Cloud 1823 mistralai/mixtral-8x7b-instruct-v0.1 ULTRA
Shopno Cloud 1824 nv-mistralai/mistral-nemo-12b-instruct ULTRA
Shopno Cloud 1825 nvidia/ai-synthetic-video-detector ULTRA
Shopno Cloud 1826 nvidia/cosmos-reason2-8b ULTRA
Shopno Cloud 1827 nvidia/llama-3.1-nemotron-51b-instruct ULTRA
Shopno Cloud 1828 nvidia/llama-3.1-nemotron-70b-instruct ULTRA
Shopno Cloud 1829 nvidia/llama-3.1-nemotron-nano-8b-v1 FREE
Shopno Cloud 1830 nvidia/llama-3.1-nemotron-nano-vl-8b-v1 FREE
Shopno Cloud 1831 nvidia/llama-3.1-nemotron-ultra-253b-v1 FREE
Shopno Cloud 1832 nvidia/llama-3.3-nemotron-super-49b-v1 FREE
Shopno Cloud 1834 nvidia/mistral-nemo-minitron-8b-8k-instruct FREE
Shopno Cloud 1836 nvidia/nemotron-3-ultra-550b-a55b FREE
Shopno Cloud 1837 nvidia/nemotron-4-340b-instruct FREE
Shopno Cloud 1839 nvidia/nemotron-nano-3-30b-a3b FREE
Shopno Cloud 1843 nvidia/nvidia-nemotron-nano-9b-v2 FREE
Shopno Cloud 1847 openai/gpt-oss-20b FREE
Shopno Cloud 1848 qwen/qwen3-next-80b-a3b-instruct FREE
Shopno Cloud 1849 qwen/qwen3.5-122b-a10b FREE
Shopno Cloud 1854 z-ai/glm-5.2 FREE
Shopno Cloud 1855 zyphra/zamba2-7b-instruct FREE
Shopno Cloud 2712 openai/gpt-oss-120b ULTRA
Shopno Cloud 9320 claude-fable-5 ULTRA
Shopno Cloud 9321 claude-opus-4-8 ULTRA
Shopno Cloud 9322 claude-opus-4-7 ULTRA
Shopno Cloud 9323 claude-opus-4-6 ULTRA
Shopno Cloud 9324 claude-sonnet-5 ULTRA
Shopno Cloud 9325 claude-sonnet-4-6 ULTRA
Shopno Cloud 9326 claude-haiku-4-5-20251001 ULTRA
Shopno Cloud 9327 gpt-5.5-pro ULTRA
Shopno Cloud 9328 gpt-5.5-pro-extended ULTRA
Shopno Cloud 9329 gpt-5.5-thinking ULTRA
Shopno Cloud 9330 gpt-5.5 ULTRA
Shopno Cloud 9331 gpt-5.4-pro ULTRA
Shopno Cloud 9332 gpt-5.4-thinking ULTRA
Shopno Cloud 9333 gpt-5.3 ULTRA
Shopno Cloud 9334 o3 ULTRA
Shopno Cloud 9335 fast ULTRA
Shopno Cloud 9336 expert ULTRA
Shopno Cloud 9337 heavy ULTRA
Shopno Cloud 9338 grok-420-computer-use-sa ULTRA
Shopno Cloud 9339 gpt-4o FREE
Shopno Cloud 9340 claude-3.5-sonnet FREE
Shopno Cloud 9341 claude-3-opus FREE
Shopno Cloud 9342 gemini-2.0-flash FREE
Shopno Cloud 9343 llama-3-70b FREE
Shopno Cloud 9344 poe-default FREE
Shopno Cloud 9345 kimi-k2.7-code ULTRA
Shopno Cloud 9346 kimi-k2.6 ULTRA
Shopno Cloud 9347 kimi-k2.5 ULTRA
Shopno Cloud 9348 doubao-seed-2-0-pro-260215 ULTRA
Shopno Cloud 9349 doubao-seed-2-0-lite-260215 ULTRA
Shopno Cloud 9350 doubao-seed-2-0-code-preview-260215 ULTRA
Shopno Cloud 9351 doubao-pro-32k ULTRA
Shopno Cloud 9352 qwen3-coder-plus FREE
Shopno Cloud 9353 qwen3-coder-flash FREE
Shopno Cloud 9354 vision-model FREE
Shopno Cloud 9355 coder-model FREE
💡 Tip: You can also use the format shopno-cloud-{profile_id} to target a specific model profile by its database ID.

📡 Endpoints

Base URL

http://www.surveymentor.org/v1

Chat Completions

POST /chat/completions

Creates a model response for a given chat conversation. Supports streaming via SSE.

{
  "model": "Shopno Cloud 1",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Explain quantum computing in simple terms."}
  ],
  "stream": true,
  "temperature": 0.7,
  "max_tokens": 2048
}

💻 Code Examples

Python (openai library)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="http://www.surveymentor.org/v1"
)

response = client.chat.completions.create(
    model="Shopno Cloud 1",
    messages=[
        {"role": "user", "content": "Write a Python function to reverse a string"}
    ],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

JavaScript (fetch)

const response = await fetch('http://www.surveymentor.org/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'Shopno Cloud 1',
    messages: [{ role: 'user', content: 'Hello!' }],
    stream: true
  })
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  console.log(decoder.decode(value));
}

cURL

curl -X POST http://www.surveymentor.org/v1/chat/completions \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "Shopno Cloud 1",
    "messages": [{"role": "user", "content": "Hi!"}],
    "stream": true
  }'

⏱️ Rate Limits

API usage is limited per day based on your subscription plan:

Plan Daily Requests Max API Keys Price
FREE 50 / day 5 $0
PRO 450 / day 5 $5/mo
ULTRA 1,400 / day 5 $19/mo
📊 Daily Reset: Usage counters reset automatically at midnight (server time). If you hit your limit, you can upgrade your plan or wait for the next day.

🖥️ Using with Shopno Chat Desktop

Shopno Chat natively supports Shopno Cloud. To use your API key:

Open Settings

Go to Settings → Providers → Shopno Cloud

Enter Your API Key

Paste your sk-shopno-... key in the API Key field.

Start Chatting

Select any Shopno Cloud model from the model dropdown and start a conversation!