openaienmodel: gpt-5-mini-2025-08-07
Vectorize - Return up to 50 query results with values or metadata
Key Points
- topK increased from 20 to 50 for value/metadata queries
- Applies when returnValues:true or returnMetadata:"all"
- Test impact on response size and latency
Summary
The Vectorize API now supports returning up to 50 results (topK = 50) when a query requests item values or full metadata. This raises the previous limit of 20 for queries that set returnValues: true or returnMetadata: "all". Use the higher topK when you need more matches in a single response without stripping values or metadata.
Key Points
- Change:
topKlimit increased from 20 to 50 for queries that return values or full metadata. - Applies when using
returnValues: trueorreturnMetadata: "all"in your Vectorize query options. - Practical impact: fewer follow-up queries to retrieve more matches with their values/metadata.
- Considerations: larger
topKmay increase response size, latency, and bandwidth—test for your workload. - Action: update client requests if you need more than 20 results and consult the Vectorize API reference for current limits and options.