API Key 在 CutAI 设置页创建。完整 Key 只展示一次，请立即保存。 所有 API 请求都需要带 Bearer Token： 
Authorization: Bearer ck_test_xxxxxxxxxxxxx
生产环境生成的 Key 会使用 ck_live_ 前缀，开发环境使用 ck_test_ 前缀。
不要把 API Key 放进浏览器前端代码、移动端包或公开仓库。API Key 应只在你的服务端使用。

​
权限范围

API Key 绑定到创建它的 CutAI 用户，只能访问该用户自己的任务、job 和资产。

​
接入检测

Agent 可以在创建任务前调用 GET /api/ping。该接口只接受 API Key 鉴权，返回当前认证到的用户和 Key ID。 
curl "$CUTAI_BASE_URL/api/ping" \
  -H "Authorization: Bearer $CUTAI_API_KEY"

{
  "ok": true,
  "service": "cutai-studio",
  "authProvider": "api_key",
  "userId": "usr_xxx",
  "apiKeyId": "apk_xxx"
}

​
积分余额

使用 GET /api/query/credits 在提交任务前查询当前剩余积分。 
curl "$CUTAI_BASE_URL/api/query/credits" \
  -H "Authorization: Bearer $CUTAI_API_KEY"

{
  "creditBalance": 960,
  "currency": "credits",
  "userId": "usr_xxx",
  "apiKeyId": "apk_xxx"
}