请求参数与 JSON
AdditionalParameters 与 ExtInfo 是什么?
这两个字段用于传递无法用基础请求字段表达的模型专属选项。它们不是通用别名,其位置和数据类型因 API 及模型而异。请先在对应引擎的参数表中确认它是对象还是 JSON 字符串。
JSON 对象与 JSON 字符串有什么区别?
对象以键值对结构传递,而 JSON 字符串将该结构包含在字符串内部。以下两个值的数据类型不同。如果文档要求 String,请不要直接传递对象。
json
{"options": {"enabled": true}}json
{"options": "{\"enabled\":true}"}上述 options 仅为比较数据类型所用的名称。实际请求请使用 API 中定义的字段名。
为什么示例中需要反斜杠和引号?
字符串内的引号表示为 \",反斜杠表示为 \\,换行表示为 \n。这不是注释,而是 JSON 的转义表示。使用 SDK 或 JSON 序列化函数可自动处理所需字符。请勿在已完成的请求正文中批量删除反斜杠。
JSON 中可以添加 // 注释吗?
标准 JSON 不允许 // 或 /* ... */ 注释。提交含有说明性注释的值时,请先移除注释并校验 JSON 语法。字符串中的 https:// 属于 URL 的一部分,请勿移除。
构造 JSON 字符串时需要序列化几次?
接收对象的字段请保持为对象。接收 JSON 字符串的字段,需将内部对象序列化一次转为字符串后再放入请求对象。HTTP 请求正文的序列化请交给 SDK 或 HTTP 客户端的 JSON 选项处理。若对已序列化的字符串再次序列化,会额外增加外层引号,可能导致 API 与预期结构不一致。
歌词或提示词中的换行如何传递?
在程序中请构造包含换行的字符串并使用 JSON 序列化函数。直接编写 JSON 正文时,字符串内的换行表示为 \n。对于像 AdditionalParameters 这样嵌套 JSON 字符串的字段,需要区分内部序列化与外部序列化。
选填字段应该传入空字符串还是 null?
不指定值时,请查看该字段的默认值与省略规则。省略、空字符串和 null 是三种不同的值。请勿向所有选填字段统一插入文档未允许的 null 或空值。