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_ оғоз мешавад ва ҳангоми сохтан танҳо як бор нишон дода мешавад
Тарофаҳо бо дастрасӣ ба APIMax, 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 гузоред. Ҳар як мисоли поён ҳамон як дархости чатро мефиристад.

  1. Калид созед. Он бо mk_ оғоз мешавад ва танҳо як бор нишон дода мешавад, бинобар ин онро дар тағйирёбандаи муҳит, масалан MILLY_API_KEY, нигоҳ доред.
  2. URL-и асосиро https://api.m-lab.app/v1 гузоред. Дар коди бо OpenAI мувофиқ дигар чизеро иваз кардан лозим нест.
  3. Аз 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 Lunagpt-5.4-nano$1,20$2,20400 000Max, Advanced
GPT-5.6 Terragpt-5.4$3,00$13,00400 000Max, Advanced
GPT-5.6 Solgpt-5.5$5,00$21,00400 000Max, Advanced
ChatGPT Codexgpt-5.3-codex$2,75$15,00400 000Advanced
Claude Haiku 4.5claude-haiku-4-5$2,00$6,00200 000Max, Advanced
Claude Sonnet 5claude-sonnet-5$3,00$11,001 000 000Max, Advanced
Claude Opus 5claude-opus-4-8$6,00$26,00200 000Advanced
DeepSeek V4 Flashdeepseek-v4-flash$1,22$1,66128 000Танҳо тавозун
DeepSeek V4deepseek-v4$1,22$1,66128 000Танҳо тавозун
DeepSeek V4 Prodeepseek-v4-pro$1,66$2,98256 000Max, Advanced
Gemini 3.7 Flash 200Kgemini-3.6-flash-200k$1,75$4,75200 000Танҳо тавозун
Gemini 3.7 Flashgemini-3.6-flash$1,75$4,751 000 000Max, Advanced
Grok 4.6grok-4.3$3,00$7,00256 000Танҳо тавозун

Моделҳои тасвир

Моделid дар APIНарх барои як тасвир, сифати стандартӣҲад дар тарофа
Gemini Nano Banana 2gemini-nano-banana$0,077Max, Advanced
ChatGPT Image 2.0gpt-image-2$0,0627Max, Advanced
Flux 2 Profal-ai/flux-pro$0,04Max
Stable Diffusion 3.5 Largefal-ai/stable-diffusion-xl$0,075Advanced

Эмбеддингҳо

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": "…"}}
HTTPcodeМаъно
400invalid_body · invalid_messages · invalid_input · input_too_long · unsupported_encoding · invalid_rangeБадани дархост нодуруст аст, матни корбар нест, вуруди эмбеддинг нодуруст аст ё давраи ҳисобот хато дорад
401missing_api_key · invalid_api_keyКалиди Bearer нест, номаълум аст ё бекор шудааст
402insufficient_for_request · insufficient_balanceҲадди тарофа ва тавозун барои дархост кифоя нестанд
402spend_cap_reachedКалид ба лимити моҳонаи харҷ расид
403api_access_requiredТарофаи ҳисоб дастрасӣ ба API надорад
403model_not_allowedМодел дар рӯйхати иҷозатдодашудаи калид нест
403account_disabledҲисоб ғайрифаъол шудааст
404model_not_found · key_not_foundМодели номаълум ё аз каталог хориҷшуда, ё id-и калиде, ки дар ин ҳисоб нест
429rate_limit_exceededЗиёда аз 120 дархост дар як дақиқа бо ин калид; вақти Retry-After-ро интизор шавед
502upstream_errorПровайдер пеш аз оғози ҷавоб хато дод; ҳеҷ маблағ гирифта нашуд
503provider_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 стриминг, эмбеддингҳо, тасвирҳо, эндпоинти омори истифода ва тавсияҳо муфассал шарҳ дода шудаанд.