API de tâche de traduction
Texte traduit
Traduire le texte et renvoyer simultanément les résultats de traduction.
- Adresse complète
- https://otranslator.com/api/v1/translation/translateTexts
- Authentification
- Il est nécessaire de transmettre la clé API dans l'en-tête de requête Authorization
- Content-Type
- application/json
- Format erroné
- { "error": "Invalid API key." }
Points à noter
Cette interface sauvegarde temporairement le texte transmis sous forme de document JSON et le traite de manière synchrone, adaptée à la traduction instantanée de petits volumes de texte.
Le solde de crédits du compte doit être d'au moins 2 credits. Si le coût réel dépasse le solde, l'interface retournera taskId et price, et signalera un solde insuffisant.
Exemple
1curl -X POST 'https://otranslator.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}'Paramètres de requête
| Paramètres | Type | Par défaut | Description | Exemple |
|---|---|---|---|---|
| *texts | String[] | - | Texte à traduire | - |
| *fromLang | String | - |
| - |
| *toLang | String | - |
| - |
| model | String | - |
| - |
| fileDescription | String | - | Description du document : améliorer la qualité de la traduction en fournissant des informations supplémentaires, par exemple en ajoutant des informations contextuelles supplémentaires sur le document et d'autres exigences de traduction, etc. | - |
Réponse
| Paramètres | Type | Par défaut | Description | Exemple |
|---|---|---|---|---|
| taskId | String | - | ID de tâche | - |
| translatedTexts | String[] | - | Texte traduit | - |
| price | Integer | - | Nombre total de crédits requis pour la traduction | - |
| usedCredits | Integer | - | Nombre de crédits utilisés par la tâche de traduction | - |
Erreurs courantes
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.