使用说明
从注册到调用，按步骤完成每一个环节；点击图片可查看大图。
1
打开门户
访问 https://diracai-studio.com，点击登录卡片下方的「免费注册」进入注册表单。
门户登录页：手机号 + 密码登录
2
填写手机号并获取验证码
输入 11 位大陆手机号，点击「获取验证码」，输入短信收到的 6 位验证码（5 分钟内有效，同一手机号每天最多 10 条）。
3
设置密码与账户类型
密码至少 6 位并重复确认；账户类型选择个人账户（自己使用）或公司账户（可创建子账户、共享额度）；称呼 / 公司名选填。
注册表单：手机号验证码 + 密码 + 账户类型
4
提交并领取 API Key
点击「注册并领取 API Key」自动登录进入门户，弹窗展示新发放的 Key 与赠送试用额度，请立即复制保存（明文仅此一次）。
5
下次登录
输入手机号 + 密码点击「登录」；或在登录页点击「微信扫码登录」用微信授权（需先在微信开放平台绑定）。忘记密码可联系管理员重置。
注册即送试用额度；余额不足时 API 请求将被拒绝，请先充值再开始调用。
1
进入「我的 API Key」
登录后默认进入「我的 API Key」页，可看到已有 Key 的名称、前缀、状态与创建时间。
2
新建 Key
点击右上角「+ 新建 Key」，输入 Key 名称（如 prod-app）确认。
「我的 API Key」页：新建、查看、停用、删除
3
保存完整 Key
弹窗展示完整 Key（格式 plo_…），点击「复制」或手动保存 —— 完整 Key 只在创建时展示一次，请妥善保管。
Key 明文弹窗：仅此一次展示，务必立即复制
4
日常管理
查看：再次展示明文（用于复制到新环境）；停用 / 启用：临时开关，停用后该 Key 请求被拒绝；删除：不可恢复，建议先停用确认无误再删。
5
接入方式
API 端点为 https://diracai-studio.com/v1，请求头 Authorization: Bearer <你的key>，按用量从余额扣费。
Key 与账户共享余额；请勿把 Key 提交到公开仓库或聊天群。
1
进入「充值」页
点击顶部「充值」标签，输入金额（美元，范围 1 ~ 5000，整数美元）。
充值页：输入金额生成订单，下方为订单记录
2
生成付款订单
点击「生成付款订单」，自动跳转收银台页面。
3
收银台支付
确认订单金额与订单号，在剩余时间内完成付款；订单页自动轮询支付结果，到账后余额即时生效。
收银台：订单金额 + 订单号 + 倒计时
4
到账与订单记录
支付成功余额即时到账并自动返回门户；「充值」页的订单记录可查看历史订单状态，待支付订单可「去支付」或「取消」。
5
查看用量
「用量」页顶部为费用概览（近 3 / 7 / 14 / 30 天可切换，公司账户可筛选子账户），含总花费、请求数与 Token 消耗，下方为日花费趋势、日 Token 趋势、按模型花费明细（Top 10）与最近 100 条用量记录；「余额明细」页查看每笔流水与结余。
用量页：费用概览 + 日趋势 + 按模型明细
共享公司额度模式下，费用由公司余额统一支付，充值入口自动隐藏。
1
注册公司账户
注册时账户类型选择「公司账户」，即可创建子账户、向子账户转账或设置共享额度。
2
创建子账户
进入「子账户」页，填写子账户手机号、密码与初始余额（可选），点击创建；子账户用自己的手机号登录门户。
子账户页：创建、转账、切换计费模式
3
计费模式
每个子账户可选：独立余额（自己充值 / 公司转账，从自身余额扣费）或共享公司额度（费用直接扣公司余额），列表内可随时切换。
4
账户资料
「账户」页可查看账户信息、计费模式与安全设置。
账户页：资料与安全
共享模式下子账户的充值入口隐藏；转入子账户的金额在切换回独立模式后可用。
1
OpenAI 兼容调用（Chat Completions）
端点为 https://diracai-studio.com/v1/chat/completions；全部模型与单价见门户「模型」页（实时列表），或查询 /v1/models。
# OpenAI 兼容
curl https://diracai-studio.com/v1/chat/completions \
-H "Authorization: Bearer plo_你的key" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-4.1",
"messages":[{"role":"user","content":"你好"}]}'
2
Anthropic 兼容调用（claude 系列原生透传）
claude 系列模型走 /v1/messages 入口，原生透传，无需额外配置。
# Anthropic 兼容（/v1/messages 原生入口）
curl https://diracai-studio.com/v1/messages \
-H "Authorization: Bearer plo_你的key" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5",
"max_tokens":1024,
"messages":[{"role":"user","content":"你好"}]}'
3
模型列表与 Responses API
门户「模型」页可查看全部模型、档位与输入 / 缓存 / 输出单价（美元 / 百万 token），也可查询 GET /v1/models；同时支持 OpenAI Responses API（/v1/responses）。
# 查询模型列表
curl https://diracai-studio.com/v1/models \
-H "Authorization: Bearer plo_你的key"
4
Claude Code 使用说明
前置：一个 plo_ 开头的 API Key + 已安装 Claude Code CLI。配置环境变量（claude 模型必须走 /v1/messages 原生入口，不能走 chat/completions）：
# Claude Code 环境变量（写入 ~/.bashrc / ~/.zshrc 可持久化） export ANTHROPIC_BASE_URL=https://diracai-studio.com export ANTHROPIC_AUTH_TOKEN=plo_你的key export ANTHROPIC_MODEL=claude-sonnet-5 # 必须显式指定
5
Claude Code 可用模型
claude-sonnet-5（默认推荐）/ claude-opus-5（最强，配额更严）/ claude-fable-5（轻量）。配置完成后在任意目录运行 claude 即可开始对话。
6
Codex 使用说明
前置：一个 plo_ 开头的 API Key + codex-cli 0.147+（走 Responses API，本平台已兼容）。编辑配置文件（Linux / macOS 为 ~/.codex/config.toml，Windows 为 C:\Users\<用户名>\.codex\config.toml）：
# ~/.codex/config.toml
model = "gpt-5.6-sol"
model_provider = "proxy"
approval_policy = "on-failure"
# 本地压缩（必须保持）：codex 仅当 provider name 恰为 "OpenAI" 时启用
# 远程压缩（/responses/compact 端点，本平台不支持）；其他名称一律本地
# 明文压缩。请勿把 name 改成 "OpenAI"，否则压缩请求会打到平台并被拒。
[model_providers.proxy]
name = "proxy"
base_url = "https://diracai-studio.com/v1"
wire_api = "responses"
env_key = "PROXY_API_KEY"
requires_openai_auth = false
7
Codex 一键配置（macOS / Linux）
下载脚本后运行，按提示输入 API Key，自动写入 config.toml、auth.json 并持久化环境变量（自动备份旧配置）：
首次使用先在终端执行 chmod +x setup_codex.command，然后双击运行；或终端直接 bash setup_codex.command。若提示「无法验证开发者」，右键 → 打开 一次放行即可。
8
Codex 一键配置（Windows）
下载脚本后双击运行，按提示输入 API Key，自动写入 config.toml、auth.json 并设置用户级环境变量（永久生效，自动备份旧配置）：
双击 setup_codex.cmd 即可（PowerShell 弹窗输入 Key）。运行完成后完全退出并重新打开 Codex 桌面应用才会生效。
9
Codex 认证与验证
认证走环境变量（0.147 不读 config 里的 api_key 字段）：export PROXY_API_KEY=plo_你的key（Windows 用 setx PROXY_API_KEY "plo_你的key" 后开新终端）。验证：codex exec --model gpt-5.6-sol "Reply with exactly: OK"。
10
Codex 可用模型
gpt-5.6-sol / gpt-5.6-luna / gpt-5.6-terra（最新响应式）、gpt-5.5 / gpt-5.4 / gpt-5.3-codex、gpt-5-mini；chat 类：gpt-4.1 / gpt-4o / gpt-4o-mini / gemini-3.6-flash / kimi-k3。工具调用（shell 等）对全部模型可用。
11
计费与限额
按实际用量从账户余额扣费：输入 / 输出 Token 分别按模型单价计价，缓存命中（cached）的输入 Token 按更低的缓存单价计费（单价见门户「模型」页）；余额不足时请求将被拒绝。流量日志与花费可在「用量」页查询。
接入代码库 / IDE（Copilot、Claude Code、Codex 等）时，将 Base URL 指向上述 v1 端点即可。