使用 Responses 生成与管理结果

使用 Responses 接口生成内容。满足保存条件时,可在后续调用中查询生成结果和输入项,或按需删除已保存记录。

前提条件

查询与选择模型,确认模型支持 Responses。普通生成调用可使用具有 Genesis 权限的个人访问令牌或服务账号 API Key;保存、查询和删除结果需要个人访问令牌,且所选模型服务支持保存和取回。凭据配置参阅管理 Genesis 访问凭据

调用顺序

  1. 准备输入并创建 Response。如需后续查询,在满足条件时开启保存,并保留返回的响应标识。

  2. 读取本次生成结果。需要重新读取已保存结果时,使用创建时的个人访问令牌和响应标识查询 Response。

  3. 如需核对本次生成的输入,使用同一响应标识查询输入项;有后续页时,按动作页的分页说明继续读取。

  4. 确认不再需要保存记录时,按需删除 Response,并检查删除确认。

API 操作

要完成的事

API 操作

何时使用或确认什么

生成内容

创建 Response

按需开启保存,保留响应标识。

重新读取生成结果

查询 Response

查询仍可访问的已保存响应。

核对生成输入

查询 Response 输入项

使用同一响应标识查询和分页读取输入项。

清理保存记录

删除 Response

确认不再需要该响应后使用。

结果确认

创建后检查生成内容。开启保存时,可通过查询 Response 确认结果可取回;删除成功后,该响应不能再通过查询接口访问。

限制和注意事项

  • 保存不能与流式输出同时开启。

  • 完整内容能否取回及保留时长取决于所选模型服务。查询前确认记录未删除、未过期,并使用创建时的个人访问令牌。

  • 删除是按需清理操作,不是每次生成后的必需步骤。

最后更新于