TokenLab
الحصول على مفتاح API
التوثيقمرجع APIالتكاملات

النص

إنشاء ترجمة

يترجم النص إلى لغة هدف

POST
/v1/translations

نظرة عامة

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

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

لـ workflows الخاصة بالوكلاء، اكتشف أولًا نماذج الترجمة الموصى بها حاليًا:

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مطلوب

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

target_languagestringمطلوب

رمز لغة الهدف أو اسمها، بحسب ما يدعمه النموذج.

source_languagestring

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

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

صيغة النص المصدر. القيم المدعومة: text/plain و text/html.

userstring

معرّف اختياري للمستخدم النهائي لأغراض مراقبة الإساءة وتتبع الطلب.

الاستجابة

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"
}

التفويض

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

تقييم القرارات

السابق

رفع ملف

التالي