📘 مستندات وب‌سرویس لمورا

معرفی وب‌سرویس لمورا

وب‌سرویس لمورا یک درگاه یکپارچه و سازگار با OpenAI است که با یک کلید، به صدها مدل هوش مصنوعی از OpenAI، Anthropic، Google، DeepSeek، xAI، Meta، Qwen و ... دسترسی می‌دهد. هزینه هر درخواست به تومان محاسبه و از کیف پول شما کسر می‌شود.

ویژگی‌ها

• سازگار با کتابخانه‌های رسمی OpenAI (Python، Node.js و ...) — فقط base_url را عوض کنید.
• چت با پشتیبانی کامل از Streaming (SSE)، تصویر ورودی (Vision) و Function Calling.
• تولید تصویر، تبدیل متن به گفتار، گفتار به متن، تولید ویدیو، Embedding و Moderation.
• جستجوی وب، استخراج محتوای صفحات و تحقیق خودکار.
• پرداخت ریالی از کیف پول، بدون نیاز به کارت ارزی.

Base URL

کپیtexthttps://www.lemura.ir/wp-json/lemuraai/v1

آدرس جایگزین (معادل): https://www.lemura.ir/api/lemuraai/v1

شروع در سه قدم

1. کیف پول خود را شارژ کنید.
2. از صفحه توسعه‌دهندگان یک کلید API (با پیشوند lsk-) بسازید.
3. اولین درخواست را بفرستید:

کپیbashcurl https://www.lemura.ir/wp-json/lemuraai/v1/chat/completions \
  -H "Authorization: Bearer lsk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "سلام!"}]}'

احراز هویت

همه درخواست‌ها (به‌جز /ping) باید کلید API را در هدر Authorization ارسال کنند:

کپیhttpAuthorization: Bearer lsk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

بررسی کلید

کپیbashcurl https://www.lemura.ir/wp-json/lemuraai/v1/me -H "Authorization: Bearer lsk-YOUR_KEY"

کپیjson{
  "object": "me",
  "user_id": 123,
  "username": "09123456789",
  "token": {"id": 7, "name": "my-app", "is_active": true, "created_at": "...", "last_used": "..."}
}

محدودیت نرخ

هر کلید حداکثر ۳۰ درخواست در دقیقه و ۳,۰۰۰ درخواست در روز. در صورت عبور، کد 429 برگردانده می‌شود.

فهرست Endpointها

عمومی و حساب

مدل‌ها

متن

تصویر، صوت و ویدیو

وب

بردار و ایمنی

چت (Chat Completions)

دقیقاً مطابق OpenAI. پارامترهای اصلی:

• model (الزامی) — شناسه مدل، مثل gpt-4o، claude-sonnet-4-5، gemini-2.5-flash، deepseek-chat.
• messages (الزامی) — آرایه پیام‌ها با نقش‌های system، user، assistant، tool.
• stream — با true پاسخ به‌صورت SSE ارسال می‌شود.
• temperature، max_tokens، max_completion_tokens، top_p، stop، tools، tool_choice، response_format، seed، reasoning_effort و n.

درخواست ساده

کپیbashcurl https://www.lemura.ir/wp-json/lemuraai/v1/chat/completions \
  -H "Authorization: Bearer lsk-YOUR_KEY" -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "تو یک دستیار مفید فارسی‌زبان هستی."},
      {"role": "user", "content": "سه نکته برای تمرکز بیشتر بگو"}
    ],
    "temperature": 0.7
  }'

پاسخ

کپیjson{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "gpt-4o-mini",
  "choices": [{"index": 0, "message": {"role": "assistant", "content": "..."}, "finish_reason": "stop"}],
  "usage": {"prompt_tokens": 32, "completion_tokens": 120, "total_tokens": 152}
}

هزینه بر اساس usage محاسبه و از کیف پول کسر می‌شود. موجودی و هزینه‌ها را با /balance و /usage ببینید. هدرهای X-RateLimit-Limit، X-RateLimit-Remaining و X-RateLimit-Reset وضعیت محدودیت نرخ را نشان می‌دهند.

Streaming

