API de Tarea de Traducción
Texto traducido
Traducir el texto y devolver los resultados de la traducción de forma sincronizada.
- Dirección completa
- https://shangyiai.com/api/v1/translation/translateTexts
- Autenticación
- Debe incluirse la API Key en el encabezado de solicitud Authorization
- Content-Type
- application/json
- Formato incorrecto
- { "error": "Invalid API key." }
Precauciones
Esta interfaz guarda temporalmente el texto recibido como documento JSON y lo procesa de forma síncrona, siendo adecuada para traducción instantánea de textos en pequeños lotes.
El saldo de créditos de la cuenta necesita al menos 2 credits. Si el coste real supera el saldo, la interfaz devolverá taskId y price, e informará que el saldo es insuficiente.
Ejemplo
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}'Parámetros de Solicitud
| Parámetros | Tipo | Predeterminado | Descripción | Ejemplo |
|---|---|---|---|---|
| *texts | String[] | - | Texto que requiere traducción | - |
| *fromLang | String | - |
| - |
| *toLang | String | - |
| - |
| model | String | - |
| - |
| fileDescription | String | - | Descripción del documento: mejore la calidad de la traducción proporcionando información adicional, como añadir información de contexto adicional del documento y otros requisitos de traducción, etc. | - |
Respuesta
| Parámetros | Tipo | Predeterminado | Descripción | Ejemplo |
|---|---|---|---|---|
| taskId | String | - | ID de tarea | - |
| translatedTexts | String[] | - | Texto traducido | - |
| price | Integer | - | Número total de créditos necesarios para la traducción | - |
| usedCredits | Integer | - | Número de Credits utilizados por la tarea de traducción | - |
Errores comunes
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.