Cuotas y límites

En este documento se detallan las restricciones y las cuotas de uso vigentes de la API Cloud Translation. Esta página se actualizará para reflejar cualquier cambio en dichas restricciones y cuotas de uso.

Estas cuotas se aplican a todos los usuarios y proyectos de desarrollo de la API Cloud Translation. Además, se comparten entre todas las aplicaciones y versiones de API que se utilicen en cada uno de esos proyectos.

Puedes aumentar tus cuotas hasta sus valores máximos a través de la consola de Google Cloud. Si quieres pedir un aumento de la cuota por encima del valor máximo, envía una solicitud a través de la consola de Google Cloud.

Cuotas de contenido

El contenido de la API Cloud Translation se proporciona en forma de cadenas de texto, y tanto el precio como el uso se basan en el recuento de caracteres. Para calcular las cuotas, se cuentan todos los caracteres que se envían a la API Cloud Translation, incluidos los espacios.

La API Cloud Translation se ha optimizado para traducir solicitudes cortas; en concreto, la longitud máxima recomendada para cada solicitud es de 2000 puntos de código. Por este motivo, las solicitudes muy grandes se rechazan, independientemente de la cuota que tengas. Si esto ocurre, se muestra un error 400 INVALID_ARGUMENT.

La cuota basada en caracteres se aplica a los métodos translateText y detectLanguage. El límite estricto para las solicitudes es de 30.000 caracteres Unicode (puntos de código).

Cuota de contenido Límite predeterminado Duración A qué se aplica
Caracteres de las versiones 2 y 3 (beta) del modelo general por día Ilimitado 1 día Proyecto
Caracteres de las versiones 2 y 3 (beta) del modelo general por minuto y proyecto 6.000.000 de caracteres 60 segundos Proyecto
Caracteres de las versiones 2 y 3 (beta) del modelo general por minuto, proyecto y usuario 6.000.000 de caracteres 60 segundos Proyecto y usuario

El límite de cuotas por usuario es el número de solicitudes que un usuario final puede enviar con una aplicación cliente por minuto. Si usas una cuenta de servicio, su identidad actúa como usuario en lo que respecta a la cuota. En el caso de las solicitudes que se envían mediante una clave de API, la API Cloud Translation utiliza la dirección IP del cliente para aplicar este límite.

Si superas tu cuota, la API Cloud Translation devuelve un error 403. En el caso de que hayas excedido el límite diario, el error será Daily Limit Exceeded. Si has superado alguna de las cuotas por minuto, el error será User Rate Limit Exceeded.

Las cuotas diarias se reinician a medianoche (UTC -8:00 o UTC -7:00, según la época del año), por lo que las nuevas cuotas pueden tardar hasta 24 horas en aplicarse.

Si quieres ver o cambiar los límites de uso de tu proyecto o pedir un aumento de la cuota, debes hacer lo siguiente:

  1. Si todavía no tienes ninguna cuenta de facturación para tu proyecto, crea una.
  2. Visita la página sobre APIs habilitadas de la biblioteca de APIs en la consola de Cloud y selecciona una de la lista.
  3. Si quieres ver y cambiar la configuración de la cuota, selecciona la opción Cuotas. Si quieres ver las estadísticas de uso, selecciona la opción Uso.

Cuotas de solicitudes

Además de las cuotas de contenido mencionadas arriba, Cloud Translation aplica cuotas de uso de la API.

Descubrir las solicitudes de idiomas admitidos

En las ediciones básica y avanzada de Cloud Translation, se limita la frecuencia con que puedes solicitar la traducción de la lista de idiomas admitidos. Esta cuota no se aplica a los textos que se envíen para traducirse, sino únicamente a las solicitudes de la lista de idiomas admitidos.

Cuota Límite predeterminado Duración A qué se aplica
Solicitudes de las versiones 2 y 3 (beta) de la lista de idiomas admitidos 600 solicitudes 60 segundos Proyecto

Edición avanzada

En la API Cloud Translation, puedes hacer un número de solicitudes limitado. La cuota se aplica a todas las llamadas de Cloud Translation, salvo aquellas realizadas a los métodos translateText, detectLanguage y getSupportedLanguages.

  • translateText se corresponde con los caracteres del modelo general de los modelos generales (consúltalo más arriba) y, en el caso de los modelos personalizados de AutoML, con los caracteres de los modelos de AutoML por minuto.

  • detectLanguage está sujeto a las cuotas de los caracteres del modelo general (consúltalo más arriba).

  • getSupportedLanguages está sujeto a las cuotas de las solicitudes de la lista de idiomas admitidos (consúltalo más arriba).

batchTranslationText se corresponde con los caracteres de traducción por lotes que usan modelos generales por proyecto de los modelos generales y, en el caso de los modelos personalizados de AutoML (consúltalo más abajo), con los caracteres de traducción por lotes que usan modelos personalizados de AutoML por proyecto. De forma predeterminada, estas dos cuotas son ilimitadas y se reinician a medianoche (UTC -8:00 o UTC -7:00, según la época del año).

Esta cuota no se aplica a las solicitudes enviadas a la edición básica de Cloud Translation.

Acción Cuota predeterminada Duración A qué se aplica
Solicitudes predeterminadas de la versión 3 por proyecto 6000 60 segundos Proyecto
Solicitudes predeterminadas de la versión 3 por proyecto y usuario Ilimitada 60 segundos Proyecto y usuario
Caracteres de los modelos de AutoML por proyecto 100.000 60 segundos Proyecto
Caracteres de los modelos de AutoML por proyecto y usuario Ilimitada 60 segundos Proyecto y usuario
Caracteres de traducción por lotes que usan modelos generales por proyecto Ilimitada 1 día Proyecto
Caracteres de traducción por lotes que usan modelos personalizados de AutoML por proyecto Ilimitada 1 día Proyecto

Modelos (solo en la edición avanzada)

Cuando se usa un modelo general o personalizado, se aplican las cuotas de contenido según el ID del proyecto que tenga asociado. Las cuotas de solicitudes se aplican según el proyecto asociado a la solicitud.

Por ejemplo, echa un vistazo a la siguiente solicitud de traducción de texto:

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."]
}

Las cuotas de solicitudes se aplican según project-id-1 y la cuota de contenido, según project-id-2.