API ترجمه فارسی؛ ترجمهی تخصصی متن با مدلهای Hy-MT2
اگر برنامهی شما باید پیام کاربر، توضیح محصول یا متن قرارداد را ترجمه کند، لازم نیست برای این کار مدل گران چندمنظوره بگیرید. Hy-MT2 خانوادهی مدلهای ترجمهی تنسنت است و در وان ای آی (1ai) از همان مسیر POST /v1/chat/completions صدا زده میشود؛ پس هر SDK سازگار با OpenAI با عوض کردن نشانی پایه کار میکند. نسخهی 30B برای متن تخصصی است و نسخهی 7B برای متن کوتاه و روزمره. هر درخواست حداکثر ۸۱۹۲ توکن ورودی و خروجی دارد، پس متن بلند را تکهتکه بفرستید.
چرا با 1ai
ساختهشده برای ترجمه
این مدلها کار دیگری نمیکنند: گفتگو و ابزار ندارند و همین آنها را سریع و کمهزینه نگه میدارد.
همان مسیر چت
اگر برنامهی شما با قالب OpenAI کار میکند، فقط نام مدل و نشانی پایه عوض میشود.
اصطلاح تخصصی
نسخهی 30B برای متن حقوقی و فنی بهتر است. میتوانید فهرست واژههای خودتان را هم در پیام بفرستید.
هزینهی پیشبینیپذیر
هزینه به اندازهی توکنهای واقعی هر درخواست است و در هدر پاسخ میآید.
در چند قدم
- ۱
کلید بسازید
از بخش توسعهدهندگان ← کلیدها یک کلید بسازید و در ONEAI_API_KEY نگه دارید.
- ۲
زبان مقصد را بگویید
در پیام بنویسید به چه زبانی ترجمه شود و فقط خود متن را بفرستید.
- ۳
متن بلند را تکه کنید
متن را در مرز پاراگرافها ببرید تا هر درخواست زیر سقف مدل بماند.
- ۴
نمونهها را بازبینی کنید
چند نمونه از متن واقعی خودتان را بخوانید و بعد مدل مناسب را انتخاب کنید.
مدلهای ترجمه در API
همهی مدلهانمونه درخواست با curl
curl https://1ai.ir/v1/chat/completions \
-H "Authorization: Bearer $ONEAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tencent/hy-mt2-30b-a3b",
"messages": [
{ "role": "user", "content": "Translate into Persian: The tenant shall pay the rent on the first day of each month." }
],
"max_tokens": 1000
}'ترجمه در choices[0].message.content میآید.
ترجمهی متن بلند با Python
سقف هر درخواست ۸۱۹۲ توکن است، ورودی و خروجی با هم. متن را پاراگرافبهپاراگراف بفرستید:
from openai import OpenAI
client = OpenAI(base_url="https://1ai.ir/v1", api_key="sk-1ai-...")
def translate(paragraph):
reply = client.chat.completions.create(
model="tencent/hy-mt2-30b-a3b",
messages=[{"role": "user", "content": f"Translate into Persian:\n\n{paragraph}"}],
max_tokens=2000,
)
return reply.choices[0].message.content
result = "\n\n".join(translate(p) for p in text.split("\n\n"))30B یا 7B؟
| نیاز | انتخاب پیشنهادی |
|---|---|
| قرارداد، متن فنی، متن پزشکی | Hy-MT2 30B |
| پیام کوتاه، توضیح محصول، حجم بالا | Hy-MT2 7B |
در یک آزمون روی بند قرارداد اجاره، نسخهی 30B واژهی درست «موجر» را به کار برد و نسخهی 7B «مالک» نوشت. این یک نمونه است، نه سنجش کامل؛ پس روی متنهای خودتان هم آزمایش کنید.
محدودیتها
- این مدلها ابزار نمیپذیرند و برای گفتگو ساخته نشدهاند.
- ورودی فقط متن است؛ برای ترجمهی متن داخل عکس، اول آن را با OCR API بخوانید.
- ترجمهی ماشینی جای مترجم رسمی را نمیگیرد. متن حقوقی یا پزشکی را پیش از استفاده یک متخصص بازبینی کند.
سوالات متداول
این API از چه زبانهایی ترجمه میکند؟
ما ترجمهی فارسی و انگلیسی را آزمودهایم. سازنده آن را مدل چندزبانه معرفی میکند؛ اگر زبان دیگری لازم دارید، چند نمونه از متن خودتان را امتحان کنید.
متن بلند را چطور ترجمه کنم؟
هر درخواست حداکثر ۸۱۹۲ توکن ورودی و خروجی دارد. متن را در مرز پاراگرافها تکه کنید، هر تکه را جدا بفرستید و نتیجهها را کنار هم بگذارید.
چطور اصطلاحات یکدست بمانند؟
فهرست کوتاهی از واژهها و معادلهایشان را در ابتدای هر پیام بیاورید تا در همهی تکهها همان معادل به کار برود.
هزینه چطور حساب میشود؟
مثل بقیهی مدلهای چت، به ازای توکن ورودی و خروجی. قیمت هر مدل در جدول مدلها آمده و هزینهی هر درخواست در هدر x-1ai-credits برمیگردد.
مطالب مرتبط

استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL
چطور پروژهای را که با کتابخانهی OpenAI نوشته شده، فقط با تغییر آدرس پایه و کلید به 1ai وصل کنید؛ با نمونه کد Python، Node.js و cURL، استریم، فهرست مدلها و مدیریت خطا.

کلید API در 1ai: امنیت، محدودیتها و کنترل هزینه
چطور کلیدهای API را امن نگه دارید و هزینه را مهار کنید: مدلهای مجاز، سقف اعتبار ماهانه، محدودیت نرخ، تاریخ انقضا، کلیدهای تیمی و گزارش مصرف.
صفحههای مرتبط
همهی امکاناتOpenAI SDK
کتابخانهی رسمی openai را در Python و Node.js با تغییر آدرس پایه به 1ai وصل کنید و چت، فراخوانی ابزار، بردار متن، تصویر و صدا را از یک کلید بگیرید.
OCR API
یک PDF یا تصویر را با نشانی یا data URL بفرستید و متن هر صفحه را به صورت Markdown پس بگیرید؛ هزینه فقط به ازای صفحههایی است که واقعاً خوانده شدهاند.
API ارزان هوش مصنوعی
برای طبقهبندی، خلاصهسازی و کارهای پرحجم به مدل گران نیاز ندارید. مدلهای این صفحه کمهزینه و سریعاند و با همان SDK کار میکنند.
هوش مصنوعی برای مترجمان
پیشترجمه را به مدل بسپارید و وقت خود را صرف ویرایش کنید: واژهنامهی پروژه بسازید، یکدستی اصطلاحها را بسنجید، لحن را بومی کنید و متن فارسی را با نیمفاصلهی درست تحویل دهید.
API ترجمه فارسی؛ ترجمهی تخصصی متن با مدلهای Hy-MT2
متن را به مسیر چت بفرستید و ترجمهی فارسی یا انگلیسی بگیرید. مدلهای Hy-MT2 فقط برای ترجمه ساخته شدهاند، سریع و کمهزینهاند و برای حجم بالا مناسباند.
ساخت کلید API