Niveles de modelos

Algunos modelos se ofrecen en más de un nivel. Un nivel es el mismo modelo vendido a un precio diferente, por ejemplo un nivel de menor costo junto a uno Predeterminado. Una clave API accede a todos los niveles; eliges un nivel por el nombre del modelo, no por una clave o parámetro separado.

Nivel Predeterminado

El nombre de modelo simple siempre usa el nivel Predeterminado. Las solicitudes existentes siguen funcionando sin cambios cuando un modelo gana otro nivel.

{ "model": "gpt-image-2" }

Elegir un nivel

Añade dos puntos y el ID del nivel al nombre del modelo:

{ "model": "gpt-image-2:<tier>" }

Esto funciona para modelos de texto, imagen, video y audio, dondequiera que la solicitud nombre un modelo: el campo model de un cuerpo JSON, el campo de formulario model de una carga de audio, y el segmento de modelo de una ruta nativa Gemini. En una ruta Gemini la acción queda al final:

POST /v1beta/models/<model>:<tier>:generateContent

Encuentra los niveles de un modelo

• En cada página de modelo, un selector de nivel aparece sobre la tabla de precios y muestra los precios de cada nivel y el ID del modelo a llamar. Las páginas con un único precio muestran los niveles en la tabla Niveles de precio en su lugar. Ambos aparecen solo cuando el modelo tiene más de un nivel.
• La guía Markdown /models/<page>/llms.txt de cada modelo lista los precios completos de todos los niveles.
• GET /v1/models lista <model>:<tier> junto a <model> para cada modelo que tu clave pueda llamar en más de un nivel.

En el Playground de los modelos de texto, el selector de nivel cambia entre los mismos niveles. El Playground de los modelos de imagen, vídeo y audio usa el nivel Predeterminado; llama a los demás niveles a través de la API.

Facturación y comportamiento

• Una solicitud de nivel se ejecuta solo en ese nivel y se factura al precio de ese nivel.
• Si el nivel no puede servir la solicitud, la solicitud falla. Nunca cambia a otro nivel, por lo que nunca se factura a un precio diferente.
• Las respuestas y resultados de tareas informan el nombre de modelo simple.
• Una clave creada para un solo nivel puede llamar a ese nivel y ningún otro.

Errores

Consulta Errores para ver la forma de la respuesta.