1. 配置地址与认证
兼容客户端通常将 Base URL 设为 https://ak47token.com/v1。原始 HTTP 请求使用 Authorization: Bearer 头传入 API Key。Key 在控制台内创建和撤销，勿放入公开网页或仓库。
Base URL 怎么填，什么时候加 /v1？
Base URL 是客户端用来拼接接口的地址，不一定是最终请求地址。先查客户端是否自动追加 /v1，再确认最终地址只有一个 /v1；原始 curl 则直接请求完整接口地址。
| 使用方式 | 填写什么 | 怎样核对 |
|---|---|---|
| 原始 HTTP / curl | https://ak47token.com/v1/chat/completions | 这是聊天请求的完整地址，不再追加接口路径。 |
| 客户端要求填写 API 前缀 | https://ak47token.com/v1 | 聊天请求最终应到 /v1/chat/completions；按客户端说明核对拼接结果。 |
| 客户端会自动追加 /v1 | https://ak47token.com | 确认它追加的是所需接口，避免出现 /v1/v1/...。 |
- Chat Completions、Responses 和 Messages 是不同接口；地址正确也需要模型支持对应协议。
- 遇到 404，先看实际请求路径，再看错误正文是否在提示模型不存在。
2. 选择实际可用的模型 ID
在模型目录中找到支持目标接口的模型。复制模型 ID，而不是展示名。先确认聊天、图片、Responses 或工具调用等能力是否明确支持。
3. 发送一个普通聊天请求
把下方两个占位值替换为自己的环境变量，再执行请求。示例将输出上限设为 128 Token，适合先验证接入。
export AK47_API_KEY='替换为你自己的 API Key'
export AK47_MODEL='替换为目录中的可用模型 ID'
curl https://ak47token.com/v1/chat/completions \
-H "Authorization: Bearer $AK47_API_KEY" \
-H 'Content-Type: application/json' \
-d "{\"model\":\"$AK47_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"你好，请回复一句问候。\"}],\"max_tokens\":128}"4. 再接入你的客户端
普通请求成功后，在支持自定义提供商的应用或开发工具中填写地址、Key 与模型 ID。不同工具使用的接口可能不同，Responses、Messages 和 Chat Completions 不能仅靠更换名称互相替代。
- Base URL 重复 /v1：检查客户端是否自动附加接口前缀。
- 认证失败：核对 Key 是否完整、启用，是否使用 Bearer 认证。
- 模型不可用：检查模型 ID、接口和能力，而不是反复更换随机模型名。
- 额度或请求失败：查看余额与调用记录，并保留请求编号用于排查。
401、404、额度不足或超时，按什么顺序排查？
先核对最终请求地址，再检查认证、模型与参数，最后查看额度和调用记录。本站 JSON 错误正文使用 error.message；客户端显示的提示可能经过加工，排查时同时保留 HTTP 状态与响应中的 X-Request-ID。
| 状态或现象 | 先检查 | 下一步 |
|---|---|---|
| 401／认证失败 | Key 是否完整、启用，以及客户端使用的认证头。 | 聊天示例使用 Authorization: Bearer；在控制台核对或撤销 Key，不把它发给客服。 |
| 404／请求路径不存在 | 最终 URL 是否重复 /v1，是否用了正确接口。 | 按上面的地址表修正路径，再发送一个小请求。 |
| 404／提示模型不存在 | model 是否为本站当前模型 ID，而非展示名或其他平台的名称。 | 从公开模型与价格页核对 ID，再检查该模型适用的接口。 |
| 402／可用额度不足 | 账户可用额度与此次请求所需额度。 | 查看余额与调用记录，核对输出上限等参数；问题未解决前不要连续重发。 |
| 400／请求参数不符合要求 | JSON、必填字段和 error.message 的具体说明。 | 从本页最小请求开始，每次只增加一项参数。 |
| 501／能力未支持 | 所选模型及当前接入是否支持请求的协议或功能。 | 核对模型说明，使用明确支持该能力的模型；仅改模型展示名不能解决问题。 |
| 502／503／504，或客户端超时 | 错误正文与调用记录中是否已经有对应结果。 | 保留时间、模型 ID 和请求编号；持续异常时联系客服，确认请求状态后再决定是否重试。 |
- 客户端超时不等于服务端一定没有完成，也不能单凭超时判断是否扣费；以调用记录核对。
- 求助时提供请求时间、模型 ID、最终请求路径、HTTP 状态、脱敏后的错误提示与 X-Request-ID。删除 API Key、Authorization、Cookie 和请求中的私人内容。