接入与发现
接入与鉴权
使用正式 PerchanceAI 账户的 API Key 或委托 OAuth access token 接入。
接口
GUIDE
Authorization: Bearer <credential>鉴权与 Scope
Authorization: Bearer <credential>；仅接受正式账户 API Key / OAuth。
登录正式账户，打开设置 → API & MCP，为 API Key 命名并在创建成功弹框复制；完整密钥只展示一次。
pca_live 密钥保存在服务端环境。委托客户端使用正式授权的 pca_oauth access token。凭据须具备接口 scope，API Key 或 OAuth 只使用所属 PerchanceAI 账户的积分。
凭据仅通过 Authorization header 传递，不进入 URL、日志或 storage。受保护 API 不回退到浏览器 Cookie。匿名签发已关闭，历史 pca_anon 令牌不能调用业务接口。
示例查询账户积分，需要 credits:read。模型目录与 MCP 发现保持公开。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | header | 是 | 正式账户的 Bearer pca_live_... 或 Bearer pca_oauth_...。 |
curl --request GET \
--url 'https://api.perchanceai.art/api/v1/developer/credits' \
--header 'X-App-Id: perchanceai' \
--header 'X-Request-Id: docs-example' \
--header 'Authorization: Bearer <formal_account_credential>'
响应 HTTP 200
以下为说明响应结构的示例，并非实时 API 响应。示例数值和 USD 不代表固定定价或资金余额。空字段省略。
REST 成功响应为 success、code、message、request_id 和 data；下表描述 data。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
mode | string | 是 | 正式账户凭据返回 formal。 |
balance_credits / available_credits / remaining_credits | integer | 是 | 当前三项返回同一账户积分值，单位依实际返回的 currency。 |
currency | string | 是 | 账户货币配置；不得据此推断资金余额或固定定价。 |
{
"success": true,
"code": "OK",
"message": "OK",
"request_id": "docs-example",
"data": {
"mode": "formal",
"balance_credits": 120,
"available_credits": 120,
"remaining_credits": 120,
"currency": "USD"
}
}
相关错误
401 — DEVELOPER_TOKEN_REQUIRED401 — DEVELOPER_TOKEN_INVALID / DEVELOPER_TOKEN_EXPIRED / DEVELOPER_TOKEN_REVOKED403 — DEVELOPER_SCOPE_INSUFFICIENT
缺 bearer 返回 REQUIRED；无效凭据（包括历史匿名令牌）返回 INVALID。过期或撤销凭据使用对应错误码。
{
"success": false,
"code": "DEVELOPER_TOKEN_REQUIRED",
"message": "A developer bearer token is required.",
"request_id": "docs-example"
}