النص
إنشاء ترجمة
ترجمة النص إلى لغة وجهة
نظرة عامة
استخدم /v1/translations من أجل الترجمة من نص إلى نص.
تختلف نقطة النهاية هذه عن ترجمة الصوت، والتي تقبل ملفاً صوتياً وتُخرج دائماً نصاً باللغة الإنجليزية.
استخدم Models API للحصول على نماذج ترجمة النصوص الحالية:
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"ثم أرسل النموذج المختار صراحةً إلى /v1/translations.
ينطبق recommended_for=translation فقط على ترجمة النصوص (POST /v1/translations). ولا ينطبق على ترجمة الصوت.
جسم الطلب
معرّف نموذج الترجمة المُرجع بواسطة /v1/models?recommended_for=translation.
النص المصدر المراد ترجمته. يعتمد الحد الأقصى لطول الإدخال على النموذج؛ راجع max_input_tokens في GET /v1/models/{model}.
رمز اللغة الوجهة أو اسم اللغة، اعتماداً على دعم النموذج.
تلميح اختياري للغة المصدر.
text/plainتنسيق النص المصدر: text/plain أو text/html. أرسله فقط عندما تُدرج تفاصيل النموذج mime_type.
معرّف اختياري للمستخدم النهائي لمراقبة إساءة الاستخدام وتتبع الطلبات. أرسله فقط عندما تُدرج تفاصيل النموذج user.
الاستجابة
النص المترجم.
النموذج الذي قام بإنشاء الترجمة.
لغة المصدر التي تم اكتشافها أو قبولها بواسطة النموذج.
اللغة الوجهة المستخدمة في الطلب.
الطلب
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"
}'الاستجابة
{
"text": "Hello, welcome to TokenLab.",
"model": "doubao-seed-translation",
"source_language": "zh",
"target_language": "en"
}الأخطاء
| الحالة | الرمز | السبب |
|---|---|---|
400 | invalid_request | الحقل model أو text أو target_language مفقود أو فارغ، أو أن mime_type ليس إحدى القيمتين. يحدد param اسم الحقل |
400 | unsupported_endpoint | النموذج غير منشور لنقطة النهاية هذه |
تعامل مع الحالات الأخرى كما هو موضح في التعامل مع أخطاء API.
التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
الترويسات
سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.
القيم المتاحة
- "auto"
- "verified"
- "official"
جسم الطلب
application/json
الاستجابة
application/json
application/json
application/json
application/json
application/json
application/json