版本

API 版本 2026-10-affable-towhee

Lingara API 按名称区分版本，格式为 yyyy-mm-adjective-noun。每个路径中的 /v1 永远不变：一次调用接受什么、返回什么，由版本决定。

客户端的版本

客户端会固定在创建时的当前版本上，使用其任一访问令牌且不带版本请求头的调用，都按该版本应答。客户端的所有者可以在集成页面（地址为 app.getlingara.com/admin）把它重新固定到另一个受支持的版本；它的访问令牌从下一次换取起使用新版本。

单次调用的版本

在调用中发送 Lingara-Version: <id>，即可用该版本代替固定的版本；响应会注明所用的版本。开发版本只能通过这种方式访问，并且可能随时变更，恕不另行通知。

版本的生命周期

可以固定的版本为 supported，维护时间更长的版本为 lts。deprecated 版本仍会应答，每个响应都带有 Deprecation 和 Sunset 请求头，并且在被弃用后至少 90 天才会结束。discontinued 版本会以 410 和代码 api_version_discontinued 拒绝。

已发布的版本

如译文与英文参考文档不一致，以英文参考文档为准。