AI 接口

AI 接口让你的项目可以使用 AI 对话能力，支持文本、图片、工具调用以及普通响应和流式响应。

可以选择以下两种模式：

• 平台内置：使用 DevDeck 提供的模型，从独立的 AI 余额中扣费。
• 自定义 API：使用自己的供应商接口和 API Key。DevDeck 不扣除 AI 余额，但供应商可能 向你的账号收费。

连接前须知

首次配置 AI 接口时，DevDeck 会要求选择项目业务范围：中国或国际。这个项目级选项 决定可用的平台内置模型和数据处理边界，确认后不能修改。

AI 余额与 AI Builder Credits 相互独立。同一个账户的余额由该账户创建的所有项目共享。

连接平台内置模型

1. 在 DevDeck 中打开项目，选择配置 → 连接。
2. 找到AI 接口，选择连接或配置。
3. 如果页面提示，选择并确认项目业务范围。
4. 打开平台内置，选择可用模型；余额不足时先充值 AI 余额。
5. 选择测试连接，发送一次小型验证请求。
6. 选择连接平台模型。
7. 在 Connection 卡片上选择接入，将实现需求发送给 AI Builder；也可以直接要求 AI Builder 在项目后端使用已连接的 AI 接口。
8. 在 Preview 中测试项目，确认后再发布到生产环境。

连接或切换模型后，请先在 Preview 中验证效果，再重新发布项目，使生产环境使用最新配置。

连接自定义 API

自定义 API 支持 OpenAI Compatible 和 Anthropic Messages 两种协议。

1. 打开AI 接口 → 自定义 API。
2. 选择协议。
3. 填写 HTTPS API Base URL、模型名称和 API Key。对于 OpenAI Compatible 服务，请填写 以 /v1 结尾的 Base URL，DevDeck 会自动追加 /chat/completions。
4. 选择保存配置。保存只会创建草稿，不会调用供应商，也不会替换当前活动连接。
5. 选择测试连接。DevDeck 会使用已保存的草稿发送一次最小请求。
6. 测试成功后，选择确定并启用。

如果自定义配置测试失败，之前已经启用的配置仍可继续使用。DevDeck 会安全保存你填写的 API Key；以后再次打开配置时只会显示掩码。

自定义 API 合规责任

自定义接口不继承 DevDeck 的境内备案承诺。请自行确认供应商的服务地域、备案状态、隐私条款 和数据出境要求。

平台内置模型与价格

以下价格生效日期为 2026 年 8 月 27 日。实际可选模型会根据项目业务范围和服务可用性 显示，请以 AI 接口配置页面为准。

国际模型

单位：美元/百万 Token。

模型	输入	输出	缓存写入	缓存读取
Claude Opus 4.7	$5.00	$25.00	$6.25	$0.50
GPT-5.6	$5.00	$30.00	$5.00	$0.50

中国模型

单位：人民币/百万 Token。

模型	可用范围	输入	输出	缓存写入	缓存读取
Qwen 3.7 Plus	中国、国际	¥2.00	¥8.00	¥2.50	¥0.40

AI 余额以美元结算。使用 Qwen 3.7 Plus 时，费用当前按 ¥7.20 = $1.00 换算后从 AI 余额扣除。最终扣费金额以 AI 余额页面的调用明细为准；后续价格调整不会追溯改变已经产生的 费用。

AI 余额与调用明细

打开我的账户 → AI 余额，可以：

• 通过 Stripe 充值 $10、$30 或 $100 美元；
• 查看可用余额、预留金额和累计消费；
• 按项目、模式、状态和日期筛选调用；
• 查看每次调用的模型、Token 总量、费用和耗时。

平台内置模型在调用期间可能暂时显示预留金额，调用完成后会按实际用量结算。可用余额不足时， 请求会被拒绝。自定义 API 调用仍会保留调用明细，但不会产生 DevDeck 模型费用。

当前服务限制为：每个账户每分钟 60 个请求、每个项目最多 5 个并发请求、每次请求最多 16,384 个输出 Token。

切换或断开 AI 接口

打开配置 → 连接 → AI 接口，可以选择同一业务范围内的其他可用模型，也可以准备并测试 新的自定义配置。断开连接会移除活动的自定义凭据，并停止项目发起新的 AI 调用。如果项目的 界面或后端行为也需要变化，请修改后重新发布项目。