本文档从整体接入视角介绍 SU.RUN 存储服务，包括需要提前准备的参数、建议由服务端统一承接的能力，以及适合在早期统一的治理项。
先在控制台准备接入域名、访问密钥和测试存储桶。没有这一步，后续 SDK 文档都无法落地。
正式项目建议由服务端统一处理鉴权、路径规划、授权链接和错误映射，而不是让浏览器直接掌握长期凭证。
存储桶命名、文件路径、日志 requestId、自定义域名和 AI 目录规划都属于长期治理问题，越早统一越省事。
重点关注上传下载体验、进度展示、错误提示，以及是否通过后端签发授权地址，不直接持有长期密钥。
重点承接鉴权、文件路径生成、授权接口、错误结构和日志 requestId，把存储能力封装进业务系统。
重点关注数据集目录、模型版本、结果回写、任务环境变量和长任务下载上传策略，让训练与推理都能稳定复用存储能力。
重点关注域名策略、证书、生命周期、环境隔离、访问边界和长期治理，不让存储从第一天就进入混乱状态。
负责开通组织能力、准备访问密钥、测试存储桶和必要的业务域名。这个阶段的重点是把接入参数和测试范围准备齐。
负责 SDK 初始化、上传下载封装、文件路径生成、授权接口、元数据整理和错误结构统一。正式项目的关键接入逻辑建议先在这里统一。
浏览器、App、后台管理页、Jupyter、GPU 容器或批处理任务都属于消费层。它们应只拿到自己需要的短期能力，不直接掌握长期访问边界。
包括 requestId、日志记录、对象命名规范、环境隔离、自定义域名、证书、生命周期和 AI 目录治理。这个层决定系统能不能长期维护。
因为多数接入问题不只在代码本身，还与边界和流程有关。本文档会先帮助团队整理整体实施思路。
快速开始文档更适合完成第一步上手，这篇文档更适合整理长期接入、维护和团队协作方式。
文档中心帮助你完成接入，客户服务页帮助你了解采购、支持与服务信息。
