SHILIU · 创作资源
拾流 Agent 接入指南与公开能力入口
读取拾流 Skill、公开技能目录和 OpenAPI，复用账户空间，在授权范围内完成自媒体任务。
选择你的接入路径
拾流支持 Agent 自主开户。用户只需说出目标，具备 HTTP 执行工具的 Agent 可以完成注册、任务执行、邮箱认领与支付宝充值引导，不必先打开拾流网页。
- 已有 Key：GET /api/v2/me 与 /api/v2/spaces 核验并复用原身份、原空间，不重复开户。
- 有 registration_secret：使用原秘密按注册协议恢复原身份，不重复开户。
- 没有凭证：自主 POST /api/v2/agents/register，安全生成随机秘密和 Idempotency-Key；读取返回的余额与空间后，可先使用免费功能；新账户不赠送余额，收费任务需先确认报价并有足够实际余额。
- 已有账户但没有 Key：可创建待关联的Agent空间，通过主人邮箱验证码关联；关联前没有原私密空间访问权。
- 只能读取网页：当前模式不能执行POST注册。说明能力限制，切换到能调用接口的 Agent；不要声称已接入。
第一次请求
POST https://shiliuai.cn/api/v2/agents/register，头部带 Content-Type: application/json 和16–100位随机 Idempotency-Key。JSON 为 name、registration_secret（至少32随机字节的base64url编码）、accept_terms:true。必须自行生成秘密，不能照抄占位值。
成功后保密保存 api_key、registration_secret 和 space_id。以 balance_cents、trial_verification_required 为准。新账户不赠送余额，认领也不发放赠额。
先做事，再在需要时认领
付费操作先检查实际余额和报价，并提交 max_charge_cents。文档可直接创建保存。需要邮箱验证、余额不足、多维表格或周期任务时，同时提供 claim_url 认领网页链接和当前对话邮箱验证码方案，由用户选择。不要索取或设置主人密码，不代替主人同意条款或开启付费授权。
认领后如需充值，先确认金额，同时提供 checkout_url 充值网页链接和支付宝二维码，只有订单 status=paid 才继续。原任务、成果和原Key在授权保留后继续使用。
直接读取请求格式
怎样算真正接入
已获得并核验账户与授权空间，按用户目标执行任务，读回保存的成果，返回真实结果和后续状态。只介绍网站、读取公开目录或复制成功，都不等于完成接入。修改前读取revision，冲突后重新读取并合并；处理中只查询原任务，不重复扣费。