Барномасозон
API-и Milly Lab
API-и Milly Lab REST API-и бо OpenAI мувофиқ дар суроғаи https://api.m-lab.app/v1 мебошад. Бо як калид ба 13 модели чати OpenAI, Anthropic, Google, DeepSeek ва xAI, 4 модели тасвир ва як модели эмбеддинг дастрасӣ пайдо мекунед. API ба тарофаи Max ($42 дар як моҳ) ва болотар дохил аст. Ҳар модел нархи нишондодашуда барои як миллион токени вурудӣ ва хуруҷӣ дорад.
API-и Milly Lab дар як назар
| Параметр | Қимат |
|---|---|
| URL-и асосӣ | https://api.m-lab.app/v1 |
| Протокол | Формати OpenAI барои дархостҳои чат (chat completions), эмбеддингҳо ва тасвирҳо; стриминг тавассути server-sent events |
| Аутентификатсия | Калиди Bearer, ки бо mk_ оғоз мешавад ва ҳангоми сохтан танҳо як бор нишон дода мешавад |
| Тарофаҳо бо дастрасӣ ба API | Max, Advanced ва Enterprise |
| Нарх | Нархи нишондодашуда барои 1 млн токени вурудӣ ва хуруҷӣ барои ҳар модел; моделҳои тасвир — барои ҳар тасвир (рӯйхати моделҳоро дар поён бинед) |
| Берун аз ҳадди тарофа | Аз тавозуни пуркунӣ бо нархҳои пардохт аз рӯи истифода, ки дар барнома нишон дода шудаанд, пардохт мешавад |
| Лимити дархостҳо | То 120 дархост дар як дақиқа барои ҳар калид |
| Калидҳо дар як ҳисоб | То 5 калиди фаъол, ҳар кадом бо лимити харҷ ва рӯйхати моделҳои худ |
| Рӯйхати нархҳои ҷорӣ | GET /v1/models, калид лозим нест |
Дархости аввалро чӣ тавр фиристам?
Дар бахши «Калидҳои API»-и ҳисоби Milly Lab-и худ калид созед ва дар ҳар SDK-и OpenAI URL-и асосиро https://api.m-lab.app/v1 гузоред. Ҳар як мисоли поён ҳамон як дархости чатро мефиристад.
- Калид созед. Он бо mk_ оғоз мешавад ва танҳо як бор нишон дода мешавад, бинобар ин онро дар тағйирёбандаи муҳит, масалан MILLY_API_KEY, нигоҳ доред.
- URL-и асосиро https://api.m-lab.app/v1 гузоред. Дар коди бо OpenAI мувофиқ дигар чизеро иваз кардан лозим нест.
- Аз GET /v1/models id-и моделро интихоб кунед, масалан claude-sonnet-5.
curl
curl https://api.m-lab.app/v1/chat/completions \
-H "Authorization: Bearer $MILLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "claude-sonnet-5", "messages": [{"role": "user", "content": "Hello"}]}'Python
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.m-lab.app/v1", api_key=os.environ["MILLY_API_KEY"])
r = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Hello"}],
)
print(r.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.m-lab.app/v1", apiKey: process.env.MILLY_API_KEY });
const r = await client.chat.completions.create({
model: "claude-sonnet-5",
messages: [{ role: "user", content: "Hello" }],
});
console.log(r.choices[0].message.content);Ҷавоб объекти стандартии chat.completion аст ва майдони usage нишон медиҳад, ки барои чанд токен маблағ гирифта шуд. Барои гирифтани ҷавоб ба таври стриминг тавассути server-sent events stream: true-ро фиристед.
Дар API кадом эндпоинтҳо ҳастанд?
Ҳамаи эндпоинтҳои API (5) дар суроғаи https://api.m-lab.app/v1 ҷойгиранд.
| Эндпоинт | Вазифа |
|---|---|
GET /v1/models | Ҳамаи моделҳои API-ро бо нархҳои ҷорӣ, равзанаи контекст ва ҳадди ҷавоб нишон медиҳад. Бе калид кор мекунад. |
POST /v1/chat/completions | Ҷавоби модели чат — ба таври стриминг тавассути server-sent events ё якбора. |
POST /v1/embeddings | Эмбеддингҳо бо модели text-embedding-3-small (андозаи 1 536). |
POST /v1/images/generations | Дар як даъват аз 1 то 4 тасвир; моделҳои тасвир: 4. Синхронӣ, то 180 сония. |
GET /v1/usage | Дархостҳо, токенҳо ва долларҳои пардохтшуда барои ҳар калид ва ҳар модел, барои давраи то 92 рӯз. |
Кадом тарофаҳо дастрасӣ ба API доранд?
Дастрасӣ ба API ба тарофаҳои Max, Advanced ва Enterprise дохил аст. Дар тарофаҳои Ройгон, Starter ва Pro калиди API сохтан мумкин нест. Агар тарофаи шумо аз Max пасттар шавад, калидҳои мавҷуда то такмили тарофа кор намекунанд, вале онҳоро дидан ва бекор кардан мумкин аст.
| Тарофа | Нарх дар як моҳ | Дастрасӣ ба API |
|---|---|---|
| Ройгон | $0 | Не |
| Starter | $12 | Не |
| Pro | $25 | Не |
| Max | $42 | Ҳа |
| Advanced | $72 | Ҳа |
| Enterprise | Инфиродӣ | Ҳа |
Тарофаи ройгон барои ҳар модел ҳар 4 соат то 10 паём дар чат медиҳад — танҳо дар барномаи веб, бе дастрасӣ ба API.
Нархи як даъвати API чанд аст?
Ҳар модел нархи нишондодашуда барои як миллион токени вурудӣ ва хуруҷӣ дорад; моделҳои тасвир нархи нишондодашуда барои ҳар тасвир доранд. Нархи нишондодашуда арзиши даъват ҳангоми пардохт аз тавозун аст ва ҳарду дар рӯйхати моделҳои поён ва дар GET /v1/models оварда шудаанд. Аввал даъватҳоро ҳадди моҳонаи тарофа барои ҳамин модел фаро мегирад.
- Аввал ҳадди тарофа: дархост ба моделе, ки ба тарофаи шумо дохил аст, аз ҳадди моҳонаи он модел фаро гирифта мешавад.
- Баъд тавозуни пуркунӣ: моделҳои дигар ва истифода пас аз тамом шудани ҳад аз он бо нархи нишондодашуда пардохт мешаванд.
- Санҷиш пеш аз даъват: агар ҳад ва тавозун барои дархост кифоя набошанд, API пеш аз муроҷиат ба провайдер 402 бармегардонад ва ҳеҷ маблағ гирифта намешавад.
- Ҷавоби қисман пардохт мешавад: агар клиент ҳангоми стриминг пайвастро қатъ кунад, тавлид то охир идома меёбад ва токенҳои тавлидшуда ҳисоб карда мешаванд.
Мисоли ҳисоб
Дархост ба Claude Sonnet 5.5 бо 10 000 токени вурудӣ ва 1 000 токени хуруҷӣ аз тавозун бо нархҳои нишондодашуда $0,082 (10 000 × $6,00 + 1 000 × $22,00 барои як миллион токен) арзиш дорад.
Нархҳо бо доллари ИМА нишон дода шудаанд. Пардохт бо корти бонкӣ (Visa, Mastercard ва дигар) ё ҳамёни электронии тоҷикӣ дар саҳифаи бехатари пардохт анҷом меёбад. Маблағ бо сомонӣ аз рӯи қурби рӯз гирифта мешавад; агар корти шумо бо асъори дигар бошад, онро бонки шумо табдил медиҳад.
Кадом моделҳоро даъват кардан мумкин аст ва нархашон чанд аст?
Дар поён моделҳое оварда шудаанд, ки GET /v1/models дар санаи 2026-11-08 нишон медод: моделҳои чат, моделҳои тасвир ва як модели эмбеддинг. Нархҳо барои як миллион токен (моделҳои тасвир — барои ҳар тасвир) нишон дода шудаанд; манбаи нархҳои ҷорӣ ҳамеша худи эндпоинт аст.
Моделҳои чат
| Модел | id дар API | Вуруд, $ барои 1 млн токен | Хуруҷ, $ барои 1 млн токен | Равзанаи контекст, токен | Ҳад дар тарофа |
|---|---|---|---|---|---|
| Luna · GPT-6 | gpt-5.4-nano | $2,20 | $3,00 | 1 050 000 | Max, Advanced |
| Terra · GPT-6.1 | gpt-5.4 | $4,00 | $12,00 | 1 050 000 | Max, Advanced |
| Sol · GPT-6.1 | gpt-5.5 | $6,00 | $22,00 | 1 050 000 | Max, Advanced |
| Sol · GPT-6 | gpt-5.3-codex | $6,00 | $22,00 | 1 050 000 | Advanced |
| Claude Haiku 5.5 | claude-haiku-5-5 | $2,20 | $3,00 | 1 000 000 | Max, Advanced |
| Claude Sonnet 5.5 | claude-sonnet-5 | $6,00 | $22,00 | 1 000 000 | Max, Advanced |
| Claude Opus 5.5 | claude-opus-4-8 | $10,00 | $42,00 | 1 000 000 | Advanced |
| DeepSeek Flash | deepseek-v4-flash | $2,60 | $4,40 | 1 000 000 | Танҳо тавозун |
| DeepSeek Flash · Pro | deepseek-v4 | $2,60 | $4,40 | 1 000 000 | Танҳо тавозун |
| DeepSeek V4 Pro | deepseek-v4-pro | $4,64 | $9,92 | 1 000 000 | Max, Advanced |
| Gemini 3.8 Flash 200K | gemini-3.6-flash-200k | $3,50 | $9,50 | 200 000 | Танҳо тавозун |
| Gemini 3.8 Flash | gemini-3.6-flash | $3,50 | $9,50 | 1 048 576 | Max, Advanced |
| Grok 4.7 | grok-4.3 | $6,00 | $14,00 | 500 000 | Танҳо тавозун |
Баъзе моделҳо барои промптҳои дароз нархи дуюм доранд: дархосте, ки промпташ якҷоя бо токенҳои кэшшуда аз ҳадди модел дарозтар аст, пурра бо нархҳои промпти дарози он пардохт мешавад (ҷадвали поён). Масалан, Claude Haiku 5.5 вақте ки промпт аз 100 000 токен зиёд аст, барои як миллион токени вурудӣ $3,00 ва барои як миллион токени хуруҷӣ $7,00 арзиш дорад. Моделҳои Claude инчунин навиштан ба кэши промпт ва хондан аз онро бо нархҳои алоҳида ҳисоб мекунанд ва ҳар ҷустуҷӯи веб, ки модел анҷом медиҳад, $0,02 арзиш дорад. Ҳамаи нархҳоро GET /v1/models медиҳад.
Промптҳои дароз
| Модел | Промпт дарозтар аз, токен | Вуруд, $ барои 1 млн токен | Хуруҷ, $ барои 1 млн токен |
|---|---|---|---|
| Luna · GPT-6 | 272 000 | $2,40 | $3,50 |
| Terra · GPT-6.1 | 272 000 | $6,00 | $17,00 |
| Sol · GPT-6.1 | 272 000 | $10,00 | $32,00 |
| Sol · GPT-6 | 272 000 | $10,00 | $32,00 |
| Claude Haiku 5.5 | 100 000 | $3,00 | $7,00 |
| Grok 4.7 | 199 999 | $10,00 | $26,00 |
Моделҳои тасвир
| Модел | id дар API | Нарх барои як тасвир, сифати стандартӣ | Ҳад дар тарофа |
|---|---|---|---|
| Gemini Nano Banana 2.1 | gemini-nano-banana | $0,0872 | Max, Advanced |
| GPT Image 2.5 Flare | gpt-image-2 | $0,1254 | Max, Advanced |
| Flux 3 Image | fal-ai/flux-pro | $0,116 | Max |
| Stable Diffusion 3.5 Large | fal-ai/stable-diffusion-xl | $0,15 | Advanced |
Эмбеддингҳо
text-embedding-3-small векторҳои андозаи 1 536 бармегардонад; нархи нишондодашуда $2,04 барои як миллион токени вурудӣ аст. Эмбеддингҳо ба ягон тарофа дохил нестанд, бинобар ин ҳамеша аз тавозуни пуркунӣ бо ҳамин нарх пардохт мешаванд.
Дар сутуни «Ҳад дар тарофа» тарофаҳое нишон дода шудаанд, ки барои модел ҳадди моҳона доранд. Моделҳои «Танҳо тавозун», масалан Grok 4.7, дар тарофаҳо ҳад надоранд ва аз тавозуни пуркунӣ бо нархҳои пардохт аз рӯи истифода, ки дар барнома нишон дода шудаанд, пардохт мешаванд. Ҳадҳои Enterprise дар шартнома муайян карда мешаванд. Сатҳи дигари сифат нархи тасвирро тағйир медиҳад.
Лимитҳои дархостҳо кадомҳоянд?
Ҳар калиди API дар як дақиқа то 120 дархост фиристода метавонад ва дар як ҳисоб то 5 калиди фаъол буда метавонад. Дархосте, ки аз лимит мегузарад, ҷавоби HTTP 429 бо сарлавҳаи Retry-After мегирад, ки мегӯяд пас аз чанд сония такрор кардан мумкин аст.
| Лимит | Қимат |
|---|---|
| Дархостҳо барои як калид | То 120 дар як дақиқа |
| Калидҳои фаъол дар як ҳисоб | 5 |
| Паёмҳо дар як дархости чат | 200 |
| Аломатҳо дар як дархости чат | 400 000 |
| Вурудҳои эмбеддинг дар як даъват | 256, ҳар кадом то 12 000 аломат |
| Тасвирҳо дар як даъват | 1–4, промпт то 4 000 аломат |
| Вақт барои дархости тасвир | 180 сония |
| Давраи ҳисоботи истифода | То 92 рӯз |
Ҳар ҷавоби /v1 сарлавҳаи x-request-id дорад — ҳангоми муроҷиат ба дастгирӣ онро нишон диҳед. Ҷавобҳо ба дархостҳо бо калиди амалкунанда инчунин x-ratelimit-limit, x-ratelimit-remaining ва x-ratelimit-window доранд.
Лимити харҷ ва рӯйхати моделҳо чӣ тавр кор мекунанд?
Барои ҳар калид метавон лимити моҳонаи харҷ бо доллари ИМА ва рӯйхати моделҳои иҷозатдодашуда муқаррар кард. Даъват пас аз расидан ба лимит 402 spend_cap_reached бармегардонад, даъвати модели берун аз рӯйхат — 403 model_not_allowed. Ҳарду санҷиш пеш аз ҳар гуна пардохт иҷро мешаванд.
| Танзим | Чӣ тавр кор мекунад |
|---|---|
| Лимити моҳонаи харҷ | Бо сентҳои пурра, то $100 000. Харҷи ин калид аз 1-уми моҳ (UTC) ҳисоб карда мешавад ва 1-уми ҳар моҳ аз нав оғоз мешавад. Дархосте, ки лимитро мегузарад, то охир иҷро мешавад, бинобар ин зиёдатӣ на бештар аз як дархост аст. |
| Моделҳои иҷозатдодашуда | То 64 id-и модел; рӯйхати холӣ маънои ҳамаи моделҳои API-ро дорад. Номҳои кӯҳна ба id-и ҷорӣ иваз карда мешаванд. |
| Бекор кардан | Калиди бекоршуда аз дархости навбатӣ кор намекунад. Калидҳоро дар ҳар тарофа дидан ва бекор кардан мумкин аст. |
Барои /v1 CORS кушода аст, бинобар ин коди браузер API-ро бевосита даъват карда метавонад, вале калиди дар саҳифаи веб гузошташударо ҳар меҳмон мебинад. Ба чунин калид лимити қатъии харҷ ва рӯйхати моделҳо гузоред ё API-ро аз сервери худ даъват кунед.
API кадом кодҳои хаторо бармегардонад?
Хатоҳо дар формати OpenAI меоянд (мисол дар поён), бинобар ин коркарди хатоҳо дар SDK бе тағйир кор мекунад. Ба майдони code такя кунед, на ба матни паём.
{"error": {"message": "…", "type": "…", "code": "…"}}| HTTP | code | Маъно |
|---|---|---|
| 400 | invalid_body · invalid_messages · invalid_input · input_too_long · unsupported_encoding · invalid_range | Бадани дархост нодуруст аст, матни корбар нест, вуруди эмбеддинг нодуруст аст ё давраи ҳисобот хато дорад |
| 401 | missing_api_key · invalid_api_key | Калиди Bearer нест, номаълум аст ё бекор шудааст |
| 402 | insufficient_for_request · insufficient_balance | Ҳадди тарофа ва тавозун барои дархост кифоя нестанд |
| 402 | spend_cap_reached | Калид ба лимити моҳонаи харҷ расид |
| 403 | api_access_required | Тарофаи ҳисоб дастрасӣ ба API надорад |
| 403 | model_not_allowed | Модел дар рӯйхати иҷозатдодашудаи калид нест |
| 403 | account_disabled | Ҳисоб ғайрифаъол шудааст |
| 404 | model_not_found · key_not_found | Модели номаълум ё аз каталог хориҷшуда, ё id-и калиде, ки дар ин ҳисоб нест |
| 429 | rate_limit_exceeded | Зиёда аз 120 дархост дар як дақиқа бо ин калид; вақти Retry-After-ро интизор шавед |
| 502 | upstream_error | Провайдер пеш аз оғози ҷавоб хато дод; ҳеҷ маблағ гирифта нашуд |
| 503 | provider_unavailable | Провайдери модел ҳоло дастнорас аст; ҳеҷ маблағ гирифта нашуд |
Саволҳои маъмули барномасозон
Оё API-и Milly Lab бо SDK-ҳои OpenAI кор мекунад?
Ҳа. Дархостҳои чат, эмбеддингҳо ва тавлиди тасвир формати OpenAI-ро истифода мебаранд, бинобар ин бастаҳои расмии openai барои Python ва Node.js ва дигар абзорҳои бо OpenAI мувофиқ пас аз гузоштани URL-и асосии https://api.m-lab.app/v1 ва калиди Milly Lab кор мекунанд.
Оё API даъвати абзорҳо (tool calling) ва тасвирро дар вуруд дастгирӣ мекунад?
Тасвир дар вуруд — ҳа: паёмҳои чат матн қабул мекунанд, ва дар моделҳое, ки capabilities.vision-и онҳо true аст, инчунин қисмҳои image_url (PNG, JPEG, GIF ё WebP, ҳар кадом то 5 МБ, на зиёда аз 8 дар як дархост); моделҳои дигар тасвирро рад мекунанд. Даъвати абзорҳо — ҳоло не: майдонҳои tools ва tool_choice қабул карда мешаванд, то танзимоти пешфарзи SDK хато надиҳанд, вале иҷро намешаванд.
Оё тавассути API видео ё 3D сохтан мумкин аст?
Не. API дархостҳои чат, эмбеддингҳо ва тавлиди тасвирро дар бар мегирад. Видео ва 3D тавассути /v1 дастрас нестанд.
Оё моделеро, ки ба тарофаи ман дохил нест, даъват кардан мумкин аст?
Ҳа. Дар тарофаи Max ва болотар ҳар моделеро, ки GET /v1/models нишон медиҳад, даъват кардан мумкин аст. Моделе, ки дар тарофаи шумо ҳадди моҳона надорад, масалан Grok 4.7, аз тавозуни пуркунӣ бо нархҳои пардохт аз рӯи истифода, ки дар барнома нишон дода шудаанд, пардохт мешавад.
Оё дастрасии ройгон ба API ҳаст?
Не. Барои сохтани калидҳои API тарофаи Max ё болотар лозим аст. Тарофаи ройгон барои ҳар модел ҳар 4 соат то 10 паём дар чат медиҳад — танҳо дар барномаи веб, бе дастрасӣ ба API.
Истифодаи API чӣ тавр пардохт мешавад?
Истифодаи API аввал аз ҳадди моҳонаи тарофа ва баъд аз тавозуни пуркунӣ пардохт мешавад; нархҳо бо доллари ИМА нишон дода шудаанд. Пардохт бо корти бонкӣ (Visa, Mastercard ва дигар) ё ҳамёни электронии тоҷикӣ дар саҳифаи бехатари пардохт анҷом меёбад. Маблағ бо сомонӣ аз рӯи қурби рӯз гирифта мешавад; агар корти шумо бо асъори дигар бошад, онро бонки шумо табдил медиҳад.
Тавсифи пурраи API дар куҷост?
Дар роҳнамои API стриминг, эмбеддингҳо, тасвирҳо, эндпоинти омори истифода ва тавсияҳо муфассал шарҳ дода шудаанд.