ZZD public AI gateway · zzd_public_ai_gateway_v3
Resource: 使用作品中的服务 / Quick start
Canonical map: https://zzd.show/docs/ai/map.json
Full handbook: https://zzd.show/llms-full.txt
REST capabilities: https://zzd.show/api/v1/capabilities/

# 使用作品中的服务 / Quick start

需要：原作品地址、要完成的动作，以及已绑定的服务或数据名称。
只读本次动作需要的契约，无需通读完整手册。

1. 在原作品BaaS面板或运行上下文核对已有绑定、数据名称和允许动作，仅用已有权的能力；缺项按baas契约处理，不猜业务接口。
2. 只读本次动作的space-sdk/baas说明。window.AppRuntime注入当前作品上下文；仅明确给出spaceId时用SpaceClient，不手工传递或输出服务密钥。
3. 验证成功、空值、拒绝和错误后报告真实结果。管理API先读 https://zzd.show/api/v1/capabilities/；运行权限不能替代本人管理权限。公开、删除或新增费用须有对应授权；绑定不等于任意provider资格。

凭据只发已核对的精确同源 https://zzd.show/api/v1/ 或POST https://zzd.show/mcp/v1/，不随重定向转发；网页管理沿用本人session/CSRF，不能用作bearer的认证fallback。阅读不授予权限。

作品反馈须明示PK/id、作品号public_id、正式链接与实际状态，不能只给名称或Run/Edit链接。优先复制data.delivery.feedback_line；缺项GET原作品补取，不重建或另问授权。这是普通用户回复要求，不是manifest字段。
私有注明需原权限；批量逐项、修复沿用原标识；严格JSON不增加字段，由普通回复呈现。

按动作细读：
- 服务与后端绑定：https://zzd.show/docs/ai/branch/baas/
- 作品运行接口：https://zzd.show/docs/ai/branch/space-sdk/