写作API使用前：核对输入、响应与异常处理条件

调用写作API前，先确认说明对应哪项服务、哪类接口，以及请求和响应采用什么格式。记下必填字段、字段类型、文本编码、身份验证方式和错误返回结构。示例值不一定是正式参数；文档没有说明的行为，应标为待确认，不要自行推断。 接着核对输入限制和输出约定。文档若提到内容长度、可选字段、返回文本的位置或结构化结果要求，应记下适用范围和单位，并确认这些规定针对当前接口。不

调用写作API前，先确认说明对应哪项服务、哪类接口，以及请求和响应采用什么格式。记下必填字段、字段类型、文本编码、身份验证方式和错误返回结构。示例值不一定是正式参数；文档没有说明的行为，应标为待确认，不要自行推断。

接着核对输入限制和输出约定。文档若提到内容长度、可选字段、返回文本的位置或结构化结果要求，应记下适用范围和单位，并确认这些规定针对当前接口。不同工具的参数名称和限制可能不同，不能把一份说明套用到其他模型或服务。模型输出不等于事实核验，发布前仍要检查事实、表达和敏感信息。

请求失败时，区分身份验证失败、参数不符合要求、服务端错误和网络超时，并记录文档提供的错误信息与排查方向。超时只说明调用方没有及时收到响应，不能据此断定请求未处理或未计费。先核对已有响应、请求记录或服务端任务状态，再决定是否重试，以免重复生成或重复入库。

如果自有系统会保存结果，可以为每项任务记录内部编号和内容摘要，用来识别相同任务、核对处理状态。这是系统设计办法，不是所有API都提供的通用功能。重试规则应结合服务说明和业务需要设定，不能因为一次网络异常就无限重复请求。

最后检查密钥和日志处理。密钥只保存在服务端或受保护的本机配置中，不要写入网页、公开正文或日志。请求日志只保留排查所需信息，避免记录不必要的敏感内容。上线前用非敏感文本验证请求格式、响应解析和异常处理。文档未说明的价格、额度或版本参数，应查阅对应服务的正式说明，不要自行补写。