用途:该技能用于与 CreatorSignal API 交互,提交视频创意以触发 AI 验证,并获取评分与结论,同时管理频道、Webhook 和配额。
资源模型:Channel(关联账号的 YouTube 频道,创意按频道提交)、Idea(含标题与分类,提交后触发 AI 验证)、Validation(验证结果,含 0-100 分、go/refine/kill 结论及结构化报告)、Webhook Endpoint(接收验证事件的 HTTPS 地址,可免轮询)。
认证:API 密钥格式为 cs_live_<prefix>_<secret>,以 Bearer 令牌传递。密钥在账号 Settings > API Keys 创建,完整密钥仅创建时显示一次,需安全保存。变更操作前应先验证密钥:curl -s -o /dev/null -w "%{http_code}" https://app.creatorsignal.io/api/v1/me -H "Authorization: Bearer $CS_API_KEY",200 有效,401 无效/撤销/过期。
基础地址:所有端点位于 https://app.creatorsignal.io/api/v1/。
核心流程:验证认证(GET /api/v1/me 返回 200)→ 检查配额(quota.remaining > 0)→ 获取频道(GET /api/v1/channels)→ 提交创意(POST /api/v1/ideas,含 title、category、channel_id)→ 轮询结果(GET /api/v1/ideas/{id}/validation,202 进行中按 Retry-After 等待,200 完成)→ 展示结论、评分、报告摘要与建议。轮询可用脚本 bash scripts/poll-validation.sh <idea_id>。
错误处理:401 unauthorized/key_revoked/key_expired、402 quota_exhausted(滚动 30 天窗口重置或升级)、404 not_found、422 validation_error、429 rate_limited(按 Retry-After 等待)。错误响应有两种结构:401/404 为 {"error": {"message": "...", "status": 404}};402/422/429 为 {"error": {"code": "...", "message": "...", "details": {...}}}。
执行规则:变更前先验证认证;POST /ideas 前检查配额;遵守 Retry-After 头,勿用固定等待;轮询上限 12 次(通常 30-90 秒完成,约 2 分钟仍待处理则报告状态);输出中不得回显完整密钥,仅显示 cs_live_<prefix>_***;用 jq 解析 JSON;POST/PATCH 需设置 Content-Type: application/json。
组合模式:快速检查(认证→配额→报告剩余验证次数)、完整验证、Webhook 设置(认证→创建端点→保存签名密钥→测试 ping→验证投递)、批量审查(按 status=validated 列出创意并汇总结论与评分)、带 Webhook 的创意提交。
限制:完整端点规范、请求/响应模式与参数详见 app.creatorsignal.io/api;技能内参考 references/api-spec-guide.md(验证状态机与轮询)和 references/webhook-patterns.md(Webhook 设置、签名、事件类型)。具体收费与价格资料未提供。