> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 异步作业与轮询

> 了解基于任务的写入、任务的终止状态，以及哪些资源持有持久状态。

# 异步作业与轮询

大多数写入操作都是异步的。

## 会立即返回什么

这些端点会接收工作并返回你可以轮询的 ID：

* `POST /projects`
* `POST /projects/{projectId}/tasks/stem-separation`
* `POST /projects/{projectId}/tasks/lyrics-sync`
* `POST /projects/{projectId}/exports`

## 需要轮询什么

* 轮询 `GET /tasks/{taskId}` 以获取执行状态和填充后的任务输出。
* 读取 `GET /projects/{projectId}` 以获取长期存在的项目状态。
* 读取 `GET /exports/{exportId}` 以获取最新的导出下载 URL。

## 实用的轮询模型

1. 发起一次变更操作并保存返回的 ID。
2. 轮询 `GET /tasks/{taskId}`，直到任务到达终止状态。
3. 通过 ID 重新读取持久资源，而不是信任过期的缓存状态。
4. 对于下载，在你准备使用该 URL 时再获取 `GET /exports/{exportId}`。

## 为什么这很重要

* 任务状态是执行时间线。
* 项目状态是持久的真实来源。
* 导出下载 URL 应被视为可刷新，而不是永久不变。