感谢大家阅读本篇指南。
钛盘支持通过 CLI 上传文件，这主要是方便用于某些特定环境：在 Linux 服务器上，通过命令行便利地上传文件到钛盘。因此，从设计上来说，它并不是一个我们通常认为的 API，不适用于自动化场景，比如集成到博客，或者应用中。

整个 CLI 文件上传使用流程分为以下 2 点：

1，登录钛盘，然后在上传文件的界面，选择好有效期后，进入选择上传文件的环节，此时就可以看到选项，使用 CLI 来上传文件。在这个地方，系统会为文件上传的 CLI 命令分配足够的参数，比如如果当前是在文件夹中进行上传，那么生成的 CLI 命令会包含了文件夹的参数。

2，在服务器上执行 CLI 上传命令，只需要修改命令中关于文件位置部分的参数，那么对应的文件就会上传到对应的中继服务器，并最终移送到存储节点。

执行结果：

1，Upload Complete.
完成了上传，并会给出下载地址。

2，Invalid requests.
上传失败，因为上传请求中的参数不正确。

3，This account(or IP) has reached the maximum file upload limit for a single day. Please retry tomorrow.
上传失败，超出配额。目前上传到临时空间，每天每个账户可以拥有 100GB 的配额，超出这个部分时就会提示此错误。上传到私有空间不会有这个限制。

4，File Size Exceeds Limit.
超出了单个文件的大小限制，目前是 50GB。

5，If you do not have enough private storage space, please purchase a private space expansion pack.
上传到私有空间的文件，已经超过了账号所持有的私有空间容量。

6，Server busy.
系统超载，请稍后再试。

7，This Token has been unavalible.
Token 中没有包含有效的用户信息，无效。

关于终端标识（标识，Token）的有效期

这是大家疑问比较集中的地方，即标识的有效期到底是多长？这个问题很简单：1年之后无访问。
要理解这个问题，首先需要说一下标识的作用。

标识的设计目的，是为了标识用户终端而存在的，它会在浏览器初次访问时，通过钛盘的 API 申请并获得。每个浏览器都是都一不二的，因此上面说过，只有在登录钛盘之后，在文件上传时，才能生成上传命令。在钛盘上的一切操作都会绑定到这个标识。

但是，标识并不会一直绑定到具体某个用户。
比如说，当你在浏览器中退出钛盘的登录之后，标识并不会发生改变，但是标识所标记的用户已经发生了改变。这不会影响到下一位登录的用户。下一个用户登录时，也会应用此标识来在钛盘进行各种操作。

因此，如果你在使用命令行上传命令上传文件结束之后，得到了 “This Token has been unavalible” 的反馈，那么就只有一种情况，上传命令绑定的标识的用户，在浏览器上已经退出了登录。

命令行上传可以被视为 API 吗

因人而异，但总的来说，它不适合作为 API 使用。

首先，尽管它确实包含了用于文件上传的 URL，也给出所需的参数以完成功能。但是本质上来说，它是为命令行操作而设计的，在很多场景上没有作考虑，比如大家最长遇到的 This Token has been unavalible 问题，就是没有理解它的工作机制导致的。其次，钛盘仍然可能会根据功能对这个上传命令做出改进和调整，因此它是不稳定的。

当然，如果你已经彻底理解了用法，也不是不能作为一种 API 来使用，只要方法正确，那么就能获得正确的结果。

将来会有专门的 API 吗

将来会有。