مدلها و قیمتها
هر 1M توکنهر شناسه مدل در API، آنچه میپذیرد و هزینهاش: 10 مدل Shannon و 12 مدل open-weight میزبانیشده، که هرکدام روی هر سه endpoint در دسترساند. GET /v1/models همین فهرست را بهصورت JSON برمیگرداند.
- مدل بدون سانسور
- 22
- پنجره زمینه
- 256K
- از
- $0.50 /1M
مدلهای open-weight میزبانیشده
زمینه 262,144 توکنی روی هر شناسه؛ ورودی و خروجی جداگانه صورتحساب میشوند؛ هر شناسه همان چیزی را میپذیرد که مدلِ مورد تقلیدش میپذیرد
| مدل | ورودی | خروجی ساختاریافته | ورودی / کش / خروجی هر 1M | بیشتر |
|---|---|---|---|---|
3BIT-REAPDeepSeek · 1.6T MoE · 49B activeبدون سانسور | ورودی متن | JSON schema | $1.95 / $0.488 / $3.90 | بیشتر |
3BIT-REAPZ.ai · 744B MoE · 40B activeبدون سانسور | ورودی متن | JSON schema | $0.73 / $0.183 / $2.34 | بیشتر |
3BIT-REAPMoonshot AI · 2.8T MoE · 104B activeبدون سانسور | ورودی متن + تصویر | JSON schema | $3.83 / $0.958 / $19.12 | بیشتر |
3BIT-REAPNVIDIA · 550B hybrid Mamba-Attention MoE · 55B activeبدون سانسور | ورودی متن | JSON schema | $0.75 / $0.188 / $3.30 | بیشتر |
3BIT-REAPMiniMax · 428B MoE · 23B active · sparse attentionبدون سانسور | ورودی متن + تصویر | JSON schema | $0.50 / $0.125 / $2.00 | بیشتر |
W4A16-AUTOROUND-REAPDeepSeek · 284B MoE · 13B activeبدون سانسور | ورودی متن | JSON schema | $0.50 / $0.125 / $2.00 | بیشتر |
W4A16-AUTOROUND-REAPMoonshot AI · 1T MoE · 32B activeبدون سانسور | ورودی متن + تصویر | JSON schema | $0.78 / $0.195 / $3.67 | بیشتر |
W4A16-AUTOROUND-REAPPoolside · 118B MoE · 8B activeبدون سانسور | ورودی متن | بدون خروجی ساختاریافته | $0.50 / $0.125 / $2.00 | بیشتر |
W4A16-AUTOROUND-REAPThinking Machines · 975B MoE · 41B activeبدون سانسور | ورودی متن + تصویر | شیء JSON | $1.42 / $0.355 / $6.07 | بیشتر |
W8A16Xiaomi · 1.02T MoE · 42B active · 8-bitبدون سانسور | ورودی متن | JSON schema | $0.50 / $0.125 / $2.00 | بیشتر |
W8A16Xiaomi · 8-bit multimodal · W8A16بدون سانسور | ورودی متن + تصویر | JSON schema | $0.50 / $0.125 / $2.00 | بیشتر |
W8A16Tencent · 295B MoE · 21B active · 8-bitبدون سانسور | ورودی متن | JSON schema | $0.50 / $0.125 / $2.00 | بیشتر |
مدلهای Shannon
یک نرخ ثابت برای ورودی و خروجی
| مدل | زمینه | ورودی | خروجی ساختاریافته | قیمت / 1M توکن |
|---|---|---|---|---|
shannon-1.6-liteبدون سانسور | 192K | ورودی متن + تصویر | JSON schema | $3.90 |
shannon-1.6-proبدون سانسور | 192K | ورودی متن + تصویر | JSON schema | $7.80 |
shannon-2-liteبدون سانسور | 192K | ورودی متن + تصویر | JSON schema | $3.90 |
shannon-2-proبدون سانسور | 192K | ورودی متن + تصویر | JSON schema | $5.85 |
shannon-3بدون سانسور | 192K | ورودی متن + تصویر | JSON schema | $3.35 |
shannon-3-proبدون سانسور | 192K | ورودی متن + تصویر | JSON schema | $3.35 |
shannon-3.1بدون سانسور | 192K | ورودی متن + تصویر | JSON schema | $3.35 |
shannon-3.1-proبدون سانسور | 192K | ورودی متن + تصویر | JSON schema | $3.35 |
shannon-3.5بدون سانسور | 192K | ورودی متن + تصویر | JSON schema | $3.35 |
shannon-coder-1بدون سانسور | 128K | ورودی متن | JSON schema | $8.00 |
رفتن به شروع سریع آزمایش Playground
یک ردیف را چگونه بخوانیم
| ستون | چه میگوید |
|---|---|
| مدل | نام نمایشی. خط زیر آن شناسهای است که بهعنوان model میفرستید. در جدول مدلهای میزبانیشده، شناسه نام و برچسب کنار آن است که با خط تیره به هم وصل شدهاند: MiniMax-M3 و 3BIT-REAP شناسه MiniMax-M3-3BIT-REAP را میسازند. خط زیر نام نشان میدهد چه کسی مدل را ساخته و اندازه آن چقدر است. |
| زمینه | پنجره زمینه: مدل چند توکن از گفتگو را میخواند. K یعنی 1,024 توکن. عدد دقیق context_window در GET /v1/models است. |
| ورودی | فقط متن، یا متن و تصویر. مدلی که تصویر میخواند capabilities.vision: true گزارش میکند. shannon-2-lite و shannon-2-pro تصاویر را در درخواستهایی که tools یا response_format هم میفرستند میخوانند. |
| خروجی ساختاریافته | آنچه response_format میتواند از مدل بخواهد: پاسخی که از JSON schema شما پیروی کند، پاسخی که یک شیء JSON باشد، یا هیچکدام. |
| قیمت | USD برای هر 1,000,000 توکن. مدل Shannon یک قیمت برای ورودی و خروجی دارد. مدل open-weight میزبانیشده سه قیمت دارد: ورودی، ورودی کششده و خروجی. |
هر مدل streaming دارد و میتواند ابزار فراخوانی کند. قابلیتهای دیگر API در صفحه «قابلیتها» توضیح داده شدهاند. قابلیتها
پنجره زمینه و حدود خروجی
- پنجره زمینه همه چیزهایی را که مدل برای یک پاسخ میخواند در بر میگیرد: پیامها، تعریف ابزارها و تصاویر شما.
- خانواده Shannon 3 گفتگوی بلندتر را خودش جا میدهد: جدیدترین نوبتهایی را که در پنجره جا شوند نگه میدارد و پاسخ میدهد.
- در یک stream، پرامپتی که بیش از حد بلند باشد بهصورت یک فریم خطا با نوع
invalid_request_errorوcode: "context_length_exceeded"گزارش میشود. max_tokensروی هر مدل مقادیر 1 تا 65,536 را میپذیرد؛max_output_tokensدرGET /v1/modelsسقف همین بازه است. مقدار پیشفرض 4,096 است.- روی هر مدل،
max_tokensمقداری است که یک درخواست از موجودی شما رزرو میکند. - بهعنوان حد طول پاسخ،
max_tokensرا مدلهای open-weight میزبانیشده،shannon-1.6-lite،shannon-1.6-proوshannon-coder-1اعمال میکنند. - در مدلهای open-weight میزبانیشده متن پاسخ را محدود میکند. استدلال پیش از پاسخ در آن شمرده نمیشود و مقدار کمتر از 256 مانند 256 عمل میکند.
- stream مدل
shannon-1.6-lite،shannon-1.6-pro،shannon-coder-1یا خانواده Shannon 3 وقتی پاسخ در حد خود بریده شود باfinish_reason: "length"پایان مییابد.
قیمت چگونه شکل میگیرد
- قیمتها به USD برای هر 1,000,000 توکن هستند. موجودی شما بر حسب توکنهایی شمرده میشود که ارزش هر 1,000,000 آن $5.00 است، پس قیمت یک مدل میگوید توکنهایش چقدر از موجودی را میگیرند.
- مدلهای Shannon یک قیمت دارند. هر فراخوانی با
usage.total_tokensبه همان قیمت محاسبه میشود. - مدلهای open-weight میزبانیشده سه قیمت دارند. ورودیای که از کش پرامپت خوانده شود با قیمت کششده محاسبه میشود که 25% قیمت ورودی گرد شده به $0.001 است. بقیه ورودی با قیمت ورودی و خروجی با قیمت خروجی محاسبه میشود.
- مدلهای open-weight میزبانیشده توکنها را با توکنایزر خود هر مدل میشمارند.
GET /v1/modelsاین را باtokenizer: "original"مشخص میکند. shannon-coder-1روی/v1/chat/completionsو/v1/messagesبر حسب فراخوانی شمرده میشود، نه توکن. قیمت فهرستشده آن روی/v1/responsesاعمال میشود.
اینکه یک درخواست چه چیزی رزرو میکند، مثالهای عملی محاسبه هزینه و سهمیه فراخوانی Shannon Coder در «محدودیتها و موجودی» آمده است. محدودیتها و موجودی
شناسههای مدل
یکی از این شناسهها را بهعنوان model بفرستید.
shannon-1.6-lite
shannon-1.6-pro
shannon-2-lite
shannon-2-pro
shannon-3
shannon-3-pro
shannon-3.1
shannon-3.1-pro
shannon-3.5
shannon-coder-1
DeepSeek-V4-Pro-0813-3BIT-REAP
GLM-5.2-3BIT-REAP
Kimi-K3-3BIT-REAP
Nemotron3Ultra-3BIT-REAP
MiniMax-M3-3BIT-REAP
DeepSeek-V4-Flash-0731-W4A16-AUTOROUND-REAP
Kimi-K2.6-W4A16-AUTOROUND-REAP
Laguna-S-2.1-W4A16-AUTOROUND-REAP
inkling-W4A16-AUTOROUND-REAP
MiMo-V2.5-Pro-W8A16
MiMo-V2.5-W8A16
Hy3-W8A16 - حروف بزرگ و کوچک اهمیتی ندارند و فاصلههای اطراف شناسه حذف میشوند:
SHANNON-3وshannon-3یک مدل هستند. - پاسخ همیشه شناسه منتشرشده را در
modelدارد، با هر املایی که فرستاده باشید. - نام نمایشی مانند
Shannon 3شناسه نیست.
چهار املای کوتاهتر هم پذیرفته میشود.
| آنچه میفرستید | مدلی که پاسخ میدهد |
|---|---|
shannon-1.6 | shannon-1.6-lite |
shannon-3-lite | shannon-3 |
shannon-3.1-lite | shannon-3.1 |
shannon-coder | shannon-coder-1 |
شناسهای که منتشر نشده باشد روی هر سه endpoint با وضعیت 400، نوع invalid_request_error و پیام unknown model: <id> پاسخ داده میشود. هیچ مدل دیگری بهجای آن پاسخ نمیدهد.
{
"error": {
"type": "invalid_request_error",
"message": "unknown model: gpt-4o"
}
} {
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "unknown model: gpt-4o"
}
} - همیشه
modelرا بفرستید./v1/responsesبه درخواست بدون آن با400پاسخ میدهد. روی/v1/chat/completionsو/v1/messagesچنین درخواستی راshannon-1.6-liteپاسخ میدهد. POST /v1/tokenizeوPOST /v1/messages/count_tokensشناسههای مدلهای open-weight میزبانیشده را میپذیرند.
فهرست مدلها
GET /v1/models مدلهای این صفحه را بهصورت JSON، با همان پنجرههای زمینه، قیمتها و قابلیتها برمیگرداند. از آن برای پر کردن انتخابگر مدل یا بررسی یک قیمت در کد استفاده کنید.
GET https://api.shannon-ai.com/v1/models
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.shannon-ai.com/v1"
)
for model in client.models.list():
print(model.id) import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://api.shannon-ai.com/v1'
});
for await (const model of client.models.list()) {
console.log(model.id);
} curl "https://api.shannon-ai.com/v1/models" پاسخ، کوتاهشده به یک مورد از هر نوع:
{
"object": "list",
"data": [
{
"id": "shannon-3",
"object": "model",
"created": 1700000000,
"owned_by": "shannon-ai",
"display_name": "Shannon 3",
"context_window": 196608,
"max_output_tokens": 65536,
"pricing": {
"input_per_million_usd": 3.35,
"output_per_million_usd": 3.35,
"currency": "USD"
},
"capabilities": {
"tools": true,
"vision": true,
"reasoning": true,
"reasoning_effort": false,
"streaming": true,
"json_schema": true
},
"endpoints": [
"/v1/chat/completions",
"/v1/messages",
"/v1/responses"
]
},
{
"id": "MiniMax-M3-3BIT-REAP",
"object": "model",
"created": 1700000000,
"owned_by": "shannon-ai",
"display_name": "MiniMax-M3 · 3BIT-REAP",
"context_window": 262144,
"max_output_tokens": 65536,
"pricing": {
"input_per_million_usd": 0.5,
"cached_input_per_million_usd": 0.125,
"output_per_million_usd": 2,
"currency": "USD"
},
"tokenizer": "original",
"capabilities": {
"tools": true,
"vision": true,
"reasoning": true,
"reasoning_effort": true,
"streaming": true,
"response_format": true,
"json_schema": true,
"prompt_caching": true
},
"endpoints": [
"/v1/chat/completions",
"/v1/messages",
"/v1/responses",
"/v1/messages/count_tokens",
"/v1/tokenize"
]
}
]
} | فیلد | نوع | توضیحات | وجود دارد روی |
|---|---|---|---|
object | string | همیشه list. | |
data | array | یک مورد برای هر مدلی که میتوان آن را فراخوانی کرد. | |
data[].id | string | شناسهای که بهعنوان model میفرستید. | هر مدل |
data[].object | string | همیشه model. | هر مدل |
data[].created | integer | یک عدد ثابت، برای هر مدل یکسان: 1700000000. | هر مدل |
data[].owned_by | string | همیشه shannon-ai. | هر مدل |
data[].display_name | string | نامی برای نمایش. بهعنوان model پذیرفته نمیشود. | هر مدل |
data[].context_window | integer | پنجره زمینه بر حسب توکن. | هر مدل |
data[].max_output_tokens | integer | بزرگترین بودجه خروجی که یک درخواست میتواند بخواهد: روی هر مدل 65536. | هر مدل |
data[].pricing.input_per_million_usd | number | قیمت 1,000,000 توکن ورودی به USD. | هر مدل |
data[].pricing.cached_input_per_million_usd | number | قیمت 1,000,000 توکن ورودی که از کش پرامپت خوانده میشود. | مدلهای open-weight میزبانیشده |
data[].pricing.output_per_million_usd | number | قیمت 1,000,000 توکن خروجی به USD. در مدل Shannon برابر قیمت ورودی است. | هر مدل |
data[].pricing.currency | string | همیشه USD. | هر مدل |
data[].tokenizer | string | original: توکنها با توکنایزر خود مدل شمرده میشوند. | مدلهای open-weight میزبانیشده |
data[].capabilities.tools | boolean | مدل میتواند ابزارهایی را که اعلام میکنید فراخوانی کند. روی هر مدل true است. | هر مدل |
data[].capabilities.vision | boolean | مدل تصاویر را میخواند. | هر مدل |
data[].capabilities.reasoning | boolean | مدل پیش از پاسخ استدلال میکند. | هر مدل |
data[].capabilities.reasoning_effort | boolean | فیلد درخواست reasoning_effort روی این مدل اثر دارد. | هر مدل |
data[].capabilities.streaming | boolean | روی هر مدل true است. | هر مدل |
data[].capabilities.json_schema | boolean | response_format از نوع json_schema اثر دارد. | هر مدل |
data[].capabilities.response_format | boolean | response_format اصلاً اثر دارد، دستکم بهصورت شیء JSON. | مدلهای open-weight میزبانیشده |
data[].capabilities.prompt_caching | boolean | پیشوندهای تکراری پرامپت کش میشوند و با قیمت کششده محاسبه میشوند. | مدلهای open-weight میزبانیشده |
data[].endpoints | array | مسیرهایی که این شناسه را میپذیرند. | هر مدل |
GET /v1/modelsکلید نمیخواهد. پاسخ برای هر فراخوانیکننده یکسان است و به پلن شما بستگی ندارد.- فهرست شناسههایی را دارد که میتوان فراخوانی کرد. مدلی که در حال حاضر نمیتواند پاسخ دهد از آن کنار گذاشته میشود.
- endpointی برای یک مدل وجود ندارد:
GET /v1/models/{id}با404و نوعnot_found_errorپاسخ میدهد.