For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegación principal
Theme

Procesamiento flexible

Optimiza los costos con el procesamiento flexible.

El procesamiento flexible reduce el costo de las solicitudes a Responses o Chat Completions a cambio de tiempos de respuesta más largos y de que, en ocasiones, no haya recursos disponibles. Es ideal para tareas que se ejecutan fuera de producción o que tienen menor prioridad, como la evaluación de modelos, el enriquecimiento de datos y las cargas de trabajo asíncronas.

El precio de los tokens se calcula según las tarifas de la API Batch, con descuentos adicionales por el almacenamiento en caché de prompts.

El procesamiento flexible está en fase beta y solo está disponible para algunos modelos. Consulta la lista de modelos compatibles en la página de precios.

Uso de la API

Para usar el procesamiento flexible, establece el parámetro service_tier en flex en tu solicitud a la API.

Ejemplo de procesamiento flexible
from openai import OpenAI

client = OpenAI(
    # increase default timeout to 15 minutes (from 10 minutes)
    timeout=900.0
)

# you can override the max timeout per request as well
response = client.with_options(timeout=900.0).responses.create(
    model="gpt-6-astra",
    instructions="List and describe all the metaphors used in this book.",
    input="<very long text of book here>",
    service_tier="flex",
)

print(response.output_text)

Tiempos de espera de las solicitudes a la API

Como el procesamiento flexible tarda más, es más probable que se agote el tiempo de espera de una solicitud. Ten en cuenta lo siguiente al gestionar los tiempos de espera.

  • Tiempo de espera predeterminado. Al hacer solicitudes a la API con un SDK oficial de OpenAI, el tiempo de espera predeterminado es de 10 minutos. Es posible que debas aumentarlo si usas prompts largos o realizas tareas complejas.
  • Configuración del tiempo de espera. Cada SDK ofrece un parámetro para aumentar el tiempo de espera. En los SDK de Python y JavaScript, el parámetro es timeout, como se muestra en los ejemplos de código anteriores.
  • Reintentos automáticos. Si una solicitud devuelve el código de error 408 Request Timeout, los SDK de OpenAI la reintentan automáticamente dos veces antes de lanzar una excepción.

Errores por falta de recursos disponibles

En ocasiones, el procesamiento flexible puede no tener recursos suficientes para atender tus solicitudes. En ese caso, la API devuelve el código de error 429 Resource Unavailable. No se te cobrará por la solicitud si esto ocurre.

Considera estas estrategias para gestionar los errores por falta de recursos disponibles.

  • Reintenta las solicitudes con intervalos de espera que aumenten exponencialmente. Esta estrategia es adecuada para cargas de trabajo que toleran demoras y ayuda a minimizar los costos, ya que la solicitud puede completarse cuando haya más capacidad disponible. Para saber cómo implementarla, consulta este ejemplo del Cookbook.

  • Reintenta las solicitudes con el procesamiento estándar. Si recibes un error por falta de recursos disponibles y en tu caso de uso vale la pena asumir un costo mayor de vez en cuando para asegurar que la solicitud se complete, reinténtala con el procesamiento estándar. Para hacerlo, establece service_tier en auto al reenviar la solicitud o elimina el parámetro service_tier para usar el modo predeterminado del proyecto.