Skip to main content
POST
Subir Archivo
Máximo de 32 MB por archivo en este endpoint. Esta llamada single-shot POST /files envía el cuerpo del archivo a través del servidor de la API, que tiene un límite estricto de 32 MB en el tamaño del cuerpo de las solicitudes HTTP entrantes. Los archivos mayores a 32 MB son rechazados antes de llegar a la capa de la aplicación.Para archivos mayores a 32 MB, utilice el flujo de carga firmada v2. Sube el cuerpo del archivo directamente desde su cliente a Google Cloud Storage (el servidor de la API queda fuera de la ruta de los bytes) y admite archivos de hasta 200 MB.

Archivos soportados

Límites

  • Tamaño máximo de archivo por carga en este endpoint: 32 MB (límite de tamaño de solicitud HTTP de la plataforma). Para archivos de hasta 200 MB, utilice el flujo de carga firmada v2.
  • Este punto final acepta un archivo por solicitud (se pueden usar varias solicitudes para varios archivos).
  • Límite de almacenamiento de archivos: 30 archivos
  • Algunas funciones tienen límites diferentes:
    • Adjuntos de chat: hasta 200 MB por archivo a través del flujo de carga firmada v2; hasta 5 archivos por envío
    • Transcripción de audio: hasta 10 MB por archivo

Ejemplos de Código

Encabezados

integer
requerido
ID del workspace. Obligatorio a partir del 01/09/2026. Hasta entonces, si se omite, se usa el workspace seleccionado del usuario (deprecated). Después de la fecha, ausencia → 422.
Nota: Este campo será requerido en una futura versión de la API. Se recomienda encarecidamente configurarlo ahora para asegurar la compatibilidad con futuras actualizaciones.

Parámetros del Cuerpo

El playground no soporta uploads multipart/form-data directamente. Use los Ejemplos de Código anteriores (cURL, Python, Node.js, etc.) para enviar el archivo. Los campos a continuación se muestran solo con fines de documentación.
file
requerido
El archivo a subir (multipart/form-data)
boolean
Si debe procesar el archivo después de subirlo (predeterminado: false). El procesamiento consume créditos (true).

Respuesta