راهنمای اتصال به API

API ترجمه فارسی؛ ترجمه‌ی تخصصی متن با مدل‌های Hy-MT2

اگر برنامه‌ی شما باید پیام کاربر، توضیح محصول یا متن قرارداد را ترجمه کند، لازم نیست برای این کار مدل گران چندمنظوره بگیرید. Hy-MT2 خانواده‌ی مدل‌های ترجمه‌ی تنسنت است و در وان ای آی (1ai) از همان مسیر POST /v1/chat/completions صدا زده می‌شود؛ پس هر SDK سازگار با OpenAI با عوض کردن نشانی پایه کار می‌کند. نسخه‌ی 30B برای متن تخصصی است و نسخه‌ی 7B برای متن کوتاه و روزمره. هر درخواست حداکثر ۸۱۹۲ توکن ورودی و خروجی دارد، پس متن بلند را تکه‌تکه بفرستید.

چرا با 1ai

ساخته‌شده برای ترجمه

این مدل‌ها کار دیگری نمی‌کنند: گفتگو و ابزار ندارند و همین آن‌ها را سریع و کم‌هزینه نگه می‌دارد.

همان مسیر چت

اگر برنامه‌ی شما با قالب OpenAI کار می‌کند، فقط نام مدل و نشانی پایه عوض می‌شود.

اصطلاح تخصصی

نسخه‌ی 30B برای متن حقوقی و فنی بهتر است. می‌توانید فهرست واژه‌های خودتان را هم در پیام بفرستید.

هزینه‌ی پیش‌بینی‌پذیر

هزینه به اندازه‌ی توکن‌های واقعی هر درخواست است و در هدر پاسخ می‌آید.

در چند قدم

  1. ۱

    کلید بسازید

    از بخش توسعه‌دهندگان ← کلیدها یک کلید بسازید و در ONEAI_API_KEY نگه دارید.

  2. ۲

    زبان مقصد را بگویید

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

  3. ۳

    متن بلند را تکه کنید

    متن را در مرز پاراگراف‌ها ببرید تا هر درخواست زیر سقف مدل بماند.

  4. ۴

    نمونه‌ها را بازبینی کنید

    چند نمونه از متن واقعی خودتان را بخوانید و بعد مدل مناسب را انتخاب کنید.

مدل‌های ترجمه در API

همه‌ی مدل‌ها

Hy-MT2 30B

تنسنت
گفتگو

ترجمه‌ی تخصصی با اصطلاح درست

با اشتراک
API

Hy-MT2 7B

تنسنت
گفتگو

ترجمه‌ی سریع متن کوتاه

با اشتراک
API

نمونه درخواست با curl

bash
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

سقف هر درخواست ۸۱۹۲ توکن است، ورودی و خروجی با هم. متن را پاراگراف‌به‌پاراگراف بفرستید:

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
توسعه‌دهندگان

استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL

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

۴ دقیقه مطالعه
کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه
توسعه‌دهندگان

کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه

چطور کلیدهای API را امن نگه دارید و هزینه را مهار کنید: مدل‌های مجاز، سقف اعتبار ماهانه، محدودیت نرخ، تاریخ انقضا، کلیدهای تیمی و گزارش مصرف.

۴ دقیقه مطالعه
همه‌ی امکانات

OpenAI SDK

کتابخانه‌ی رسمی openai را در Python و Node.js با تغییر آدرس پایه به 1ai وصل کنید و چت، فراخوانی ابزار، بردار متن، تصویر و صدا را از یک کلید بگیرید.

OCR API

یک PDF یا تصویر را با نشانی یا data URL بفرستید و متن هر صفحه را به صورت Markdown پس بگیرید؛ هزینه فقط به ازای صفحه‌هایی است که واقعاً خوانده شده‌اند.

API ارزان هوش مصنوعی

برای طبقه‌بندی، خلاصه‌سازی و کارهای پرحجم به مدل گران نیاز ندارید. مدل‌های این صفحه کم‌هزینه و سریع‌اند و با همان SDK کار می‌کنند.

هوش مصنوعی برای مترجمان

پیش‌ترجمه را به مدل بسپارید و وقت خود را صرف ویرایش کنید: واژه‌نامه‌ی پروژه بسازید، یکدستی اصطلاح‌ها را بسنجید، لحن را بومی کنید و متن فارسی را با نیم‌فاصله‌ی درست تحویل دهید.

API ترجمه فارسی؛ ترجمه‌ی تخصصی متن با مدل‌های Hy-MT2

متن را به مسیر چت بفرستید و ترجمه‌ی فارسی یا انگلیسی بگیرید. مدل‌های Hy-MT2 فقط برای ترجمه ساخته شده‌اند، سریع و کم‌هزینه‌اند و برای حجم بالا مناسب‌اند.

ساخت کلید API