问题排查
流式响应与异步任务
面向 NeonAPI 使用者的实际操作指南。
读取流式响应
对支持的文本接口设置 stream: true，可接收事件而不是单个完整 JSON。Chat Completions、Responses、Anthropic 和 Gemini 的事件格式不同，应使用匹配的 SDK 或解析器。
保留未读完整的缓冲内容。网络分片边界不一定是事件边界，也不一定是 UTF-8 字符边界。明确处理结束、取消和错误事件。
异步图像与视频任务
部分模型先返回任务 ID。保存该 ID，以合理间隔查询对应接口，在任务完成后读取结果。不要为了查看进度而重新创建一个任务。
下载与有效期
结果地址可能过期或需要认证。按接口要求携带允许的凭据下载，不要把临时结果地址当作永久文件存储。
断开连接与重试
客户端超时或断开连接，不一定取消已经被上游接受的任务。再次提交前先查看任务状态或使用日志，避免重复生成与重复费用。