النص

إنشاء ترجمة

ترجمة النص إلى لغة وجهة

POST
/v1/translations

نظرة عامة

استخدم /v1/translations من أجل الترجمة من نص إلى نص.

تختلف نقطة النهاية هذه عن ترجمة الصوت، والتي تقبل ملفاً صوتياً وتُخرج دائماً نصاً باللغة الإنجليزية.

استخدم Models API للحصول على نماذج ترجمة النصوص الحالية:

curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"

ثم أرسل النموذج المختار صراحةً إلى /v1/translations.

ينطبق recommended_for=translation فقط على ترجمة النصوص (POST /v1/translations). ولا ينطبق على ترجمة الصوت.

جسم الطلب

modelstringمطلوب

معرّف نموذج الترجمة المُرجع بواسطة /v1/models?recommended_for=translation.

textstringمطلوب

النص المصدر المراد ترجمته. يعتمد الحد الأقصى لطول الإدخال على النموذج؛ راجع max_input_tokens في GET /v1/models/{model}.

target_languagestringمطلوب

رمز اللغة الوجهة أو اسم اللغة، اعتماداً على دعم النموذج.

source_languagestring

تلميح اختياري للغة المصدر.

mime_typestringالافتراضي: text/plain

تنسيق النص المصدر: text/plain أو text/html. أرسله فقط عندما تُدرج تفاصيل النموذج mime_type.

userstring

معرّف اختياري للمستخدم النهائي لمراقبة إساءة الاستخدام وتتبع الطلبات. أرسله فقط عندما تُدرج تفاصيل النموذج user.

الاستجابة

textstring

النص المترجم.

modelstring

النموذج الذي قام بإنشاء الترجمة.

source_languagestring | null

لغة المصدر التي تم اكتشافها أو قبولها بواسطة النموذج.

target_languagestring

اللغة الوجهة المستخدمة في الطلب.

الطلب

curl -X POST "https://api.tokenlab.sh/v1/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-translation",
    "text": "你好,欢迎使用 TokenLab。",
    "target_language": "en"
  }'

الاستجابة

Response
{
  "text": "Hello, welcome to TokenLab.",
  "model": "doubao-seed-translation",
  "source_language": "zh",
  "target_language": "en"
}

الأخطاء

الحالةالرمزالسبب
400invalid_requestالحقل model أو text أو target_language مفقود أو فارغ، أو أن mime_type ليس إحدى القيمتين. يحدد param اسم الحقل
400unsupported_endpointالنموذج غير منشور لنقطة النهاية هذه

تعامل مع الحالات الأخرى كما هو موضح في التعامل مع أخطاء API.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

الترويسات

X-TokenLab-Delivery-Policy?string

سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.

القيم المتاحة

  • "auto"
  • "verified"
  • "official"

جسم الطلب

application/json

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json