文档中心提供从控制台准备、服务端接入、上传下载授权、文件路径规划到上线治理的完整实施路径，适用于正式业务集成、AI 任务接入和长期维护场景。
文档中心不仅覆盖 SDK 初始化，也重点说明正式上线时更关键的接入要点，包括权限统一、前端上传边界、文件路径规划，以及 AI 任务中的模型、数据集和结果文件读写规范。
这套文档围绕 SU.RUN 当前提供的服务能力，按控制台准备、业务接入、代码实现和生产安全四个层面组织内容，可作为正式接入手册使用。
从控制台准备接入参数，到本地验证、服务端接入，再到业务系统完成文件读写。
了解 SU.RUN 当前开放的接入方式、鉴权边界、返回结构与服务端封装建议。
提供 JavaScript、Python、Go 三类常用接入示例，便于团队快速落地和改造。
针对常见 AI 环境整理数据读取、模型同步与输出回写方法。
可按角色或项目类型直接选择阅读路线。每条路线都按准备、验证和上线三个阶段组织，便于团队快速建立一致的实施顺序。
适合训练、推理、知识库和批处理场景。建议先阅读 AI 环境接入说明，再结合 AI 训练数据与结果回写规范，最后回到存储接入快速开始和代码示例完成真实工作流。
从这条路线开始适合素材上传、用户附件、业务文件归档。前端只拿临时授权，真正的访问密钥放在服务端。
适合媒体转码、AI 训练数据拉取、批处理作业，把存储服务作为统一素材仓与输出仓。
适合 RunPod、训练容器、推理服务、知识库任务，让模型权重、数据集和结果文件走统一路径。
不要一开始就把正式业务文件导进来。先用测试桶完成一次上传、列目录、下载和删除，确认网络、权限和命名规则都正确，再上生产。
浏览器、App、小程序和第三方前端环境不应长期保存访问密钥。所有直传和下载都应由业务服务端签发短期授权或下载地址。
产品或项目负责人建议优先阅读文档中心和存储接入快速开始，先明确控制台参数准备、上传下载能力范围，以及上线前必须完成的权限收口。
后端工程师建议重点阅读接口说明和代码示例，将上传授权、下载授权、文件路径规划、错误格式和请求编号统一封装到服务层，便于前端、移动端和任务系统复用。
AI 训练、推理和知识库任务建议优先阅读 AI 环境接入说明，再结合代码示例完成工作流接入。该场景的重点通常不在 SDK 初始化，而在模型、数据集、日志、结果目录和回写路径的统一规划。
这套文档不仅提供参数说明，也是一份适合产品、前端、后端、运维和 AI 团队共同参考的接入手册。可根据业务目标选择对应章节。
建议至少阅读存储接入快速开始和接口说明。影响正式落地效果的不仅是 SDK 初始化，还包括文件路径规划、授权边界、控制台参数准备和生产安全约束。
正式项目通常需要由业务服务端统一处理鉴权、路径规划、审计和错误映射，而不是让浏览器直接接触长期密钥。
文档中心帮助你完成接入，客户服务页帮助你了解采购、支持与服务信息。
