API-и бо OpenAI мувофиқ
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 дар як моҳ) ва болотар дохил аст. Нархи ҳар даъват нархи провайдер ва иловатан $1 барои ҳар миллион токени вурудӣ ё хуруҷӣ мебошад.
Охирин навсозӣ:
API-и Milly Lab дар як назар
| Параметр | Қимат |
|---|---|
| URL-и асосӣ | https://api.m-lab.app/v1 |
| Протокол | Формати OpenAI барои дархостҳои чат (chat completions), эмбеддингҳо ва тасвирҳо; стриминг тавассути server-sent events |
| Аутентификатсия | Калиди Bearer, ки бо mk_ оғоз мешавад ва ҳангоми сохтан танҳо як бор нишон дода мешавад |
| Тарофаҳо бо дастрасӣ ба API | Max, Advanced ва Enterprise |
| Нарх | Нархи провайдер + $1 барои 1 млн токени вурудӣ ва $1 барои 1 млн токени хуруҷӣ; барои ҳар тасвир + $0,01 |
| Берун аз ҳадди тарофа | Аз тавозуни пуркунӣ бо нархи ×2 пардохт мешавад |
| Лимити дархостҳо | То 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 чанд аст?
Нархи даъвати API ба нархи провайдери модел баробар аст, иловатан пардохти платформаи Milly Lab: $1 барои ҳар миллион токени вурудӣ ва $1 барои ҳар миллион токени хуруҷӣ; барои ҳар тасвири тавлидшуда боз $0,01 илова мешавад. Аввал ҳадди моҳонаи тарофа барои ҳамин модел истифода мешавад ва ҳар чизе аз он зиёд бошад, аз тавозуни пуркунӣ бо нархи ×2 гирифта мешавад.
- Аввал ҳадди тарофа: моделе, ки ба тарофаи шумо дохил аст, аз ҳадди моҳонаи худ бо нархи ҷадвал пардохт мешавад.
- Баъд тавозуни пуркунӣ бо нархи ×2: моделҳои дигар ва истифода пас аз тамом шудани ҳад бо нархи ×2 аз нархи ҷадвал пардохт мешаванд.
- Санҷиш пеш аз даъват: агар ҳад ва тавозун барои дархост кифоя набошанд, API пеш аз муроҷиат ба провайдер 402 бармегардонад ва ҳеҷ маблағ гирифта намешавад.
- Ҷавоби қисман пардохт мешавад: агар клиент ҳангоми стриминг пайвастро қатъ кунад, тавлид то охир идома меёбад ва токенҳои тавлидшуда ҳисоб карда мешаванд.
Мисоли ҳисоб
Дархост ба Claude Sonnet 5 бо 10 000 токени вурудӣ ва 1 000 токени хуруҷӣ аз ҳадди тарофа $0,041 (10 000 × $3,00 + 1 000 × $11,00 барои як миллион токен) ё аз тавозуни пуркунӣ $0,082 арзиш дорад.
Нархҳо бо доллари ИМА нишон дода шудаанд. Пардохтҳоро SmartPay — низоми пардохтии Тоҷикистон коркард мекунад. Пардохт бо ҳар гуна асъор имконпазир аст.
Кадом моделҳоро даъват кардан мумкин аст ва нархашон чанд аст?
Дар поён моделҳое оварда шудаанд, ки GET /v1/models дар санаи 2026-10-04 нишон медод: моделҳои чат, моделҳои тасвир ва як модели эмбеддинг. Нархҳо пардохти платформаро ($1) дар бар мегиранд; манбаи нархҳои ҷорӣ ҳамеша худи эндпоинт аст.
Моделҳои чат
| Модел | id дар API | Вуруд, $ барои 1 млн токен | Хуруҷ, $ барои 1 млн токен | Равзанаи контекст, токен | Ҳад дар тарофа |
|---|---|---|---|---|---|
| GPT-5.6 Luna | gpt-5.4-nano | $1,20 | $2,20 | 400 000 | Max, Advanced |
| GPT-5.6 Terra | gpt-5.4 | $3,00 | $13,00 | 400 000 | Max, Advanced |
| GPT-5.6 Sol | gpt-5.5 | $5,00 | $21,00 | 400 000 | Max, Advanced |
| ChatGPT Codex | gpt-5.3-codex | $2,75 | $15,00 | 400 000 | Advanced |
| Claude Haiku 4.5 | claude-haiku-4-5 | $2,00 | $6,00 | 200 000 | Max, Advanced |
| Claude Sonnet 5 | claude-sonnet-5 | $3,00 | $11,00 | 1 000 000 | Max, Advanced |
| Claude Opus 5 | claude-opus-4-8 | $6,00 | $26,00 | 200 000 | Advanced |
| DeepSeek V4 Flash | deepseek-v4-flash | $1,22 | $1,66 | 128 000 | Танҳо тавозун |
| DeepSeek V4 | deepseek-v4 | $1,22 | $1,66 | 128 000 | Танҳо тавозун |
| DeepSeek V4 Pro | deepseek-v4-pro | $1,66 | $2,98 | 256 000 | Max, Advanced |
| Gemini 3.7 Flash 200K | gemini-3.6-flash-200k | $1,75 | $4,75 | 200 000 | Танҳо тавозун |
| Gemini 3.7 Flash | gemini-3.6-flash | $1,75 | $4,75 | 1 000 000 | Max, Advanced |
| Grok 4.6 | grok-4.3 | $3,00 | $7,00 | 256 000 | Танҳо тавозун |
Моделҳои тасвир
| Модел | id дар API | Нарх барои як тасвир, сифати стандартӣ | Ҳад дар тарофа |
|---|---|---|---|
| Gemini Nano Banana 2 | gemini-nano-banana | $0,077 | Max, Advanced |
| ChatGPT Image 2.0 | gpt-image-2 | $0,0627 | Max, Advanced |
| Flux 2 Pro | fal-ai/flux-pro | $0,04 | Max |
| Stable Diffusion 3.5 Large | fal-ai/stable-diffusion-xl | $0,075 | Advanced |
Эмбеддингҳо
text-embedding-3-small векторҳои андозаи 1 536 бармегардонад ва бо назардошти пардохти платформа $1,02 барои як миллион токени вурудӣ арзиш дорад. Эмбеддингҳо ба ягон тарофа дохил нестанд, бинобар ин ҳамеша аз тавозуни пуркунӣ бо нархи ×2 пардохт мешаванд.
Дар сутуни «Ҳад дар тарофа» тарофаҳое нишон дода шудаанд, ки барои модел ҳадди моҳона доранд. Моделҳои «Танҳо тавозун», масалан Grok 4.6, дар тарофаҳо ҳад надоранд ва аз тавозуни пуркунӣ бо нархи ×2 пардохт мешаванд. Ҳадҳои 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) ва тасвирро дар вуруд дастгирӣ мекунад?
Ҳоло не. Майдонҳои tools ва tool_choice қабул карда мешаванд, то танзимоти пешфарзи SDK хато надиҳанд, вале иҷро намешаванд. Паёмҳои чат танҳо матн қабул мекунанд; қисмҳои тасвир нодида гирифта мешаванд.
Оё тавассути API видео ё 3D сохтан мумкин аст?
Не. API дархостҳои чат, эмбеддингҳо ва тавлиди тасвирро дар бар мегирад. Видео ва 3D тавассути /v1 дастрас нестанд.
Оё моделеро, ки ба тарофаи ман дохил нест, даъват кардан мумкин аст?
Ҳа. Дар тарофаи Max ва болотар ҳар моделеро, ки GET /v1/models нишон медиҳад, даъват кардан мумкин аст. Моделе, ки дар тарофаи шумо ҳадди моҳона надорад, масалан Grok 4.6, аз тавозуни пуркунӣ бо нархи ×2 пардохт мешавад.
Оё дастрасии ройгон ба API ҳаст?
Не. Барои сохтани калидҳои API тарофаи Max ё болотар лозим аст. Тарофаи ройгон барои ҳар модел ҳар 4 соат то 10 паём дар чат медиҳад — танҳо дар барномаи веб, бе дастрасӣ ба API.
Истифодаи API чӣ тавр пардохт мешавад?
Истифодаи API аввал аз ҳадди моҳонаи тарофа ва баъд аз тавозуни пуркунӣ пардохт мешавад; нархҳо бо доллари ИМА нишон дода шудаанд. Пардохтҳоро SmartPay — низоми пардохтии Тоҷикистон коркард мекунад. Пардохт бо ҳар гуна асъор имконпазир аст.
Тавсифи пурраи API дар куҷост?
Дар роҳнамои API стриминг, эмбеддингҳо, тасвирҳо, эндпоинти омори истифода ва тавсияҳо муфассал шарҳ дода шудаанд.