需通过五种官方方式集成豆包ai：一、web sdk嵌入对话窗口；二、前端直连rest api；三、反向代理规避cors；四、插件manifest实现网页增强；五、配置csp等安全策略。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在自有网站中直接调用豆包AI能力，例如提供对话窗口、内容摘要或智能问答功能，则需通过官方支持的嵌入方式实现前端集成。以下是完成该集成任务的具体操作路径：
一、使用豆包AI官方Web SDK嵌入对话窗口
该方式适用于希望快速部署轻量级AI交互界面的网站，无需后端代理，由SDK自动处理身份鉴权与消息路由，支持自定义样式与初始提示语。
1、登录豆包AI开放平台，在「应用管理」中创建新应用，获取App ID与App Secret。
2、进入「Web SDK配置」页面，填写您的网站域名（须为HTTPS协议），启用「Web嵌入」权限并保存。
3、复制生成的SDK初始化代码片段，将其插入网站HTML文件的
标签内或页面底部前。4、在需要显示AI窗口的位置添加容器元素：<div id="doubao-web-widget"></div>，并确保ID值与SDK配置中指定的一致。
5、调用window.DoubaoWidget.init()方法启动组件，可传入{ theme: "dark", placeholder: "向AI助手提问..." }等配置项。
二、通过前端直连REST API构建自定义AI界面
该方式适用于已有UI框架或需深度控制请求逻辑的场景，前端直接发起HTTPS请求至豆包AI接口，需自行管理Token有效期与错误响应。
1、在服务端部署Token获取接口，使用App ID与App Secret向https://api.doubao.com/oauth/token申请短期Access Token。
2、将Token通过安全方式（如JWT签名接口）下发至前端，禁止在客户端硬编码App Secret。
3、前端使用fetch构造POST请求，目标URL为https://api.doubao.com/v1/chat/completions，请求头包含Authorization: Bearer {token}与Content-Type: application/json。
4、请求体中以JSON格式提交messages数组，其中首条消息role设为system并填入角色设定，后续消息按用户与AI交替排列。
5、解析响应时提取choices[0].message.content字段，并将结果渲染至页面对话区域；若返回401错误，触发前端Token刷新流程。
三、部署反向代理服务规避CORS限制
该方式用于解决浏览器同源策略导致的跨域请求被拦截问题，通过Nginx或Node.js中间层统一转发请求，隐藏真实API地址并复用服务端凭证。
1、在网站同域服务器上配置反向代理路径，例如将/api/doubao/chat映射至豆包AI官方接口地址。
2、代理服务在转发请求时自动注入Authorization头，其值由服务端缓存的Access Token生成，避免前端暴露凭证。
使用豆包（火山引擎 Ark）生成图片或视频并保存本地。用户提及“豆包生图/图片/生视频/视频”、“Doubao”、“Seedance”、“火山引擎图片/视频”时触发。
3、前端仅向自身域名下的代理路径发起请求，例如POST /api/doubao/chat，请求体与官方API格式完全一致。
4、代理层接收豆包AI响应后，原样透传至前端，仅添加Access-Control-Allow-Origin响应头以允许指定前端域名访问。
5、在Nginx配置中启用proxy_buffering off与chunked_transfer_encoding on，确保流式响应（stream=true）可逐块传递至浏览器。
四、集成豆包AI插件Manifest实现网页增强功能
该方式适用于需在特定网页上下文中触发AI操作的场景，例如选中文本后一键总结、右键分析当前页面结构，依赖浏览器插件协同工作。
1、编写符合豆包插件规范的ai-plugin.json文件，设置name_for_model为“网页内容分析助手”，description_for_model说明用途。
2、在api字段中指定type为webhook，url填写您部署的HTTPS Webhook接收地址，例如https://yourdomain.com/webhook/doubao。
3、将该文件部署至公开可访问路径，如https://yourdomain.com/.well-known/ai-plugin.json，确保返回头含Content-Type: application/json。
4、在Webhook服务端校验请求头中的X-Doubao-Signature签名，验证来源合法性后解析query与context字段。
5、根据插件传入的网页DOM快照或文本片段，调用豆包AI API生成响应，并以JSON格式返回response字段，内容将注入至浏览器插件弹窗中。
五、配置CSP策略与安全头保障嵌入安全性
该步骤为所有嵌入方式的强制前置要求，防止XSS攻击与非法脚本注入，确保AI交互过程符合OWASP安全标准。
1、在网站HTTP响应头中添加Content-Security-Policy，显式声明script-src 'self' https://sdk.doubao.com，禁止执行未授权JS。
2、设置Frame-Ancestors 'self'以阻止他人站点通过<iframe></iframe>嵌套您的AI对话窗口。
3、启用Strict-Transport-Security头，强制浏览器仅通过HTTPS连接，有效期至少设置为max-age=31536000。
4、对所有接收用户输入的表单字段实施服务端长度限制与字符白名单过滤，特别防范<script></script>、javascript:等危险载荷。
5、在前端JavaScript中调用DOMPurify.sanitize()处理AI返回的富文本内容，禁止直接使用innerHTML插入未经净化的AI输出。
