一、核心基础类型(AI接口高频使用)
1. application/json(最主流)
- 解析:JSON格式是AI接口默认首选,文本轻量、结构化强,支持字符串、数组、对象等复杂数据,可直接被前后端解析。
- 应用场景:90%+ AI交互场景,包括单次问答、文本生成、多轮对话、数据查询(如返回结果、状态、错误信息),适配OpenAI、百度文心、阿里通义等所有主流大模型API。
2. application/json;version=xxx(带版本号)
- 解析:在基础JSON格式上添加版本参数,确保接口迭代后响应结构兼容(版本号由接口文档定义,如v1、1.0)。
- 应用场景:企业级AI接口、有版本迭代的API(如政务AI服务、第三方付费AI接口),避免因接口更新导致数据解析失败。
二、流式响应专用类型(实时输出场景)
1. application/x-ndjson(Newline-Delimited JSON)
- 解析:换行分隔的JSON格式,每条数据独立成行,无需等待完整响应,支持逐段解析,降低延迟。
- 应用场景:AI流式输出(如逐字生成文章、代码)、实时日志推送、批量数据分段返回(如多轮对话上下文增量传输)。
2. text/event-stream(SSE协议专用)
- 解析:基于Server-Sent Events协议的文本流格式,以
data: 开头分隔消息,支持服务器单向持续推送数据,无需客户端反复请求。 - 应用场景:浏览器端实时AI交互(如网页版AI聊天框)、实时翻译、语音转文字实时反馈、金融AI实时行情推送。
三、二进制/文件类类型(生成文件/多媒体场景)
1. 图片类
- 类型:image/png、image/jpeg、image/webp、image/svg+xml
- 解析:指定返回图片的格式,支持无损(PNG)、有损压缩(JPEG)、高效格式(WebP)、矢量图(SVG)。
- 应用场景:AI图像生成(如Midjourney API、Stable Diffusion接口)、OCR识别后返回截图、AI图标生成。
2. 文档类
- 类型:application/pdf、application/msword(Word)、application/vnd.openxmlformats-officedocument.wordprocessingml.document(docx)、application/vnd.openxmlformats-officedocument.spreadsheetml.sheet(Excel)
- 解析:指定返回办公文档格式,支持二进制文件流传输。
- 应用场景:AI生成报告(如数据分析报告、会议纪要导出)、AI处理文档后返回编辑后的文件(如PDF批注、Excel数据填充)。
3. 音频类
- 类型:audio/mpeg(MP3)、audio/wav、audio/ogg
- 解析:指定返回音频格式,适配不同播放场景(MP3兼容性强,WAV无损,OGG体积小)。
- 应用场景:AI语音合成(如文字转语音API)、语音交互后返回处理后的音频(如AI降噪后的录音)。
四、通用/兼容类类型(兜底/多格式适配)
1. /(通配符)
- 解析:表示接受服务器支持的任意格式,优先级最低,仅作为兜底选项。
- 应用场景:不确定接口支持格式时的测试场景、简单demo开发(正式环境不推荐,可能返回不可解析格式)。
2. application/*(应用层通配符)
- 解析:接受所有应用层格式(如JSON、PDF、Word等),排除多媒体格式(图片、音频)。
- 应用场景:仅需获取结构化数据或文档,无需多媒体响应的场景(如AI数据统计接口)。
3. text/plain(纯文本)
- 解析:返回无格式纯文本,不含JSON结构,仅传递原始字符串。
- 应用场景:简单AI响应(如yes/no判断、短文本回复)、命令行工具调用AI接口(无需复杂解析)。
五、特殊自定义类型(企业级/专属接口)
- 类型:application/vnd.xxx+json(xxx为接口方自定义标识,如application/vnd.ai-lab.v2+json)
- 解析:企业或平台自定义的MIME类型,通常基于JSON扩展,包含专属字段或加密格式。
- 应用场景:专属AI服务(如银行AI风控接口、医疗AI诊断接口)、需要权限校验的定制化AI接口。
六、优先级配置格式(多格式兼容)
- 格式:
Accept: 类型1;q=优先级, 类型2;q=优先级(q值0-1,1为最高,默认0.5) - 示例:
Accept: application/json;q=1.0, application/x-ndjson;q=0.8, */*;q=0.5 - 解析:指定多个可接受格式及优先级,服务器优先返回高q值格式。
- 应用场景:需兼容常规响应与流式响应的场景(如AI聊天工具,优先完整JSON,备选流式输出)。