کپیpythonstream = client.chat.completions.create(
    model="gpt-4o-mini", stream=True,
    messages=[{"role": "user", "content": "یک داستان کوتاه بنویس"}])
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

تصویر ورودی (Vision)

کپیjson{
  "model": "gpt-4o",
  "messages": [{"role": "user", "content": [
    {"type": "text", "text": "در این تصویر چه می‌بینی؟"},
    {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
  ]}]
}

Function Calling

کپیjson{
  "model": "gpt-4o-mini",
  "messages": [{"role": "user", "content": "هوای تهران چطوره؟"}],
  "tools": [{"type": "function", "function": {
    "name": "get_weather",
    "parameters": {"type": "object", "properties": {"city": {"type": "string"}}, "required": ["city"]}
  }}]
}

Responses API

رابط جدید OpenAI برای مدل‌های استدلالی و ابزارها. ورودی می‌تواند متن ساده یا آرایه‌ای از پیام‌ها باشد.

کپیbashcurl https://www.lemura.ir/wp-json/lemuraai/v1/responses \
  -H "Authorization: Bearer lsk-YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"model": "gpt-5-mini", "input": "تفاوت هوش مصنوعی و یادگیری ماشین چیست؟"}'

کپیpythonr = client.responses.create(model="gpt-5-mini", input="یک شعر کوتاه درباره پاییز")
print(r.output_text)

Completions (قدیمی)

برای سازگاری با کدهای قدیمی؛ پارامتر prompt به‌جای messages.

تولید تصویر

• model (الزامی) — مثل gpt-image-1، imagen-4.0-generate-001، flux-1.1-pro. فهرست کامل در /models.
• prompt (الزامی، حداکثر ۱۰۰۰ کاراکتر) — توصیف تصویر. برای کیفیت بهتر انگلیسی بنویسید.
• size — مثل 1024x1024، 1024x1792، 1792x1024.
• n — تعداد تصاویر (هزینه × n).
• اختیاری: quality، style، background، output_format، response_format (url یا b64_json).

کپیbashcurl https://www.lemura.ir/wp-json/lemuraai/v1/images/generations \
  -H "Authorization: Bearer lsk-YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-1", "prompt": "a cozy reading nook with warm light, watercolor", "size": "1024x1024"}'

کپیpythonimg = client.images.generate(model="gpt-image-1", prompt="a futuristic Tehran skyline at night", size="1792x1024")
print(img.data[0].url or "base64 length: %d" % len(img.data[0].b64_json))

صوت

متن به گفتار (TTS)

پارامترها: model (مثل gpt-4o-mini-tts، tts-1، tts-1-hd)، input (متن)، voice (مثل alloy، nova، shimmer، echo). خروجی فایل صوتی است. هزینه هر درخواست: حدود ۵۰۰ تومان (پیش از سود).

کپیbashcurl https://www.lemura.ir/wp-json/lemuraai/v1/audio/speech \
  -H "Authorization: Bearer lsk-YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o-mini-tts", "input": "سلام، به لمورا خوش آمدید", "voice": "nova"}' \
  --output speech.mp3

گفتار به متن

ارسال به‌صورت multipart/form-data با فیلدهای file و model (whisper-1، gpt-4o-transcribe، gpt-4o-mini-transcribe). اختیاری: language، prompt، response_format، temperature.

کپیbashcurl https://www.lemura.ir/wp-json/lemuraai/v1/audio/transcriptions \
  -H "Authorization: Bearer lsk-YOUR_KEY" \
  -F [email protected] -F model=whisper-1 -F language=fa

ترجمه گفتار به انگلیسی

مانند transcriptions، با مدل whisper-1؛ خروجی متن انگلیسی است.

تولید ویدیو

تولید ویدیو ناهمگام است: ابتدا کار را بسازید، سپس وضعیت را بررسی و در پایان فایل را دریافت کنید.

پارامترها: model (sora-2، sora-2-pro، veo-3.1-generate-001، veo-3.1-fast-generate-001، ...)، prompt، seconds (یا duration) و size. هزینه = قیمت هر ثانیه × مدت.

