Shopno Cloud API

🚀 Quick Start

# Your first API call
curl https://mail.surveymentor.org/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "copilot::claude-haiku-4-5",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'Copy

🔐 Authentication

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

Authorization: Bearer sk-shopno-YOUR_API_KEYCopy

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.

📡 Endpoints

Base URL

https://mail.surveymentor.org/v1Copy

Chat Completions

POST /chat/completions

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

{
  "model": "shopno-cloud-2",
  "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
}Copy

💻 Code Examples

Python (openai library)

from openai import OpenAI

client = OpenAI(
    api_key="sk-shopno-YOUR_KEY_HERE",
    base_url="https://mail.surveymentor.org/v1"
)

response = client.chat.completions.create(
    model="copilot::claude-haiku-4-5",
    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="")Copy

JavaScript (fetch)

const response = await fetch('https://mail.surveymentor.org/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'copilot::claude-haiku-4-5',
    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));
}Copy

cURL

curl -X POST https://mail.surveymentor.org/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"copilot::claude-haiku-4-5","messages":[{"role":"user","content":"Hi"}],"stream":true}'Copy

⏱️ Rate Limits

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

🖥️ Using with Shopno Chat Desktop

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