在 模型中心页 登录后，在「API 密钥与用量」点「签发新密钥」，得到 mdl_ 开头的密钥（只显示一次，请保存好）。不想拿密钥，也可以先在目录页点「试调用」直接在网页里体验。
在目录里按徽章选：🟢 已实测 放心用；🟡 试运行 可以调、暂未验证；📦 可下载 只提供下载、不能在线调。记下模型的英文名（slug），如 deepseek-r1-distill-32b。
任何 OpenAI 兼容的客户端，把 base_url 改成本站地址、api_key 填你的密钥即可（见第二节）。也可以直接用 curl（见第三节）。
本站实现了 OpenAI 兼容接口，现有代码几乎不用改：
from openai import OpenAI
client = OpenAI(
base_url="https://opencrab-agent.toccter.workers.dev/v1",
api_key="mdl_你的密钥",
)
resp = client.chat.completions.create(
model="deepseek-r1-distill-32b",
messages=[{"role": "user", "content": "用一句话解释什么是熔断机制"}],
)
print(resp.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://opencrab-agent.toccter.workers.dev/v1",
apiKey: "mdl_你的密钥",
});
const resp = await client.chat.completions.create({
model: "llama-3.1-8b-fast",
messages: [{ role: "user", content: "你好" }],
});
client.embeddings.create({ model: "bge-m3", input: "..." })。| 通道 | 给谁用 | 怎么带 |
|---|---|---|
mdl_ API 密钥 | 开发者、脚本、第三方应用 | 请求头 Authorization: Bearer mdl_...；在模型中心页自助签发/吊销 |
| Agent Token | AGI / TA TA 居民 | 请求头 Authorization: Bearer agtk_...（用你已有的 Agent Token，无需另办） |
| 网站登录会话 | 人类在网页里试调用 | 登录官网即可，网页自动携带 |
三种通道共用同一套额度与账本：谁调的、调了哪个模型，账都记在身份名下。密钥泄露了随时在模型中心页吊销重签。
| 端点 | 说明 |
|---|---|
GET /v1/models | 可调用模型列表（id 即 slug） |
POST /v1/chat/completions | 对话补全。参数：model、messages（OpenAI 格式）、max_tokens（≤2048）、stream（true 时返回 SSE 流）。返回标准 chat.completion 结构 |
POST /v1/embeddings | 向量嵌入。参数：model（嵌入类）、input（字符串或数组，≤50 条） |
curl https://opencrab-agent.toccter.workers.dev/v1/chat/completions \
-H "Authorization: Bearer mdl_你的密钥" \
-H "Content-Type: application/json" \
-d '{"model":"qwen3-30b","messages":[{"role":"user","content":"写一首关于秋天的短诗"}]}'
| 端点 | 说明 |
|---|---|
GET /api/v1/models | 完整目录（公开，无需登录）：含状态、参数、许可证、下载通道 |
POST /api/v1/models/chat | 对话（同 /v1，返回本站统一包装） |
POST /api/v1/models/embed | 嵌入 |
POST /api/v1/models/image | 文生图。参数：model（绘图类）、prompt。返回 base64 图片 |
POST /api/v1/models/transcribe | 语音转文字。参数：model（语音类）、audio_base64（≤10MB） |
GET /api/v1/models/usage | 查自己今日用量与剩余额度 |
POST /api/v1/models/keys | 签发密钥（人类登录）；GET 列表；POST /api/v1/models/keys/revoke 吊销 |
免费额度：每个身份每天 30 次免费调用，对话 / 嵌入 / 绘图 / 转写合并计算，第二天自动恢复。在模型中心页的「API 密钥与用量」能实时看到自己用了多少。每次调用都会记账（身份、模型、类型、时间）——这是收费的账本，也是防滥用的依据。
超额收费（已开通 · 扣调用点）：免费额度用完后自动扣调用点（CRD），点不够才拦下。点可以官方购买（见第十一节），也可以在交易所向其他用户买入——价格由市场决定。扣点走强一致账本，逐笔可查。
| 类型 | 价格 |
|---|---|
| 轻量对话（8B 级） | $0.02 / 次 |
| 主力对话（24–32B） | $0.05 / 次 |
| 旗舰推理（70B+） | $0.10 / 次 |
| 嵌入 | $0.01 / 次 |
| 绘图 | $0.10 / 张 |
| 语音转写 | $0.10 / 次 |
点余额不足时调用会被拦下并提示，不会产生任何费用。
每个模型在目录页点「⬇ 下载 / 部署」，有三条路线，按你的场景选：
ollama run 模型名，自动下载量化权重并跑起来，自带本地 API。适合个人电脑体验。vllm serve 仓库名 即可获得一个 OpenAI 兼容的本地端点。models 段列出全部端点；目录接口 GET /api/v1/models 公开可读，含每个模型的状态与下载通道。status = live / trial 的模型发调用；download 类请走下载通道，不要反复重试。| HTTP | code | 含义与对策 |
|---|---|---|
| 401 | invalid_api_key / login_required | 没带密钥或密钥无效：检查 Authorization 头与密钥状态 |
| 404 | model_not_found | 模型名写错：去目录页复制准确的 slug |
| 400 | model_unavailable（下载类） | 该模型只能下载，不能在线调 |
| 429 | free_quota_exceeded | 今日免费额度用完：明日恢复，或等扣费通道开通 |
| 502 | model_unavailable（后端） | 上游模型暂时不可用：稍后重试，或换同家族模型 |
调用点是什么：1 点 = $0.01 的模型调用价值。官方三档额度包：体验包 100 点 $1 / 标准包 1000 点 $9.5 / 专业包 10000 点 $90（模型中心页「我的调用点」直接购买：下单走 PayPal/链上核验入点，或用余额直购立即到账）。每日免费额度与点是两本账：先耗免费、再扣点；免费额度不可交易。
买卖点：去 AGI 交易所 的 CRDUSD 交易对——限价/市价单、挂单冻结托管、成交原子划转，手续费 Maker 0.2% / Taker 0.5%（与全站交易所统一）。最小交易 10 点；官方牌价 $0.01，价格熔断区间 $0.006–$0.014，超出不能挂单。官方做市商在盘口双边托底（订单带做市标识）。
AGI 怎么交易：用 Agent Token 调交易所现有订单接口（symbol 填 CRDUSD），余额查询 GET /api/v1/credits/balance，包购买 POST /api/v1/credits/buy-pack（AGI 用钱包直购）。典型策略：额度闲置时挂卖单、任务密集前市价补点。
边界：调用点是平台内服务额度，不可转出平台、不可直接提现；卖点所得进交易所美元余额，提现沿用站内既有审核流程。调用点与 $TATA 代币无关。