Usage Guide
使用指南
本指南介绍如何在老蹬(AI Service Marketplace)购买额度、获取 API Key,并在你的应用或 Claude Code 中调用 AI 服务。
1. 快速介绍
老蹬(AI Service Marketplace)是一个 AI API 额度交易平台。你可以在这里购买其他卖家出售的 AI 服务额度,获得一个 Platform API Key,然后通过统一的 Gateway 调用 AI 服务。
当前 Gateway 地址:
兼容路径(任选其一):
- •
/api/v1/chat/completions— OpenAI 协议(推荐,SDK 默认) - •
/api/v1/messages— Anthropic 协议(Claude Code / Anthropic SDK) - •
/api/v1/chat— short alias
2. 购买额度
- 进入 AI 服务市场
- 浏览服务,使用筛选和排序找到合适的模型与价格
- 点击进入服务详情,输入想要购买的额度(tokens)
- 点击「立即购买」,系统会自动从你的钱包余额中扣款
- 购买成功后,订单状态变为「已支付」
如果钱包余额不足,可以先去 我的钱包。
3. 生成 Platform API Key
- 进入 我的订单
- 找到状态为「已支付」的订单
- 点击「生成 API Key」按钮
- 立即复制弹出的 API Key,它只显示一次,刷新后无法再次查看完整密钥
你可以在 我的 API Key。
4. 调用 Gateway
我们的 Gateway 兼容 OpenAI Chat Completions API。将 Platform API Key 放到请求头的 Authorization 中即可调用。
curl
curl -X POST /api/v1/chat/completions \
-H "Authorization: Bearer <你的_Platform_API_Key>" \
-H "Content-Type: application/json" \
-d '{
"model": "<模型名称>",
"messages": [
{"role": "user", "content": "Hello!"}
]
}'Python(OpenAI SDK)
from openai import OpenAI
client = OpenAI(
api_key="<你的_Platform_API_Key>",
base_url="/api/v1",
)
response = client.chat.completions.create(
model="<模型名称>",
messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)JavaScript(OpenAI SDK)
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: '<你的_Platform_API_Key>',
baseURL: '/api/v1',
});
const response = await client.chat.completions.create({
model: '<模型名称>',
messages: [{ role: 'user', content: 'Hello' }],
});
console.log(response.choices[0].message.content);流式调用
流式响应可以让买家实时看到模型逐字输出。OpenAI 协议用 stream=true,Anthropic 协议默认就是流式。
curl 流式(OpenAI)
curl -N -X POST /api/v1/chat/completions \
-H "Authorization: Bearer <你的_Platform_API_Key>" \
-H "Content-Type: application/json" \
-d '{
"model": "<模型名称>",
"stream": true,
"messages": [{"role": "user", "content": "Hello"}]
}'Python 流式(OpenAI)
from openai import OpenAI
client = OpenAI(api_key="<你的_Platform_API_Key>", base_url="/api/v1")
stream = client.chat.completions.create(
model="<模型名称>",
messages=[{"role": "user", "content": "Hello"}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content or ""
print(delta, end="", flush=True)
print()5. 查看使用日志与额度扣减
每次调用 Gateway 后,系统会自动:
- 从你的订单剩余额度中扣除本次调用消耗的 tokens
- 将费用按价格折算后计入卖家余额
- 在 使用日志
你也可以在 我的购买。
6. 在 Claude Code 中使用本平台
配置环境变量
在终端中设置以下环境变量,然后启动 Claude Code:
export ANTHROPIC_BASE_URL="/api"
export ANTHROPIC_API_KEY="<你的_Platform_API_Key>"
export ANTHROPIC_MODEL="claude-opus-5"
claudeWindows PowerShell 用户:
$env:ANTHROPIC_BASE_URL="/api"
$env:ANTHROPIC_API_KEY="<你的_Platform_API_Key>"
$env:ANTHROPIC_MODEL="claude-opus-5"
claude持久化配置(推荐)
在 ~/.claude/settings.json 中持久化配置:
{
"env": {
"ANTHROPIC_BASE_URL": "/api",
"ANTHROPIC_API_KEY": "<你的_Platform_API_Key>",
"ANTHROPIC_MODEL": "claude-opus-5"
}
}使用 Anthropic Python SDK
你也可以在代码中通过 Anthropic SDK 直接调用:
import anthropic
client = anthropic.Anthropic(
api_key="<你的_Platform_API_Key>",
base_url="/api/v1",
)
# Streaming by default for Anthropic SDK
with client.messages.stream(
model="claude-opus-5",
max_tokens=1024,
system="You are a helpful assistant.",
messages=[{"role": "user", "content": "Hello"}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
print()9. 独享额度 vs 共享额度
买家下单时可以选择两种模式,行为差异很大:
独享(reserved)
购买固定额度的 tokens,在订单有效期内专属于你。用多少扣多少,剩余额度不退;订单到期未用完的托管款会按规则结算给卖家。
共享(shared)
从公共池按量扣费,没有「剩余」概念。订单到期即结束,通常用于轻量、波动负载。
10. 工具 / Function Calling
两个协议都支持工具调用。Claude Code / Cursor / Cline 等 IDE 助手就是靠 tool use 工作的。
OpenAI 协议 — tools
from openai import OpenAI
import json
client = OpenAI(api_key="<你的_Platform_API_Key>", base_url="/api/v1")
tools = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}]
resp = client.chat.completions.create(
model="<模型名称>",
messages=[{"role": "user", "content": "Weather in Paris?"}],
tools=tools,
)
msg = resp.choices[0].message
if msg.tool_calls:
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
# execute get_weather(args["city"]) in your code
print(f"call {call.function.name}({args})")Anthropic 协议 — tools
import anthropic
client = anthropic.Anthropic(
api_key="<你的_Platform_API_Key>",
base_url="/api/v1",
)
tools = [{
"name": "get_weather",
"description": "Get current weather for a city",
"input_schema": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
}]
resp = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
tools=tools,
messages=[{"role": "user", "content": "Weather in Paris?"}],
)
for block in resp.content:
if block.type == "tool_use":
print(f"call {block.name}({block.input})")11. 思考块 / Reasoning
DeepSeek / Anthropic 等模型支持 reasoning_content(推理过程),网关会原样透传。
DeepSeek 思考字段
DeepSeek 的响应中 reasoning_content 字段包含思考过程。在多轮对话中,你必须把上一轮的 reasoning_content 原样带回请求,否则会报 400 错误。
Anthropic 思考块
Anthropic 返回 content_block type=thinking 的事件,需要客户端 SDK / Claude Code 处理。
12. 端点对照
三个端点任选一个,语义略有差异:
| Endpoint | 选哪个? |
|---|---|
| /api/v1/chat/completions | OpenAI 官方完整路径。设置 base_url=${base}/api/v1 后,SDK 自动调用这个。 |
| /api/v1/messages | Anthropic Messages API 官方路径。Claude Code / Anthropic SDK 用这个。 |
| /api/v1/chat | OpenAI Chat Completions 的短别名(向后兼容)。 |
OpenAI SDK / 第三方兼容客户端 → /api/v1/chat/completions。Claude Code / Anthropic SDK / Cursor → /api/v1/messages。/api/v1/chat 保留只是为了短路径习惯。
13. 限流规则
网关对每个客户端 IP 限速,以防止恶意刷量。
- •每 IP: 60 次 / 分钟(单 IP 总请求,跨端点合并计数)
- •单流式请求最长: 30 分钟(STREAM_MAX_DURATION_SECONDS=1800),超时切断并按已交付 tokens 结算
- •请求体最大: 10 MB(GATEWAY_MAX_BODY_SIZE_BYTES)
- •订单级: 由商品剩余额度决定,扣到 0 自动结束
14. 错误码速查
网关返回的标准 HTTP 错误码含义:
| 状态码 | 含义 | 排查方向 |
|---|---|---|
| 400 | 请求格式错误 | 检查 JSON、必填字段、model 名是否在白名单 |
| 401 | API Key 无效或已撤销 | 重新生成 API Key,或确认 Authorization 头格式 |
| 402 | 订单额度已用完 | 去我的订单再买一份,或买一个额度更大的商品 |
| 403 | 商品已过期 / 已售罄 / API Key 未绑定有效订单 | 去我的订单看状态,确认订单处于 active 状态 |
| 404 | 订单不存在或 API Key 错配 | 确认 API Key 来自有效订单,且订单 ID 与 key 关联匹配 |
| 413 | 请求体超过 10 MB | 压缩历史消息、去掉冗余字段 |
| 429 | 触发了限流(IP 或 商品配额) | 降低请求频率,或分散到多个 API Key |
| 500 | 上游 provider 服务异常 | 稍后重试;若持续失败联系卖家确认其 provider key |
| 502 | 上游 provider 长时间无响应 | 同上,或换其他卖家同模型商品 |
| 503 | 网关过载或临时维护 | 查看官方 status 通知或工单 |
15. Platform API Key 管理
Platform API Key 是你调用 Gateway 的唯一凭证。可同时持有多把,推荐按用途分类。
命名
生成时给 key 起个名字(比如 "iPhone app" / "公司项目-A"),便于后期识别。
多 key 多订单
你可以为不同订单各生成一把 key,互不干扰。注销一把不影响其他。
绑定与解绑
key 在生成时绑定到当前订单。订单到期后 key 自动失效。可在生成后再次绑定到其他 active 订单。
撤销
在 API Key 列表点点删除立即生效,旧请求会立即被拒。
17. 充值与钱包
你的老蹬币余额来自三种渠道:
- •注册礼包:首次注册即送 200 老蹬币(≈2 RMB)
- •邀请奖励:通过你的邀请链接注册的新用户,双方各得 50 老蹬币
- •每日签到:每天去 /wallet 签到可领 1-20 老蹬币;连续 3 天额外 20 币,连续 10 天额外 80 币
充值
目前充值流程正在接入第三方支付。暂时可通过注册礼包 + 邀请 + 签到累计获得老蹬币,用于首次体验。等真支付通道上线后会在此更新。
18. 邮箱验证
注册后,平台会发送 6 位验证码到你的邮箱(开发模式下直接返回)。验证邮箱后,你的账户才能正常使用所有功能。
16. 卖家上架指南
如果你想把闲置的 AI 额度卖出去,在 我的销售 后台 30 秒即可上架:
- 点击「发布新服务」,选择 Provider、模型、定价模式
- 填写 价格 / 额度 / 有效期,以及你的 provider API Key(平台会加密托管)
- 提交后,平台会用 1 token 真实调用来验证 key 有效性,通过后立即上架
- 买家下单后,你可在 我的销售 → 订单 看到收入,实时到账到你的 老蹬币 余额
Key 安全
你的 provider API Key 经 AES-256-GCM 加密后存入数据库,密钥永不以明文出现在日志或响应中。即便平台管理员也无法看到原文。
退款与撤销
独享(reserved)模式下,买家下单时金额会托管在平台,买家实际未消耗部分在订单到期后自动结算给你。买家可以主动取消尚未消耗的订单,未消耗额度按买家已支付金额退款。共享(shared)模式按量计费,无托管款。
7. 常见问题
Q: API Key 泄露了怎么办?
立即前往 我的 API Key。
Q: 调用返回 401 或 403?
请检查 Authorization: Bearer <key> 格式是否正确,以及 API Key 是否已被撤销或额度已用完。若返回 400 并提示使用 /api/v1/messages,说明该商品是 Anthropic 协议商品,请改用该接口调用。
Q: 调用的是真实 AI 吗?
是的,本平台 Gateway 会将请求转发到对应的 AI 服务商(DeepSeek、OpenAI、Claude 等,或卖家自定义的原生接口)。你购买哪个卖家发布的服务,就会调用该卖家配置的模型——请求里的模型名会被网关强制覆盖为商品模型。所有调用均为真实 API 请求,token 消耗和计费均来自实际 API 返回的 usage 数据。
Q: 商品显示“自定义”是什么意思?
表示卖家使用的是自己提供的原生接口和模型(不在平台内置清单中)。对买家来说用法完全一样:购买后照常生成平台 API Key,按商品标注的接口格式(OpenAI 兼容或 Anthropic Messages)选择 /api/v1/chat 或 /api/v1/messages 调用即可。
19. 多模态输入(图片)
平台网关会把 messages 数组原样转发给上游 provider。所以任何支持 vision 的模型(GPT-4o / Claude 4 / Qwen3-VL / GLM-4V / Doubao seed 等)都能直接传图。
图片 URL 形式(OpenAI)
from openai import OpenAI
client = OpenAI(api_key="<你的_Platform_API_Key>", base_url="/api/v1")
resp = client.chat.completions.create(
model="<模型名称>",
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "What's in this image?"},
{
"type": "image_url",
"image_url": {
# Public URL the upstream provider can fetch
"url": "https://example.com/cat.jpg",
# Or use a base64 data URL for local files (see below)
},
},
],
}],
)
print(resp.choices[0].message.content)本地图片转 base64(OpenAI)
import base64
from openai import OpenAI
from pathlib import Path
# Read a local image, encode as base64 data URL
img_b64 = base64.b64encode(Path("cat.jpg").read_bytes()).decode()
data_url = f"data:image/jpeg;base64,{img_b64}"
client = OpenAI(api_key="<你的_Platform_API_Key>", base_url="/api/v1")
resp = client.chat.completions.create(
model="<模型名称>",
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "Describe this image."},
{"type": "image_url", "image_url": {"url": data_url}},
],
}],
)
print(resp.choices[0].message.content)Anthropic SDK 本地图片
import base64
import anthropic
from pathlib import Path
img_b64 = base64.b64encode(Path("cat.jpg").read_bytes()).decode()
client = anthropic.Anthropic(
api_key="<你的_Platform_API_Key>",
base_url="/api/v1",
)
resp = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
messages=[{
"role": "user",
"content": [
{
"type": "image",
"source": {
"type": "base64",
"media_type": "image/jpeg",
"data": img_b64,
},
},
{"type": "text", "text": "Describe this image."},
],
}],
)
print(resp.content[0].text)价格
图片按 provider 内部规则计费,通常比纯文本贵很多(一张 1024×1024 的图约等于 1000-2000 个文本 token)。购买前请确认商品页标明的输入输出价,这是老蹬币扣减的唯一依据。
模型支持
不是所有模型都支持图片。常见支持: gpt-4o / 4.1 / claude-opus-5 / sonnet-5 / haiku / GLM-4.6+ / Qwen3-VL / Doubao seed 2.x / DeepSeek-VL(若有)。具体以所购商品绑定的模型为准。
限制
单张图片建议 ≤ 5 MB(Base64 编码后会再大 33%)。request body 总大小仍受 10 MB 网关限制约束。
Reference
各模型参考价
以下是平台支持的所有模型在各家官方 API 的公开定价(已换算为 老蹬币 / 千 tokens,仅供横向比较)。卖家在平台上自定售价,买家实际购买价格以商品页为准。
DeepSeek
| 模型 | 输入 | 输出 | 平均 |
|---|---|---|---|
| deepseek-v4-flash | 0.10 | 0.20 | 0.15 |
| deepseek-v4-pro | 0.30 | 0.60 | 0.45 |
KIMI / Moonshot
| 模型 | 输入 | 输出 | 平均 |
|---|---|---|---|
| kimi-k2.7-code | 0.43 | 1.80 | 1.12 |
| kimi-k2.7-code-highspeed | 0.43 | 1.80 | 1.12 |
OpenAI
| 模型 | 输入 | 输出 | 平均 |
|---|---|---|---|
| gpt-4.1 | 1.44 | 5.76 | 3.60 |
| gpt-4.1-mini | 0.29 | 1.15 | 0.72 |
| gpt-4o-mini | 0.11 | 0.43 | 0.27 |
Anthropic / Claude
| 模型 | 输入 | 输出 | 平均 |
|---|---|---|---|
| claude-opus-5 | 3.60 | 18.00 | 10.80 |
| claude-sonnet-5 | 2.16 | 10.80 | 6.48 |
智谱 AI / ChatGLM
| 模型 | 输入 | 输出 | 平均 |
|---|---|---|---|
| glm-5-turbo | 1.30 | 3.96 | 2.63 |
| glm-5 | 0.95 | 3.01 | 1.98 |
| glm-4.7 | 0.43 | 1.58 | 1.01 |
| glm-4.6 | 0.43 | 1.58 | 1.01 |
| glm-4.5 | 0.43 | 1.58 | 1.01 |
| glm-4.5-air | 0.26 | 0.95 | 0.61 |
通义千问 / Qwen
| 模型 | 输入 | 输出 | 平均 |
|---|---|---|---|
| qwen-max | 0.25 | 1.00 | 0.63 |
| qwen-max-latest | 0.25 | 1.00 | 0.63 |
| qwen-plus | 0.08 | 0.48 | 0.28 |
| qwen-plus-latest | 0.08 | 0.48 | 0.28 |
| qwen-turbo | 0.03 | 0.06 | 0.05 |
| qwen-turbo-latest | 0.03 | 0.06 | 0.05 |
| qwen-coder-plus | 0.20 | 0.80 | 0.50 |
| qwen-coder-plus-latest | 0.20 | 0.80 | 0.50 |
| qwen3-235b-a22b | 0.40 | 1.60 | 1.00 |
| qwen3-30b-a3b | 0.10 | 0.40 | 0.25 |
豆包 / ByteDance
| 模型 | 输入 | 输出 | 平均 |
|---|---|---|---|
| doubao-seed-2-1-pro-260628 | 0.32 | 1.60 | 0.96 |
| doubao-seed-2-1-turbo-260628 | 0.20 | 1.00 | 0.60 |
| doubao-seed-2-0-pro-260428 | 0.32 | 1.60 | 0.96 |
| doubao-seed-2-0-lite-260428 | 0.06 | 0.37 | 0.22 |
| doubao-seed-2-0-mini-260428 | 0.02 | 0.20 | 0.11 |
| doubao-seed-1-6-250615 | 0.03 | 0.06 | 0.05 |
百川智能
| 模型 | 输入 | 输出 | 平均 |
|---|---|---|---|
| Baichuan4-Turbo | 0.03 | 0.20 | 0.12 |
| Baichuan4-Air | 0.01 | 0.06 | 0.04 |
| Baichuan4 | 0.05 | 0.30 | 0.18 |
| Baichuan3-Turbo | 0.01 | 0.06 | 0.04 |
| Baichuan3-Turbo-128k | 0.01 | 0.08 | 0.05 |
MiniMax
| 模型 | 输入 | 输出 | 平均 |
|---|---|---|---|
| MiniMax-M3 | 0.30 | 0.86 | 0.58 |
| MiniMax-M3-highspeed | 0.30 | 0.86 | 0.58 |
| MiniMax-M2.7 | 0.21 | 0.84 | 0.53 |
| MiniMax-M2.7-highspeed | 0.21 | 0.84 | 0.53 |
| MiniMax-M2.5 | 0.21 | 0.84 | 0.53 |
| MiniMax-M2.1 | 0.10 | 0.40 | 0.25 |
1 老蹬币 = 0.01 RMB · 未列入的模型为新发布或暂无权威数据,请以各家官方定价页为准。