問題排查
流式響應與非同步任務
面向 NeonAPI 使用者的實際操作指南。
讀取流式響應
對支援的文字介面設定 stream: true，可接收事件而不是單個完整 JSON。Chat Completions、Responses、Anthropic 和 Gemini 的事件格式不同，應使用匹配的 SDK 或解析器。
保留未讀完整的緩衝內容。網路分片邊界不一定是事件邊界，也不一定是 UTF-8 字元邊界。明確處理結束、取消和錯誤事件。
非同步影像與影片任務
部分模型先返回任務 ID。儲存該 ID，以合理間隔查詢對應介面，在任務完成後讀取結果。不要為了檢視進度而重新建立一個任務。
下載與有效期
結果地址可能過期或需要認證。按介面要求攜帶允許的憑據下載，不要把臨時結果地址當作永久檔案儲存。
斷開連線與重試
客戶端超時或斷開連線，不一定取消已經被上游接受的任務。再次提交前先檢視任務狀態或使用日誌，避免重複生成與重複費用。