کپیbashcurl https://www.lemura.ir/wp-json/lemuraai/v1/videos \
  -H "Authorization: Bearer lsk-YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"model": "sora-2", "prompt": "a paper boat drifting on a rainy street, cinematic", "seconds": 8}'

وضعیت کار (queued، in_progress، completed، failed).

دریافت فایل ویدیو پس از تکمیل.

کپیbashcurl https://www.lemura.ir/wp-json/lemuraai/v1/videos/VIDEO_ID/content -H "Authorization: Bearer lsk-YOUR_KEY" --output video.mp4

جستجو و تحقیق وب

جستجوی وب با پاسخ هوشمند

ارسال query (یا messages) و مدل جستجو (پیش‌فرض gpt-4o-search-preview). پارامتر search_context_size: low، medium یا high (هزینه بیشتر، منابع بیشتر).

کپیbashcurl https://www.lemura.ir/wp-json/lemuraai/v1/web-search \
  -H "Authorization: Bearer lsk-YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"query": "آخرین اخبار هوش مصنوعی این هفته", "search_context_size": "medium"}'

استخراج محتوای صفحه

url یا آرایه urls؛ اختیاری max_chars_per_url (۵۰۰ تا ۵۰٬۰۰۰). خروجی متن تمیزشده هر صفحه است.

کپیjson{"urls": ["https://example.com/article"], "max_chars_per_url": 8000}

تحقیق خودکار

query (یا topic)؛ اختیاری model و max_results. گزارشی جمع‌بندی‌شده با منابع برمی‌گرداند.

Embedding و Moderation

تبدیل متن به بردار برای جستجوی معنایی و RAG. مدل‌ها: text-embedding-3-small، text-embedding-3-large، text-embedding-ada-002. هزینه: حدود ۲۰ تومان به ازای هر ۱۰۰۰ توکن.

کپیpythone = client.embeddings.create(model="text-embedding-3-small", input=["سلام دنیا", "hello world"])
print(len(e.data[0].embedding))

بررسی محتوای نامناسب. مدل پیش‌فرض omni-moderation-latest؛ فیلد input الزامی است.

کپیjson{"model": "omni-moderation-latest", "input": "متنی برای بررسی"}

موجودی

کپیbashcurl https://www.lemura.ir/wp-json/lemuraai/v1/balance -H "Authorization: Bearer lsk-YOUR_KEY"

کپیjson{
  "object": "balance",
  "user_id": 123,
  "balance": 152000,
  "currency": "toman",
  "token_info": {"id": 7, "name": "my-app", "total_requests": 420, "total_tokens_used": 381200, "total_cost": 21500},
  "rate_limits": {"per_minute": 30, "per_day": 3000},
  "stats": {"total_spent": 48000, "total_requests": 1300, "total_tokens_used": 920000,
            "today": {"spent": 1200, "requests": 18}, "this_month": {"spent": 22000, "requests": 610}}
}

برای افزایش موجودی به کیف پول بروید. موجودی بین چت سایت، تولید تصویر و API مشترک است.

مدل‌ها

فهرست همه مدل‌های فعال همراه با نوع و قیمت تومانی:

کپیjson{
  "object": "list",
  "data": [
    {"id": "gpt-4o-mini", "object": "model", "type": "chat", "owned_by": "openai",
     "input_toman_per_1m": 46800, "output_toman_per_1m": 187200, "cached_toman_per_1m": 23400},
    {"id": "gpt-image-1", "object": "model", "type": "image", "price": 12000},
    {"id": "sora-2", "object": "model", "type": "video", "price_per_second": 26000, "max_seconds": 12}
  ]
}

انواع: chat، image، web_search، audio_tts، audio_transcription، audio_translation، video، embedding، moderation.

جزئیات یک مدل؛ اگر وجود نداشته باشد کد 404 با نوع model_not_found.

کلیدها و قیمت‌گذاری

مدیریت کلید

• کلیدها از صفحه توسعه‌دهندگان ساخته، غیرفعال یا حذف می‌شوند.
• برای هر برنامه یک کلید جدا بسازید تا مصرف را جدا ببینید و در صورت لو رفتن فقط همان را حذف کنید.
• حداکثر تعداد کلید برای هر کاربر: ۱۰.

