{"record":{"id":"0d9f3325218a1014","repo":"BigPizzaV3/CodexPlusPlus","slug":"api-choices-0-message-content-chat-completions","errorCode":null,"errorMessage":"API 未返回有效的 choices[0].message.content，请确认兼容 Chat Completions","messagePattern":"API 未返回有效的 choices\\[0\\]\\.message\\.content，请确认兼容 Chat Completions","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"tools/conversation-canvas/public/canvas.user.js","lineNumber":701,"sourceCode":"      else buffer+=text;\n      if(sse){let end;while((end=buffer.indexOf('\\n'))>=0){consume(buffer.slice(0,end).replace(/\\r$/,''));buffer=buffer.slice(end+1);}}\n      progress({bytes:size,chars:content.length});if(done)break;\n    }\n    const tail=decoder.decode();if(sse){buffer+=tail;if(buffer.trim())consume(buffer.replace(/\\r$/,''));\n      if(!done&&!finish)throw Object.assign(Error('API 流式连接提前结束，本批未提交'),{canvasApiLocal:true,retryable:true});\n      return {choices:[{finish_reason:finish,message:{content}}]};\n    }\n    try{return JSON.parse(raw+tail);}catch{throw Object.assign(Error('API 返回的不是 JSON，请检查 API 地址'),{canvasApiLocal:true});}\n  }finally{void reader.cancel().catch(()=>{});try{reader.releaseLock();}catch{}}\n}\n\nfunction completionText(body){\n  const choice=body?.choices?.[0];\n  if(choice?.finish_reason==='length')throw Error('API 输出达到长度上限，本批未提交；请使用输出容量更大的模型');\n  if(choice?.finish_reason==='content_filter'||choice?.message?.refusal)throw Error('API 未能生成本批整理结果');\n  const content=choice?.message?.content;\n  const value=typeof content==='string'?content:Array.isArray(content)?content.filter(p=>p?.type==='text').map(p=>p.text||'').join(''):'';\n  if(!value.trim())throw Error('API 未返回有效的 choices[0].message.content，请确认兼容 Chat Completions');\n  return value;\n}\n\nfunction waitForApi(promise,signal){\n  signal?.throwIfAborted();\n  if(!signal)return promise;\n  return new Promise((resolve,reject)=>{\n    const abort=()=>{signal.removeEventListener('abort',abort);reject(signal.reason||new DOMException('Aborted','AbortError'));};\n    signal.addEventListener('abort',abort,{once:true});\n    promise.then(value=>{signal.removeEventListener('abort',abort);resolve(value);},error=>{signal.removeEventListener('abort',abort);reject(error);});\n  });\n}\n\nfunction createApiOrganizer({request,timeoutMs=300000,maxRetries=2,retryDelayMs=2000}){\n  const requests=new Map();\n  const closed=()=>new DOMException('整理连接已关闭','AbortError');\n  const dispose=()=>{for(const entry of requests.values())entry.controller.abort(closed());requests.clear();};\n  async function run(config,prompt,requestId,session,onSession,signal,progress=()=>{}){","sourceCodeStart":683,"sourceCodeEnd":719,"githubUrl":"https://github.com/BigPizzaV3/CodexPlusPlus/blob/b1ed92e5e4a2d74095d4b8db5af43cef7acba9c6/tools/conversation-canvas/public/canvas.user.js#L683-L719","documentation":"completionText() validates that the response contains a non-empty choices[0].message.content (string or array of text parts). If content is missing, empty, or whitespace-only, the response is not a usable Chat Completions completion and this error is thrown.","triggerScenarios":"Response body has no choices, empty choices array, message.content null/empty/whitespace, or content parts array contains no type==='text' entries.","commonSituations":"Endpoint is not actually Chat Completions compatible (e.g. Responses API or wrong path); provider returned an error-shaped body that still parsed as JSON; reasoning-only model returning no text content; wrong baseUrl hitting an HTML page that slipped past JSON check.","solutions":["Verify baseUrl points to a Chat Completions-compatible endpoint (…/v1/chat/completions)","Check the API returns standard OpenAI-style choices[0].message.content","Use a model that emits text content (not reasoning-only output)","Log the raw response body to inspect the actual shape"],"exampleFix":"// before\nbaseUrl: 'https://api.openai.com/v1/responses'\n// after\nbaseUrl: 'https://api.openai.com/v1' // + /chat/completions","handlingStrategy":"type-guard","validationCode":"const ok = b => Array.isArray(b?.choices) && b.choices.length>0 && b.choices[0]?.message && (typeof b.choices[0].message.content==='string' ? b.choices[0].message.content.trim() : Array.isArray(b.choices[0].message.content));","typeGuard":"function hasTextContent(body){const c=body?.choices?.[0]?.message?.content;if(typeof c==='string')return c.trim().length>0;if(Array.isArray(c))return c.some(p=>p?.type==='text'&&String(p.text||'').trim());return false;}","tryCatchPattern":"try{ await organizeLong(...) }catch(e){ if(e.message.includes('choices[0]')){ logRawResponse(); verifyEndpointCompatibility(); } }","preventionTips":["Confirm the endpoint is OpenAI Chat Completions compatible","Test the endpoint with a minimal curl request first","Avoid reasoning-only models that return no text content"],"tags":["api","response-validation","chat-completions"],"backgroundTag":"unexpected-api-response-shape","analyzedSha":"b1ed92e5e4a2d74095d4b8db5af43cef7acba9c6","analyzedAt":"2026-09-19T23:35:21.129Z","contentChangedAt":"2026-09-19T23:35:21.129Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}