算力快速使用
拿到 API 令牌后，尽快在寰宇千赋跑通第一条 OpenAI 兼容模型 API 请求
快速开始
寰宇千赋 算力 API 的最小接入路径（OpenAI 兼容）。
这页只解决一件事：拿到 API 令牌后，尽快把第一条请求跑通。
更新基准
本文示例按 2026-06-22 编写。平台支持 OpenAI 兼容（GPT 等）、Anthropic Messages（Claude）与 OpenAI Images（gpt-image-2 等）；具体可用模型以 模型广场 管理员配置为准，下文模型名仅为示例。
1. 先拿到令牌
- 打开 https://aiempowerment.ai 注册或登录。
- 点击右上角 用户菜单 → 令牌管理（
/tokens），点击 添加令牌。 - 创建成功后请立即复制并保存
sk-密钥；之后在列表中仍可通过「显示密钥」再次查看，但请勿泄露给他人。 - 记下要调用的模型名称（在 模型广场 可复制）。
余额
算力按量从 平台账户余额（与发单托管账户共用）扣费。余额不足时 API 返回 402。请先在 结算 页 充值余额 后再调用。
2. 记住 Base URL
平台在 本站域名 提供 OpenAI 兼容代理，Base URL 填：
https://aiempowerment.ai/v1
适用于 OpenAI SDK、Cherry Studio、Cursor、Codex CLI 等客户端——把 API 地址改成上述 Base URL 即可。
本地开发时若跑 pnpm run dev，可改用 http://localhost:3000/v1。
3. 令牌分组与可用模型
创建令牌时可填写 分组（如 business、image）和 可用模型：
| 字段 | 作用 |
|---|---|
| 分组 | 用于账单归类与展示，不会自动限制你能调用哪些模型 |
| 可用模型 | 若填写，则仅允许列表中的模型；留空表示不限制 |
模型广场里每个模型也带有 business / image 等分组标签，便于你对照选型；实际能否调用，取决于 模型广场是否上架该模型、上游是否支持，以及令牌是否配置了 可用模型 白名单。
4. 鉴权方式
推荐使用 Bearer（与 OpenAI SDK 一致）：
Authorization: Bearer sk-你的令牌
Content-Type: application/json
也支持请求头 x-api-key: sk-你的令牌（Claude 调用推荐使用，与 Anthropic SDK 一致）。
5. 第一次请求：OpenAI Chat Completions（GPT）
curl https://aiempowerment.ai/v1/chat/completions \
-H "Authorization: Bearer sk-REPLACE_ME" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.4","messages":[{"role":"user","content":"你好，请用一句话介绍寰宇千赋。"}]}'
6. 第一次请求：Claude Messages
Claude 模型请使用 Anthropic Messages 接口（/v1/messages）：
curl https://aiempowerment.ai/v1/messages \
-H "x-api-key: sk-REPLACE_ME" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-6",
"max_tokens": 128,
"messages": [
{"role": "user", "content": "Say hello."}
]
}'
7. 第一次请求：OpenAI Responses
Codex / Agent 工作流常用此接口。模型名请换成模型广场中实际存在的名称（示例：gpt-5.4 或 gpt-5.3-codex-spark）。
curl https://aiempowerment.ai/v1/responses \
-H "Authorization: Bearer sk-REPLACE_ME" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.4","input":"Return a short hello from 寰宇千赋."}'
令牌管理 列表中每条令牌可 复制 curl 示例（默认走 /v1/responses，域名随当前站点自动填充）。
8. 图片生成：gpt-image-2（/v1/images/generations）
文生图请使用 OpenAI 兼容的 Images Generations 接口。当前模型为 gpt-image-2（以 模型广场 上架为准）。
请求体（application/json）
| 字段 | 必填 | 说明 |
|---|---|---|
model | 是 | 固定 gpt-image-2 |
prompt | 是 | 生图提示词 |
n | 否 | 生成张数，默认 1 |
size | 否 | 输出尺寸，见下表 |
quality | 否 | auto / low / medium / high，默认 auto |
response_format | 否 | url / b64_json，默认 url |
size 约束：可为 auto，或 宽x高（如 2048x2048）。自定义尺寸须满足：最大边 ≤ 3840px；宽高均为 16 的倍数；长短边比 ≤ 3:1；总像素在 655360 ~ 8294400 之间。常见值：1024x1024、1536x1024、1024x1536、2048x2048、2048x1152、3840x2160、2160x3840。
curl https://aiempowerment.ai/v1/images/generations \
-H "Authorization: Bearer sk-REPLACE_ME" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一张雨后夜景街道，地面有霓虹倒影，电影感构图",
"n": 1,
"size": "2048x2048",
"quality": "low",
"response_format": "url"
}'
成功响应示例（字段以上游为准）：
{
"created": 1762000000,
"data": [
{
"url": "https://example.com/generated.png",
"revised_prompt": "一张雨后夜景街道，地面有霓虹倒影，电影感构图"
}
],
"usage": {
"input_tokens": 18,
"output_tokens": 1756,
"total_tokens": 1774
}
}
9. 图片编辑 / 图生图（/v1/images/edits）
对已有一张图做编辑、变体或图生图时，请使用 Images Edits 接口，模型同样为 gpt-image-2。支持两种请求形式：
application/json：image/mask可为 URL、data URL 或 Base64 字符串multipart/form-data：直接上传本地image（及可选mask）文件
除 image 外，其余参数与上文生成接口一致（prompt 必填；size、quality、response_format、n 可选）。
方式 A · JSON（远程图片 URL）
curl https://aiempowerment.ai/v1/images/edits \
-H "Authorization: Bearer sk-REPLACE_ME" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "把天空改成日落，把路灯点亮",
"image": "https://example.com/source.png",
"n": 1,
"size": "1024x1024",
"quality": "low",
"response_format": "url"
}'
方式 B · multipart（本地文件）
curl https://aiempowerment.ai/v1/images/edits \
-H "Authorization: Bearer sk-REPLACE_ME" \
-F "model=gpt-image-2" \
-F "prompt=把天空改成日落，把路灯点亮" \
-F "image=@/path/to/input.png" \
-F "n=1" \
-F "size=1024x1024" \
-F "quality=low" \
-F "response_format=url"
可选字段 mask 用于指定编辑区域（JSON 与 multipart 均支持）。响应结构与生成接口相同，data[].url 或 data[].b64_json 二选一。
10. 如何查看可用模型
方式 A · OpenAI 兼容列表（需有效令牌）
curl https://aiempowerment.ai/v1/models \
-H "Authorization: Bearer sk-REPLACE_ME"
返回内容由上游决定；若与模型广场不一致，以模型广场为准。
方式 B · 模型广场（推荐）
打开 模型广场 查看已上架模型与价格。登录后会按你的定价类别展示折扣价。
方式 C · 公开 JSON 接口
curl https://aiempowerment.ai/api/model-plaza
匿名可访问配置；登录用户响应中会附带定价折扣信息。
11. 接下来怎么做
12. 常见问题
| 现象 | 说明与处理 |
|---|---|
| 401 / Invalid token | 密钥错误、多余空格、令牌已禁用或已过期。 |
| 402 / 账户余额不足 | 到 结算 充值。 |
| 429 / 额度不足或限流 | 余额不足、并发过高或上游限流；稍后重试或充值。 |
| 图片 400 参数错误 | 检查 size 是否满足 16 倍数与像素范围；model 是否为 gpt-image-2。 |
| model not allowed for this token | 令牌配置了 可用模型 白名单，当前 model 不在其中；编辑令牌或改用允许的模型。 |
| 上游返回模型不存在 | 模型名拼写错误，或模型广场未上架 / 上游未开通；先查 模型广场。 |
| 503 Claude 未配置 | 管理员需在服务端配置 UPSTREAM_ANTHROPIC_API_KEY（Lumen Claude 专用 Key）。 |
| 503 服务暂不可用 | 平台或上游未就绪；GPT 检查 UPSTREAM_API_KEY，Claude 检查 UPSTREAM_ANTHROPIC_API_KEY。 |
| 客户端连不上 | Base URL 应为 https://aiempowerment.ai/v1；鉴权用 Authorization: Bearer sk-... 或 x-api-key。 |
| 算力看板无数据 | 需登录同一账号；调用 API 成功扣费后刷新看板。 |
调用成功后，可在 算力看板 查看 Token 用量与扣费明细。