一、产品简介
Postman 是业界标准的 API 测试平台。通过导入 Nebula Unified API 集合，您可以在可视化界面中探索并测试所有 Nebula 接口——包括对话补全、图像生成、视频生成、文本向量、重排序等——无需编写任何代码。二、下载文件
请下载以下两个文件并导入 Postman：Nebula Unified API 集合
完整的 API 集合，包含所有接口的预构建请求，按功能分文件夹整理。
Nebula 环境变量
预配置的环境变量：
base_url、api_key 以及各类能力的默认模型 ID。三、快速配置步骤
第一步 — 导入集合
- 打开 Postman，点击左上角 Import（导入）。
- 将
Nebula_Unified_API.postman_collection.json拖入导入对话框，或点击 Upload Files 选择文件。 - 点击 Import 确认导入。
第二步 — 导入环境变量
- 再次点击 Import。
- 上传
Nebula_Unified_API.postman_environment.json。 - 点击 Import 确认导入。
第三步 — 填写 API Key
- 在 Postman 左侧面板打开 Environments（环境）。
- 选择 Nebula Unified API - Environment。
- 找到
api_key变量行，在 Current value（当前值）列填入您的 Nebula API Key。 - 按 Ctrl/Cmd + S 保存。
第四步 — 激活环境
在 Postman 右上角的环境下拉菜单中，选择 Nebula Unified API - Environment。第五步 — 发送第一个请求
- 在左侧面板展开 Nebula Unified API 集合。
- 打开文件夹
00 - Getting Started→ 点击Smoke Test - Chat Completion。 - 点击 Send（发送）。
- 若返回
200 OK且内容包含Nebula API is ready.，则配置成功。
四、集合目录结构
集合按功能分文件夹组织：| 文件夹 | 内容说明 |
|---|---|
00 - Getting Started | 列出模型、快速冒烟测试 |
01 - Text / OpenAI-compatible | 对话补全、流式输出、Responses API、联网搜索、结构化输出 |
02 - Native Provider APIs | Claude Messages（含流式与 Token 计数）、Gemini generateContent（含流式与图像输出） |
03 - Embeddings & Retrieval | OpenAI 兼容 Embeddings、Rerank 重排序 |
04 - Image Generation | Gemini、Doubao Seedream（文生图）、Doubao Seededit（图像编辑）、GPT Image、Qwen Image |
05 - Video Generation | 提交与轮询 Sora 2、Veo、Wanxiang、Doubao Seedance 等任务 |
06 - Realtime & Voice | WebSocket / 实时语音接口 |
| 各厂商模型文件夹 | 从 /v1/models 自动生成，按 owned_by 与能力分组 |
五、环境变量说明
| 变量名 | 默认值 | 说明 |
|---|---|---|
base_url | https://llm.ai-nebula.com | Nebula API 基础地址，请勿修改 |
api_key | (空) | 您的 Nebula API Key，必须手动填入 |
default_chat_model | qwen-plus | 对话补全请求使用的模型 |
default_responses_model | gpt-5.2 | Responses API 请求使用的模型 |
default_claude_model | claude-sonnet-4-5-20250929 | Claude 原生接口使用的模型 |
default_gemini_model | gemini-2.5-flash | Gemini 原生接口使用的模型 |
default_image_model | gemini-2.5-flash-image | 图像生成默认模型 |
default_video_model | veo-3.1-fast-generate-001 | 视频生成默认模型 |
default_embedding_model | text-embedding-3-small | 文本向量默认模型 |
default_rerank_model | rerank-v1 | 重排序默认模型 |
video_task_id | (示例值) | 视频提交测试脚本自动写入 |
image_base64 | (占位符) | 图像编辑请求时替换为真实的 base64 数据 URL |
image_url | https://example.com/image.jpg | 图像编辑请求时替换为真实可访问的图片 URL |
六、使用技巧
切换模型
切换模型
无需修改环境变量，可在单条请求的 Body 中直接替换模型 ID。例如将
{{default_chat_model}} 改为 claude-sonnet-4-6，仅对该请求生效。流式请求
流式请求
Postman 支持 SSE（Server-Sent Events）。打开流式请求（如 Chat Completion - Streaming），在 Visualize 标签或原始响应体中可实时查看流式数据块。
视频生成（异步工作流）
视频生成（异步工作流）
视频生成为异步接口，步骤如下：
- 发送 Submit Video Task — 测试脚本自动将
task_id写入video_task_id变量。 - 反复发送 Query Video Task（使用
{{video_task_id}}）直至status返回succeeded。 - 使用返回的 URL 或调用 Download Video 接口下载视频文件。
图像编辑请求
图像编辑请求
使用图像编辑接口（如 Doubao Seededit、Qwen Image Edit）时：
- 在环境变量中将
image_base64设置为data:image/png;base64,...格式的字符串，或者 - 将
image_url设置为公开可访问的图片 URL。
保存响应为示例
保存响应为示例
请求成功后，点击 Save as Example 可将响应保存为示例，便于团队共享参考数据。
七、故障排除
401 Unauthorized（未授权）
401 Unauthorized（未授权）
无法连接 / Connection Error
无法连接 / Connection Error
- 检查网络连接是否正常。
- 确认
base_url为https://llm.ai-nebula.com，末尾无斜杠。 - 如在企业内网环境，请在 Postman 中配置代理。
模型不存在（404）
模型不存在（404）
- 部分模型需要特定账户权限或受地区限制。
- 尝试切换为
qwen-plus等对话模型，或通过 Responses API 使用gpt-5.2。 - 在
00 - Getting Started文件夹中运行 List Models，查看当前 API Key 可用的模型列表。