概述
此端点主要服务于 AI Sonar 的 OpenAI 兼容 Batch API 文件对象。 当请求选择 Anthropic Files 兼容模式时，同一路由也可以返回绑定工作区的 Anthropic 风格文件元数据。 不带 Anthropic 请求头时，此路由可能返回批量文件对象，也可能返回 AI Sonar 图像/参考文件对象。注意事项
- 批处理输入文件必须使用
purpose=batch。 - 使用
purpose=batch_output以聚焦生成的输出文件。 completion_window当前为24h。- 输出顺序不保证；始终通过
custom_id匹配。 - 批处理项内不支持流式传输。
示例
请求 / 响应
使用上面的交互式OpenAPI面板获取确切的模式。操作提示
- 使用
custom_id进行幂等的下游对账。 - 仅在工作者完成批处理后，期待
output_file_id和error_file_id。 - 批处理定价可能与同步定价不同，因为适用
isBatchRequest=true的折扣规则。
响应示例
重要字段
string
供相关 API 使用的文件标识符。
string
原始或生成的文件名。
string
所属工作流使用的文件用途，例如
batch、batch_output、user_data 或 vision。