نحوه محاسبه هزینه

• مدل‌های متنی: بر اساس توکن ورودی، خروجی و ورودی کش‌شده، با قیمت تومانی هر مدل (در /models).
• تصویر: قیمت ثابت به ازای هر تصویر.
• ویدیو: قیمت هر ثانیه × مدت ویدیو.
• صوت: قیمت ثابت به ازای هر درخواست.
• جستجوی وب: بر اساس search_context_size.

قیمت‌ها بر اساس نرخ روز دلار محاسبه می‌شوند و ممکن است تغییر کنند. درخواست‌های ناموفق هزینه‌ای ندارند.

گزارش مصرف

مصرف روزانه (حداکثر ۹۰ روز) برای کاربرِ صاحب کلید:

کپیjson{
  "object": "usage", "user_id": 123, "days": 30,
  "data": [{"day": "2026-10-20", "requests": 42, "tokens": 51200, "cost": 2900}]
}

وضعیت سرویس

بدون نیاز به کلید؛ برای مانیتورینگ.

نمونه کدها

Python (کتابخانه openai)

کپیpython# pip install openai
from openai import OpenAI

client = OpenAI(api_key="lsk-YOUR_KEY", base_url="https://www.lemura.ir/wp-json/lemuraai/v1")
resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "یک تابع مرتب‌سازی سریع بنویس"}],
)
print(resp.choices[0].message.content)

Node.js

کپیjavascript// npm i openai
import OpenAI from "openai";

const client = new OpenAI({ apiKey: process.env.LEMURA_KEY, baseURL: "https://www.lemura.ir/wp-json/lemuraai/v1" });
const stream = await client.chat.completions.create({
  model: "gpt-4o-mini", stream: true,
  messages: [{ role: "user", content: "سلام!" }],
});
for await (const part of stream) process.stdout.write(part.choices[0]?.delta?.content || "");

PHP

کپیphp$ch = curl_init("https://www.lemura.ir/wp-json/lemuraai/v1/chat/completions");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer lsk-YOUR_KEY", "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(["model" => "gpt-4o-mini",
    "messages" => [["role" => "user", "content" => "سلام"]]]),
]);
$res = json_decode(curl_exec($ch), true);
echo $res["choices"][0]["message"]["content"];

LangChain

کپیpythonfrom langchain_openai import ChatOpenAI
llm = ChatOpenAI(model="gpt-4o-mini", api_key="lsk-YOUR_KEY", base_url="https://www.lemura.ir/wp-json/lemuraai/v1")
print(llm.invoke("سلام").content)

خطاها و رفع اشکال

خطاها در قالب استاندارد OpenAI برمی‌گردند:

کپیjson{"error": {"message": "Insufficient balance. Available: 120 toman", "type": "insufficient_balance", "code": 402}}

نکات

• اگر کتابخانه OpenAI خطای اتصال می‌دهد، مطمئن شوید base_url دقیقاً https://www.lemura.ir/wp-json/lemuraai/v1 است (بدون /chat/completions).
• برای درخواست‌های طولانی (تصویر و ویدیو) timeout کلاینت را حداقل ۱۸۰ ثانیه بگذارید.
• در صورت تکرار خطای 5xx، مدل جایگزین را امتحان کنید.

سوالات متداول

آیا با کدهای فعلی OpenAI سازگار است؟

بله. فقط api_key را با کلید لمورا و base_url را با آدرس لمورا جایگزین کنید.

هزینه درخواست‌های ناموفق کسر می‌شود؟

خیر. فقط درخواست‌های موفق هزینه دارند.

موجودی API و چت سایت جداست؟

خیر، یک کیف پول مشترک برای همه سرویس‌هاست.

چطور بفهمم هر درخواست چقدر هزینه داشته؟

از /usage و /balance یا تاریخچه کیف پول استفاده کنید.

کلیدم لو رفته، چه کنم؟

فوراً از صفحه توسعه‌دهندگان آن را حذف و کلید جدید بسازید.

پشتیبانی

برای سوالات فنی از چت سایت یا راه‌های ارتباطی لمورا با ما در تماس باشید.