FacePick API 文档
当前本地集成契约；不是旧版v1服务。Cookie控制台与Bearer应用接口分开鉴权。不要在此页输入密钥。
角色详情
GET /api/developer/faces/:faceIdAuthorization: Bearer（应用私有API Key）；POST使用Content-Type: application/json。网页登录Cookie不能代替应用Key。
请求参数
faceId：从公开角色搜索取得的UUID，不是样例名称或私有Asset ID。
返回结果
data为单个公开资产，包含当前公开策略；查询不授予使用或训练权。
成功：{data, requestId}；失败：{code, message, requestId, details?}。HTTP失败不要当作业务成功。
错误处理
401 UNAUTHENTICATED；404 NOT_FOUND：未发布、已暂停或不存在。 服务内部错误返回安全错误，不显示数据库诊断。记录requestId用于排查。
服务端 JavaScript 示例
先下载客户端，在私有进程配置环境变量。许可使用会扣次；只用自己的有效许可与允许范围。FACEPIC_USE_IDEMPOTENCY_KEY须预先保存，网络失败重试不能换新值。
import {FacePickClient} from './facepick-client.mjs';
const client = new FacePickClient({
baseUrl: process.env.FACEPIC_BASE_URL ?? 'http://127.0.0.1:3110',
apiKey: process.env.FACEPIC_API_KEY,
});
try {
const result = await client.getFace(process.env.FACEPIC_FACE_ID);
console.log(JSON.stringify({requestId: result.requestId}));
} catch (error) {
console.error(JSON.stringify({code: error.code ?? 'CLIENT_ERROR', status: error.status ?? 0, requestId: error.requestId ?? null}));
process.exitCode = 1;
}