切换主题
Postman
Postman 是 API 调试与协作工具。它适合先验证 Token、Base URL 和请求体,再把已经调通的请求迁移到代码或其他客户端。
- 下载:https://www.postman.com/downloads/
- Web 版:https://go.postman.co/
- 官方文档:https://learning.postman.com/docs/
创建 Environment
新建一个 DDD AI Environment:
| 变量 | 填写方式 |
|---|---|
base_url | Initial value 和 Current value 都填写 https://dddai.dev/v1 |
api_key | Initial value 留空;Current value 填写 Postman 专用 API Key |
model | Initial value 和 Current value 都填写当前可用模型 ID |
团队协作时不要把真实 API Key 同步到共享 Initial value。优先只保存在本地 Current value 或 Postman Vault 中。
创建聊天请求
Method 与 URL
text
POST {{base_url}}/chat/completionsAuthorization
选择 Bearer Token,值填写:
text
{{api_key}}Headers
text
Content-Type: application/jsonBody
选择 raw > JSON:
json
{
"model": "{{model}}",
"messages": [
{
"role": "user",
"content": "用一句话回复:Postman 已连接 嘀嘀嘀 AI"
}
],
"stream": false
}点击 Send 后查看状态码和响应 Body。
验证结果
- 响应状态为
200。 - Body 中包含模型回复。
- 使用日志 中记录了相同模型和 API Key 的请求。
- 关闭或更换 Key 后,认证结果会相应变化。
风控与安全
- 使用 Postman 专用 API Key,不与生产服务共用。
- 分享 Collection 前移除真实 Token、敏感请求和客户数据。
- 不要把 API Key 写进 Pre-request Script、示例响应或公开文档。
- Collection Runner 和自动化测试先使用少量迭代,避免意外并发和消耗。
- 不要使用调试工具尝试规避模型权限、限速、内容审查或其他风控规则。
常见问题
返回 401
确认已选择正确 Environment,Bearer Token 使用 ,且当前值不是空字符串。
返回 404
检查最终 URL 是否为 https://dddai.dev/v1/chat/completions,不要重复拼接 /v1。
返回 400
检查 JSON 格式、模型 ID 和 messages 数组。第一次调试保持 stream: false。
使用日志没有记录
打开 Postman Console 查看最终请求地址和变量替换结果,确认请求确实发送到本站。

