Cloud Translation aplica cuotas sobre el tamaño del contenido de las solicitudes y sobre la cantidad de solicitudes que puedes enviar. Las cuotas protegen a la comunidad de usuarios de Google Cloud mediante la prevención de aumentos repentinos inesperados del uso. También puedes disminuir las cuotas para evitar un uso excesivo y controlar los costos.
Si superas la cuota, la API de Cloud Translation muestra un error 403.
El mensaje de error indicará Daily Limit Exceeded si superas la cuota diaria o User Rate Limit Exceeded si excediste las cuotas por minuto.
Las cuotas diarias se restablecen a la medianoche (hora del Pacífico). Esto significa que las cuotas nuevas podrían tardar hasta 24 horas en entrar en vigor.
Establece cuotas de uso
De forma predeterminada, la cantidad de caracteres que puedes enviar por día es ilimitada. Si tienes un presupuesto establecido, te recomendamos supervisar el uso diario y ajustar las cuotas según el gasto planificado.
Puedes editar tus cuotas mediante la página de cuotas de Google Cloud Console. Las cuotas v2 se aplican a Cloud Translation Basic y las cuotas v3 a Cloud Translation Advanced.
Cuotas de contenido
Las cuotas de contenido se aplican a las strings de texto y los documentos que envías a la API de Cloud Translation a través de los métodos translateText, detectLanguage y translateDocument (solicitudes síncronas). Todos los caracteres que envías a la API de Cloud Translation se tienen en cuenta en estas cuotas, incluidos los caracteres de espacio en blanco. Estas cuotas son acumulables si usas Cloud Translation Basic o Cloud Translation Advanced en conjunto.
| Cuota de contenido | Predeterminada |
|---|---|
| Caracteres de modelos generales v2 y v3 por día por proyecto | Ilimitados |
| Caracteres del modelo general v2 y v3 por minuto y por proyecto | 6,000,000 de caracteres |
| Caracteres del modelo general v2 y v3 por minuto, por proyecto y por usuario* | 6,000,000 de caracteres |
| Páginas de traducción de documentos v3 por minuto por proyecto† | 2,400 páginas |
| Páginas de traducción de documentos v3 por minuto, por proyecto y por usuario† | 2,400 páginas |
* Las cuotas por usuario se aplican a la cantidad de solicitudes que un usuario final, que usa una aplicación cliente, puede realizar por minuto. Cuando usas una cuenta de servicio, la identidad de esa cuenta es el usuario a los efectos de las cuotas. Si usas Cloud Translation Basic y una clave de API, Cloud Translation usa la dirección IP del cliente para aplicar este límite.
† La cuota de la página de traducción de documentos se cuenta con respecto a la cuota de caracteres de Cloud Translation. Por ejemplo, si envías hasta 2,400 páginas por minuto, la cantidad de caracteres en los documentos tampoco puede superar los 6,000,000 de caracteres. Para los archivos XLSX, solo se aplican las cuotas de caracteres (no las cuotas de página). La traducción de documentos no es compatible con Cloud Translation Basic.
La API de Cloud Translation está optimizada para traducir solicitudes más pequeñas. La longitud máxima recomendada de cada solicitud es de 5,000 caracteres (puntos de código). Sin embargo, cuantos más caracteres incluyas, más alta será la latencia de la respuesta. En el caso de Cloud Translation Advanced, la cantidad máxima de puntos de código para una única solicitud es de 30,000. En el caso de Cloud Translation Basic, el tamaño máximo es de 100,000 bytes. Una opción alternativa es usar traducciones por lotes para enviar más contenido por solicitud como una operación de larga duración.
La API de Cloud Translation rechaza las solicitudes que superen el tamaño máximo y arroja un error 400 INVALID_ARGUMENT, sin importar la cuota disponible.
Solicita cuotas
Cloud Translation aplica una cuota sobre la cantidad de solicitudes que puedes enviar al servicio.
| Cuota | Predeterminada |
|---|---|
| Solicitudes para obtener idiomas admitidos (v2 y v3 combinados) por minuto y por proyecto | 600 solicitudes |
| Solicitudes v2 por minuto por proyecto† | 300,000 solicitudes |
| Solicitudes v2 por minuto, por proyecto y por usuario*† | hasta el límite de v2 por proyecto |
| Solicitudes v3 por minuto por proyecto† | 6,000 solicitudes |
| Solicitudes v3 por minuto, por proyecto y por usuario*† | hasta el límite de v3 por proyecto |
| Cantidad total de solicitudes de traducción por lotes v3 (texto y documentos) por día por proyecto | Ilimitada |
* Las cuotas por usuario se aplican a la cantidad de solicitudes que un usuario final, que usa una aplicación cliente, puede realizar por minuto. Cuando usas una cuenta de servicio, la identidad de esa cuenta es el usuario a los efectos de las cuotas. Si usas Cloud Translation Basic y una clave de API, Cloud Translation usa la dirección IP del cliente para aplicar este límite.
† Aplica a todas las llamadas de método de Cloud Translation, excepto los métodos translateText, detectLanguage, translateDocument y getSupportedLanguages, que tienen sus propias cuotas de solicitud o contenido.
Cuotas de AutoML
Para Cloud Translation Advanced, puedes usar modelos de AutoML para traducir contenido. Cuando usas un modelo personalizado, el uso se tiene en cuenta en un grupo de cuotas distinto. Para obtener más información sobre las cuotas de contenido y de solicitud de AutoML, consulta la documentación de AutoML Translation.
Conteo de cuotas
Para Cloud Translation Basic, las cuotas de contenido y de solicitud se tienen en cuenta en el proyecto en el que se realizan las solicitudes, que se determina en función de la clave que se usa en la solicitud.
Para Cloud Translation Advanced, las cuotas de contenido se comprueban en el proyecto asociado al modelo de la solicitud. Las cuotas de solicitud se comprueban en relación con el proyecto asociado a la solicitud.
Por ejemplo, en la siguiente solicitud de traducción de texto, las cuotas de la solicitud se comprueban en project-id-1, ya que la solicitud proviene de project-id-1. La cuota de contenido se comprueba en project-id-2, ya que la solicitud usa un modelo en ese proyecto.
POST https://translation.googleapis.com/v3/projects/project-id-1/locations/us-central1:translateText
{
"Model":"projects/project-id-2/locations/us-central1/models/model-id",
"sourceLanguageCode": "en",
"targetLanguageCode": "ru",
"contents": ["Dr. Watson, please discard your trash."]
}
Límites de Cloud Translation Advanced
En la tabla siguiente, se describen los límites de Cloud Translation Advanced, que no se pueden modificar.
| Descripción | Límite |
|---|---|
| Cantidad máxima de archivos que puedes incluir en una sola solicitud por lotes | 100 archivos |
| Cantidad máxima de recursos de glosario para un proyecto | 10,000 |