第三方 API 从 0 到 1：账号、令牌与调用原理

147AI

386人浏览 · 2026-05-21 11:37:07

147AI · 2026-05-21 11:37:07 发布

很多人第一次配置 AI 工具时，最容易卡在三个词上：API 地址、API Key、模型名。看起来只是复制粘贴，实际只要其中一个填错，客户端就会报 401、404、model not found，或者干脆没有任何响应。

这篇文章先不讲某一个具体工具，而是把第三方 API 接入的底层逻辑讲清楚。后面不管你配置 Cursor、Codex、Claude Code、Chatbox、Cherry Studio，都会反复用到这套思路。

本文以 147API 接口文档 的快速上手流程为例说明：先注册账号、充值余额、创建令牌、选择模型分组，再把 API 地址、密钥和模型名填到客户端里。具体端点、模型名和分组价格请以模型广场展示为准。

开始前你需要准备什么

在正式配置前，先确认你手里有这些东西：

一个可登录的 API 平台账号
账户余额大于 0
一个已经创建好的 API Key / 令牌
一个明确要调用的模型名
一个支持自定义 API 地址的客户端或开发环境

如果只是学习配置，不建议一上来就选最贵的大模型。先用一个便宜、响应快的模型(如：codex分组 )测试连通性，等链路跑通后再换正式模型。

第一步：理解三个核心概念

第三方 API 配置可以先记一句话：地址决定请求发到哪里，密钥决定谁来付费，模型名决定调用哪个模型。

配置项	通俗理解	常见写法
Base URL / API 地址	你把请求发到哪个网关	`https://147ai.com/v1`
API Key / 令牌	你的调用凭证和扣费账号	`SK-xxxxxxxx`
Model / 模型名	你具体要用哪个模型	从模型广场复制

这三项来自不同地方，不能混着填：

API 地址看接口文档或模型详情页。
API Key 在控制台「密钥管理」里生成。
模型名从模型广场复制，不能自己凭感觉简写。

第二步：注册与充值

以 147API 文档里的流程为例，第一步是进入 147ai.ai 注册账号。注册后进入控制台，在左侧找到「钱包管理」，根据实际需求充值，确保账户余额大于 0。

在这里插入图片描述

为什么要先充值？因为 API 调用不是本地功能，它会消耗模型资源。如果余额不足，后面即使 Key 和地址都填对，也可能因为额度问题被拒绝。

第三步：创建 API Key

进入控制台左侧的「密钥管理」，点击「添加令牌」。一般需要填写：

令牌名称
可用分组
额度限制
有效期限

如果你要用 Claude 类模型，就选择 Claude 相关分组；如果你要用 OpenAI 兼容模型，就选择对应分组。文档也提醒，不同分组的资源渠道、稳定性、质量和价格可能不同。

在这里插入图片描述

生成后你会看到 Key 的状态、余额和分组信息。这个 Key 要像密码一样保管，不要发到群里，不要放进公开截图，也不要提交到 Git。

第四步：在模型广场复制模型名

很多新手会犯一个错误：看到别人文章里写了某个模型名，就直接复制过去。实际配置时，更稳的做法是打开模型广场，找到你要用的模型，复制页面里展示的完整模型名称。

比如文档中举过类似 claude-sonnet-4-6 这样的模型名。你要注意：

大小写要一致
中横线、点号不能漏
不要把展示名当成模型 ID
不要把别的平台模型名拿来混用

在这里插入图片描述

如果客户端报 model not found，第一反应不是换 Key，而是先回模型广场核对模型名和令牌分组。

第五步：确认 API 地址怎么填

API 地址不能只记一个固定答案，因为不同工具会用不同的协议格式。最常见的是 OpenAI 原生格式，很多第三方平台会兼容它；Claude Code 这类工具则可能走 Anthropic 原生格式。你要先看清楚自己用的是哪一种。

OpenAI 原生格式通常围绕 https://api.openai.com/v1 展开。第三方 API 平台做 OpenAI 兼容时，往往让你把官方地址替换成第三方地址，比如：

https://147ai.com
https://147ai.com/v1
https://147ai.com/v1/chat/completions

其中 https://147ai.com/v1 最常见，因为很多客户端会把后面的接口路径自动补上。比如 Cherry Studio、Chatbox 这类普通用户使用的 AI 客户端，一般只需要你填写 Base URL、API Key 和模型名。你填 https://147ai.com/v1 后，软件会在实际请求时自动拼接 /chat/completions 或 Responses 相关路径，用户不需要理解 HTTP 细节，使用门槛会低很多。

另一种场景是不自动补全路径。比如你自己写后端服务，或者直接用 curl、Postman、HTTP 客户端调接口，这时就不能只填根地址，而要写完整接口地址。例如 OpenAI 兼容聊天接口通常要请求：

https://147ai.com/v1/chat/completions

对应的请求大概是：

curl https://147ai.com/v1/chat/completions \
  -H "Authorization: Bearer SK-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "从模型广场复制的模型名",
    "messages": [
      { "role": "user", "content": "你好，回复 OK" }
    ]
  }'

Anthropic 原生格式要单独看。Claude 类工具常见的是 /v1/messages 这一类接口，请求体也不是 OpenAI 的 messages 完全照搬版。比如 Claude Code 走第三方网关时，通常要确认网关是否支持 Anthropic Messages API，而不是只看它是否支持 OpenAI 兼容。

各大厂的模型也经常提供 OpenAI 兼容格式，方便开发者用同一套 SDK 或客户端接入。比如一些 Google、国内大模型或多模型网关，会提供“OpenAI Compatible”“自定义 OpenAI”“OpenAI 兼容接口”这样的入口。它的好处是配置方式统一，但你仍然要回到模型详情页确认：这个模型到底该填 Base URL、完整 Endpoint，还是原生厂商接口。

判断方法可以按这个顺序：

先看工具类型：普通 AI 客户端通常填 Base URL，后端 HTTP 客户端通常写完整接口地址。
再看协议类型：OpenAI 兼容、Anthropic 原生、Gemini 原生不要混用。
最后看模型详情页：以页面标注的 API 端点、模型名和请求格式为准。

如果填错路径，常见表现是 404、接口不存在、请求发不出去。不要把 404 和 Key 错误混在一起排查。

第六步：第一次请求怎么理解

如果你是开发者，一次最常见的 OpenAI 兼容文本聊天请求大概长这样：

POST /v1/chat/completions HTTP/1.1
Host: 147ai.com
Authorization: Bearer SK-xxxxxxxx
Content-Type: application/json

{
  "model": "从模型广场复制的模型名",
  "messages": [
    { "role": "user", "content": "你好，回复 OK" }
  ]
}