תוכן המסמך

API משימות תרגום

תרגום טקסט

POST/v1/translation/translateTexts

תרגם טקסט והחזר את תוצאות התרגום בו-זמנית.

כתובת מלאה
https://shangyiai.com/api/v1/translation/translateTexts
אימות
יש להעביר את ה-API Key בכותרת הבקשה Authorization
Content-Type
application/json
פורמט שגוי
{ "error": "Invalid API key." }

נקודות לתשומת לב

ממשק זה שומר זמנית את הטקסט המועבר כמסמך JSON ומעבד אותו באופן סינכרוני, מתאים לתרגום מיידי של טקסטים בכמויות קטנות.

נדרשת יתרת נקודות זכות של לפחות 2 credits בחשבון. אם העלות בפועל תעלה על היתרה, הממשק יחזיר taskId ו-price ויודיע על יתרה לא מספקת.

דוגמה

curl
1curl -X POST 'https://shangyiai.com/api/v1/translation/translateTexts' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5  "texts": [
6    "string"
7  ],
8  "fromLang": "[string]",
9  "toLang": "[string]"
10}'

פרמטרי בקשה

פרמטריםסוגברירת מחדלתיאורדוגמה
*textsString[]-

הטקסט הדורש תרגום

-
*fromLangString-
  • שפת המקור, שפת המקור אינה יכולה להיות זהה לשפת היעד
  • שפות נתמכות: שאילתה
-
*toLangString-
  • שפת יעד, שפת היעד אינה יכולה להיות זהה לשפת המקור
  • שפות נתמכות: שאילתה
-
modelString-
  • מודל AI לתרגום
  • מודלים נתמכים: שאילתה
-
fileDescriptionString-

תיאור המסמך, שיפור איכות התרגום באמצעות מתן מידע נוסף, למשל הוספת מידע רקע על המסמך ודרישות תרגום נוספות

-

תגובה

פרמטריםסוגברירת מחדלתיאורדוגמה
taskIdString-

מזהה משימה

-
translatedTextsString[]-

הטקסט המתורגם

-
priceInteger-

מספר הקרדיטים הנדרש לתרגום המלא

-
usedCreditsInteger-

מספר ה-Credits שנוצלו במשימת התרגום

-

שגיאות נפוצות

401 Missing API key.

The Authorization request header is required.

401 Invalid API key.

The API key does not exist, has been deleted, or is no longer valid.

402 Insufficient credits balance.

The account does not have enough credits to translate the texts.

400 Missing required parameter: fromLang.

Provide fromLang using a language returned by /api/v1/languages.

400 Missing required parameter: toLang.

Provide toLang using a language returned by /api/v1/languages.

400 Missing required parameter: texts.

Provide a non-empty texts array.

400 Failed to translate texts.

The text translation task could not be processed.