Гузаштан ба мундариҷа

Барномасозон

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_ оғоз мешавад ва ҳангоми сохтан танҳо як бор нишон дода мешавад
Тарофаҳо бо дастрасӣ ба APIMax, Advanced ва Enterprise
НархНархи нишондодашуда барои 1 млн токени вурудӣ ва хуруҷӣ барои ҳар модел; моделҳои тасвир — барои ҳар тасвир (рӯйхати моделҳоро дар поён бинед)
Берун аз ҳадди тарофаАз тавозуни пуркунӣ бо нархҳои пардохт аз рӯи истифода, ки дар барнома нишон дода шудаанд, пардохт мешавад
Лимити дархостҳоТо 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 чанд аст?

Ҳар модел нархи нишондодашуда барои як миллион токени вурудӣ ва хуруҷӣ дорад; моделҳои тасвир нархи нишондодашуда барои ҳар тасвир доранд. Нархи нишондодашуда арзиши даъват ҳангоми пардохт аз тавозун аст ва ҳарду дар рӯйхати моделҳои поён ва дар 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-6gpt-5.4-nano$2,20$3,001 050 000Max, Advanced
Terra · GPT-6.1gpt-5.4$4,00$12,001 050 000Max, Advanced
Sol · GPT-6.1gpt-5.5$6,00$22,001 050 000Max, Advanced
Sol · GPT-6gpt-5.3-codex$6,00$22,001 050 000Advanced
Claude Haiku 5.5claude-haiku-5-5$2,20$3,001 000 000Max, Advanced
Claude Sonnet 5.5claude-sonnet-5$6,00$22,001 000 000Max, Advanced
Claude Opus 5.5claude-opus-4-8$10,00$42,001 000 000Advanced
DeepSeek Flashdeepseek-v4-flash$2,60$4,401 000 000Танҳо тавозун
DeepSeek Flash · Prodeepseek-v4$2,60$4,401 000 000Танҳо тавозун
DeepSeek V4 Prodeepseek-v4-pro$4,64$9,921 000 000Max, Advanced
Gemini 3.8 Flash 200Kgemini-3.6-flash-200k$3,50$9,50200 000Танҳо тавозун
Gemini 3.8 Flashgemini-3.6-flash$3,50$9,501 048 576Max, Advanced
Grok 4.7grok-4.3$6,00$14,00500 000Танҳо тавозун

Баъзе моделҳо барои промптҳои дароз нархи дуюм доранд: дархосте, ки промпташ якҷоя бо токенҳои кэшшуда аз ҳадди модел дарозтар аст, пурра бо нархҳои промпти дарози он пардохт мешавад (ҷадвали поён). Масалан, Claude Haiku 5.5 вақте ки промпт аз 100 000 токен зиёд аст, барои як миллион токени вурудӣ $3,00 ва барои як миллион токени хуруҷӣ $7,00 арзиш дорад. Моделҳои Claude инчунин навиштан ба кэши промпт ва хондан аз онро бо нархҳои алоҳида ҳисоб мекунанд ва ҳар ҷустуҷӯи веб, ки модел анҷом медиҳад, $0,02 арзиш дорад. Ҳамаи нархҳоро GET /v1/models медиҳад.

Промптҳои дароз

МоделПромпт дарозтар аз, токенВуруд, $ барои 1 млн токенХуруҷ, $ барои 1 млн токен
Luna · GPT-6272 000$2,40$3,50
Terra · GPT-6.1272 000$6,00$17,00
Sol · GPT-6.1272 000$10,00$32,00
Sol · GPT-6272 000$10,00$32,00
Claude Haiku 5.5100 000$3,00$7,00
Grok 4.7199 999$10,00$26,00

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

Моделid дар APIНарх барои як тасвир, сифати стандартӣҲад дар тарофа
Gemini Nano Banana 2.1gemini-nano-banana$0,0872Max, Advanced
GPT Image 2.5 Flaregpt-image-2$0,1254Max, Advanced
Flux 3 Imagefal-ai/flux-pro$0,116Max
Stable Diffusion 3.5 Largefal-ai/stable-diffusion-xl$0,15Advanced

Эмбеддингҳо

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": "…"}}
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) ва тасвирро дар вуруд дастгирӣ мекунад?

Тасвир дар вуруд — ҳа: паёмҳои чат матн қабул мекунанд, ва дар моделҳое, ки 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 стриминг, эмбеддингҳо, тасвирҳо, эндпоинти омори истифода ва тавсияҳо муфассал шарҳ дода шудаанд.