PERSIAN AI COOKBOOK
چهار دستورپخت کامل با مدلهای فارسیمحور دیبا — از کد آماده تا قیمت شفاف. همهٔ مدلها با یک کلید اپکس روی درگاه استاندارد OpenAI در دسترساند؛ با بستهٔ فارسی هم ۲۰٪ ارزانتر میشوند.
01 / CHATBOT
دستیاری که ۲۴/۷ به فارسی پاسخ میدهد، دستور مشتری را میفهمد و با فراخوانی ابزار (tool calling) وضعیت سفارش را از سیستم شما میگیرد. فارسی بومی، بدون لهجه، بدون هزینهٔ ارز.
حساب و کلید
اولین پیام
base_url را روی درگاه اپکس بگذارید و مدل را diba-1.اتصال به کسبوکار (پیشرفته)
get_order_status را تعریف کنید تا بات، خودش وضعیت واقعی سفارش را از نرمافزار شما بپرسد و جواب صریح بدهد.curl https://api.apx24.ir/v1/chat/completions \
-H "Authorization: Bearer $APX_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "diba-1",
"messages": [
{"role": "system", "content": "تو دستیار پشتیبانی فروشگاه «اپکس» هستی؛ فقط دربارهٔ سفارش، ارسال و بازگشت وجه پاسخ بده و فارسی روان بنویس."},
{"role": "user", "content": "سفارش من کی میرسد؟"}
],
"max_tokens": 300
}'02 / RAG
آرشیو، قرارداد، مقاله یا دانش سازمانیتان را قابلجستوجو کنید: اسناد یکبار بردارسازی میشوند، هر پرسش با نزدیکترین بخشها جفت میشود و مدل، پاسخ مستند میسازد. تنها امبدینگ فارسیِ بازار.
ایندکس (یکبار برای هر سند)
diba-embed بردارسازی کنید. خروجی ۱۰۲۴ بعدی است و نرمالشده — ضرب داخلی همان شباهت کسینوسی است؛ دیتابیس برداری لازم نیست، حتی یک آرایهٔ NumPy کافی است.جستوجو
input_type: "query" بفرستید (کیفیت بالاتر) و ۳ قطعهٔ برتر را بردارید.پاسخ
import numpy as np
from openai import OpenAI
client = OpenAI(api_key="کلید-اپکس-شما", base_url="https://api.apx24.ir/v1")
# ۱) اسناد را یکبار بردارسازی کن (حالت document)
docs = ["شرایط مرجوعی: تا ۷ روز پس از تحویل، با بستهبندی سالم.",
"ارسال تهران ۲۴ ساعته است؛ شهرستان ۲ تا ۴ روز کاری.",
"پرداخت با کارتبهکارت و درگاه بانکی انجام میشود."]
resp = client.embeddings.create(model="diba-embed", input=docs)
D = np.array([d.embedding for d in resp.data])
# ۲) برای هر پرسش، حالت query را فراموش نکن (کیفیت بالاتر)
q = "چند روز فرصت مرجوع کردن دارم؟"
qv = np.array(client.embeddings.create(
model="diba-embed", input=[q], extra_body={"input_type": "query"}
).data[0].embedding)
# ۳) نزدیکترین اسناد را پیدا کن (بردارها نرمالاند — ضرب داخلی = شباهت)
top = np.argsort(-(D @ qv))[:3]
# ۴) پاسخ نهایی را مدل بسازد
context = "\n".join(docs[i] for i in top)
ans = client.chat.completions.create(
model="diba-1",
messages=[{"role": "user", "content": f"فقط بر اساس این اسناد پاسخ بده:\n{context}\n\nپرسش: {q}"}],
)
print(ans.choices[0].message.content)03 / OCR
عکس رسید، فاکتور یا فرم را بفرستید؛ diba-vision همهٔ متن فارسی را میخواند و به JSON ساختاریافته تحویل میدهد — اعداد فارسی، تاریخ شمسی و فیلدهای دستنویس. برای اتوماسیون حسابداری و بایگانی.
عکس را بفرست
پردازش
بدون کد هم میخواهید؟
B64=$(base64 -w0 receipt.jpg)
curl https://api.apx24.ir/v1/chat/completions \
-H "Authorization: Bearer $APX_KEY" \
-H "Content-Type: application/json" \
-d "{
\"model\": \"diba-vision\",
\"messages\": [{\"role\": \"user\", \"content\": [
{\"type\": \"image_url\", \"image_url\": {\"url\": \"data:image/jpeg;base64,$B64\"}},
{\"type\": \"text\", \"text\": \"همهٔ فیلدهای این رسید را فقط به شکل JSON استخراج کن: شماره سفارش، مبلغ کل (عدد)، تاریخ، نام فروشنده.\"}
]}],
\"max_tokens\": 400
}"04 / VOICE
پیام خوشآمدگویی، اعلان سفارش، کتاب صوتی یا پاسخ تلفنی (IVR) — متن را بدهید، صدای فارسی طبیعی بگیرید. تأخیر اولین ثانیهٔ صدا روی زیرساخت میزبانیشده در ایران بسیار کم است.
متن به صدا
/v1/audio/speech متن را به MP3 تبدیل کنید — همان فرمتی که از OpenAI میشناسید.مسیر پیشرفته
[سارا] و [pause:1]) برای تولید حرفهایتر بهزودی فعال میشود؛ همین صفحه را ببینید.curl https://api.apx24.ir/v1/audio/speech \
-H "Authorization: Bearer $APX_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "diba-tts", "input": "سلام! سفارش شما با موفقیت ثبت شد و تا ۲۴ ساعت آینده ارسال میشود.", "voice": "diba", "response_format": "mp3"}' \
--output welcome.mp305 / VOICE AGENT
همان معماری که پشتیبانی صوتی خودمان با آن کار میکند: پیام صوتی مشتری → تبدیل به متن (diba-stt-small) → پاسخ هوشمند (diba-1) → پاسخ صوتی فارسی (diba-tts). کل کد ربات در یک فایل؛ فقط توکن ربات و کلید اپکس را بگذارید و اجرا کنید.
ربات بساز
اجرا
pip install pyTelegramBotAPI requests و بعد python bot.py. مشتری ویس میفرستد، متن و جواب صوتی میگیرد.هزینه هر گفتوگو
# دستیار صوتی فارسی روی تلگرام — با درگاه اپکس
# pip install pyTelegramBotAPI requests
import telebot, requests, io
APX = "https://api.apx24.ir/v1"
KEY = "کلید-اپکس-شما"
H = {"Authorization": f"Bearer {KEY}"}
bot = telebot.TeleBot("توکن-ربات-تلگرام")
def chat(text):
r = requests.post(f"{APX}/chat/completions", headers=H, json={
"model": "diba-1",
"messages": [{"role": "system", "content": "تو دستیار صوتی فارسی کسبوکار هستی؛ کوتاه و دوستانه جواب بده."},
{"role": "user", "content": text}],
}, timeout=60)
return r.json()["choices"][0]["message"]["content"]
def speak(text):
r = requests.post(f"{APX}/audio/speech", headers=H, json={
"model": "diba-tts", "input": text[:1000], "voice": "diba", "response_format": "mp3",
}, timeout=60)
return io.BytesIO(r.content)
@bot.message_handler(content_types=["voice"])
def voice_reply(m):
f = bot.get_file(m.voice.file_id)
ogg = bot.download_file(f.file_path)
tr = requests.post(f"{APX}/audio/transcriptions", # فعال با نسخهٔ بعدی درگاه
headers=H, files={"file": ("v.ogg", ogg, "audio/ogg")},
data={"model": "diba-stt-small"})
text = tr.json().get("text", "")
bot.reply_to(m, f"🎙 {text}")
bot.send_voice(m.chat.id, speak(chat(text)), None, "audio/mpeg")
@bot.message_handler(func=lambda m: True)
def text_reply(m):
bot.reply_to(m, chat(m.text))
bot.infinity_polling()READY PACKAGES / عمودیها
همین قطعهها را کنار هم گذاشتیم و برای هر صنعت یک ترکیب پیشنهادی مشخص داریم — با چتباتساز، دانش خودتان را بدون کد زنده کنید.
🏥
پذیرشگویی خودکار + نوبتدهی با چتبات دانشمحور؛ پیامهای صوتی یادآوری نوبت با diba-tts.
چتبات نوبتدهی بساز⚖️
جستوجوی معنایی قراردادها و پروندهها با diba-embed (recipe ۲) — هر ۱ میلیون توکن سند ۵۰۰ تومان.
دستورپخت جستوجوی اسناد🛒
پشتیبانی ۲۴/۷ با ابزارپخت ۱ + ثبت خودکار فاکتورها با ابزار OCR — هر فاکتور ۸ تومان.
ابزار خواندن فاکتور