API de tâche de traduction
Consulter les tâches de traduction
Consulter le statut et les détails d'une tâche de traduction.
- Adresse complète
- https://otranslator.com/api/v1/translation/query
- 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
Il est recommandé d'effectuer un polling de cette interface lorsque le statut de la tâche est Waiting ou Processing, et d'arrêter le polling une fois que le statut passe à Completed, Terminated ou Cancelled.
Le lien de téléchargement est une adresse d'accès temporaire, veuillez sauvegarder le fichier selon vos besoins ou relancer une requête pour l'obtenir.
Exemple
1curl -X POST 'https://otranslator.com/api/v1/translation/query' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'Paramètres de requête
| Paramètres | Type | Par défaut | Description | Exemple |
|---|---|---|---|---|
| *taskId | String | - | ID de la tâche de traduction | - |
Réponse
| Paramètres | Type | Par défaut | Description | Exemple |
|---|---|---|---|---|
| taskId | String | - | ID de tâche | - |
| model | String | - | Modèle utilisé pour la traduction | - |
| fromLang | String | - | Langue source | - |
| toLang | String | - | Langue cible | - |
| status | String | - | Statut : 'Init' | 'En attente' | 'En cours' | 'Terminé' | 'Interrompu' | 'Annulé' | - |
| progress | Number | - | Progression, 0~100 | - |
| errorMsg | String | - | Message d'erreur | - |
| fileTitle | String | - | Nom du fichier original | - |
| fileUrl | String | - | Adresse de téléchargement du fichier original | - |
| translatedFileUrl | String | - | Adresse de téléchargement de la traduction | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Adresse de téléchargement du fichier de traduction éditable. Renvoyée uniquement lorsqu'un résultat éditable est généré pour le type de fichier correspondant. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Nombre de mots du document. Peut être vide pour certains types de fichiers. | - |
| 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 | - |
| glossary | String[] | - | Nom du glossaire utilisé par la tâche de traduction | - |
| shouldTranslateImage | Boolean | - | Traduire les images du document | - |
| forceOCR | Boolean | - | Forcer l'utilisation de l'OCR pour reconnaître le contenu du document | - |
| createdAt | DateTime | - | Heure de création de la tâche de traduction | - |
| updatedAt | DateTime | - | Heure de mise à jour de 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.
400 Missing required parameter: taskId.
Provide the taskId returned by the create translation task API.
404 Task not found.
The task does not exist, has been deleted, does not belong to the current API account, or was not created through the API.