> For the complete documentation index, see [llms.txt](https://gptmetaapi-docs.mygptmeta.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gptmetaapi-docs.mygptmeta.com/ji-chu-jiao-cheng/gptmeta-api-kuai-su-kai-shi.md).

# GPTMeta API 快速开始

> 更新版 · 2026-10-23（Asia/Shanghai）\
> Base URL：`https://www.blueshirtmap.com/`\
> 截图见本地 `docs-update`；迁站时嵌入。

面向首次接入：注册 → 钱包有余额 → 创建 API Key → 调用 `/v1/chat/completions`。

## 1. 注册或登录

1. 打开 <https://www.blueshirtmap.com/>。
2. 进入登录页注册或登录（含人机验证）。

![登录页](https://1435024887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMj4XS5EGbl6waeu8ej6%2Fuploads%2FVhxOa2jBGfZxPgX2lAMB%2Fgptmeta-02-login.png?alt=media)

3. 登录后进入工作台 `/panel`。

![工作台](https://1435024887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMj4XS5EGbl6waeu8ej6%2Fuploads%2FsWJOcFjmm9j8uLeRnTEa%2Fgptmeta-console-01-dashboard.png?alt=media)

新用户注册赠送 0.2 美元额度（以站内规则为准）。

## 2. 充值钱包（如需要）

令牌额度 ≠ 钱包余额：调用前钱包必须有余额。

1. 打开「余额充值」`/topup`。
2. 可选支付宝 / 微信 / USDT / Stripe，或兑换码（以页面为准）。
3. 确认余额后再调用。

![余额充值](https://1435024887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMj4XS5EGbl6waeu8ej6%2Fuploads%2F1ALBTCRrtHggVIqdeQeX%2Fgptmeta-console-03-wallet.png?alt=media)

## 3. 创建 API 令牌

1. 打开「API 令牌」`/token`。
2. 设置名称、有效期、额度后创建。
3. **仅在创建时完整复制一次 Key**；列表中通常为掩码显示。

![令牌管理（Key 已掩码）](https://1435024887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMj4XS5EGbl6waeu8ej6%2Fuploads%2FRLtGEQo4ufwRFUDKfiZB%2Fgptmeta-console-02-tokens.png?alt=media)

注意：勿把 Key 提交公开仓库、前端或发给不可信第三方。

## 4. 配置 Base URL、Key、模型

| 配置项      | 填写内容                                                                        |
| -------- | --------------------------------------------------------------------------- |
| Base URL | `https://www.blueshirtmap.com/`；若客户端要求带版本：`https://www.blueshirtmap.com/v1` |
| API Key  | 上一步复制的 Key                                                                  |
| 模型       | 从「模型价格」`/pricing` 复制真实模型名                                                   |

建议：先在控制台「对话」`/chat` 试用，再接入自有程序。

![对话试用](https://1435024887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMj4XS5EGbl6waeu8ej6%2Fuploads%2FaJapx16busCUa8YtyAO5%2Fgptmeta-console-06-chat.png?alt=media)

## 5. curl 首次调用

```bash
export GPTMETA_API_KEY='替换为你的_API_Key'
export GPTMETA_MODEL='替换为模型列表中的模型名称'

curl 'https://www.blueshirtmap.com/v1/chat/completions' \
  -H "Authorization: Bearer ${GPTMETA_API_KEY}" \
  -H 'Content-Type: application/json' \
  --data "{\"model\":\"${GPTMETA_MODEL}\",\"messages\":[{\"role\":\"user\",\"content\":\"你好，请用一句话介绍你自己。\"}]}"
```

## 6. 查看用量日志

打开「使用日志」`/log` 核对请求与扣费摘要。

![使用日志](https://1435024887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMj4XS5EGbl6waeu8ej6%2Fuploads%2FWRKFW5neE1zJu9f3Y94L%2Fgptmeta-console-05-logs.png?alt=media)

## 7. 第三方客户端地址怎么填？

| 客户端要求          | 常见写法                                               |
| -------------- | -------------------------------------------------- |
| 根域名（自动追加路径）    | `https://www.blueshirtmap.com/`                    |
| 带 `/v1` 的 Base | `https://www.blueshirtmap.com/v1`                  |
| 完整对话地址         | `https://www.blueshirtmap.com/v1/chat/completions` |
| Midjourney 前缀  | `https://www.blueshirtmap.com/mj`（仅 MJ 相关客户端）      |

避免重复拼接成 `/v1/v1/...`。

## 下一步

* 计价方式与模型支持
* ChatPRD / 旧文档中的安全配置、常见错误、MJ / Suno / GPTs 教程