核心用法
Theta EdgeCloud Skill 是一个面向去中心化 GPU 云平台的 API 优先运行时脚手架，专为 AI 推理、模型部署与媒体处理场景设计。用户通过环境变量注入凭证，即可调用 Deployments API、On-demand 模型推理、Dedicated 推理端点及 Theta Video 四大能力域。
凭证模型采用命令级作用域隔离：部署/项目类命令仅需 THETA_EC_API_KEY + THETA_EC_PROJECT_ID；按需推理需 THETA_ONDEMAND_API_TOKEN；专属推理端点需 THETA_INFERENCE_ENDPOINT 配合 Basic Auth 或 Bearer Token。这种细粒度设计避免了过度授权。
安全设计方面，运行时明确禁止本地 Shell 执行、本地文件读取及 localhost RPC 调用；付费/变更类操作受 THETA_DRY_RUN=1 开关保护；密钥解析优先使用 OpenClaw 秘密提供者，环境变量仅作 fallback。
显著优点
- OpenAI 兼容端点：Dedicated 推理提供标准
/v1/models与/v1/chat/completions接口，降低迁移成本 - 弹性容量策略：
vm_gt1优先回退至vm_gt2或 V100，配合 1-2 分钟热身重试机制应对端点冷启动 - 服务发现增强：
theta.ondemand.listServices区分 live/catalog 来源，失败时携带原因字段，避免静默空返回 - 智能超时调整：
step_video等视频任务根据帧率/分辨率自动扩展轮询超时，减少误判
潜在局限
- 配额门槛：Developer Plan（约 $20 预充值）是解锁完整 GPU 部署功能的硬性前提，新用户易遇 404/502 误导
- 端点非即时就绪：Dedicated 推理创建后需主动重试探测，不能假设立即可用
- 账户管理隔离：Org/Project 成员邀请、充值历史等需走 Web 仪表盘会话认证，不在 API 覆盖范围
- 多凭证复杂度：四组凭证体系对新手存在认知负担，需依赖
theta.auth.capabilities与theta.setup辅助
适合人群
- 寻求去中心化 GPU 资源的 ML 工程师与 AI 应用开发者
- 需要 Flux/Stable Diffusion/Step-Video 等文生图/视频能力的创作者
- 已在 Theta 生态有 Project/Org 上下文，希望自动化部署管道的团队
常规风险
- 凭证泄露：
THETA_EC_API_KEY等长期密钥若写入版本控制，可导致资源滥用与账单损失 - 配额误判：默认零配额状态下尝试创建 GPU 部署会失败，需先完成充值与配额提升
- 超时配置不当：未采用 SDK 推荐的动态超时策略时，视频生成任务易被本地客户端过早判定失败
- Dry-run 遗漏：生产环境未启用
THETA_DRY_RUN验证即执行批量删除/停止操作，可能引发服务中断