# 工作流 API

> Documentation Index / 文档总索引  
> https://x2v.light-ai.top/llms.txt  
> Source: https://x2v.light-ai.top/api-docs#workflow-api  
> Locale: zh-CN  
> 本页内容已为 Agent/LLM 阅读优化。

发现工作流契约，发起运行，流式或轮询状态，并取得输出。

## 发现

先调用 `GET /api/v1/workflow/list`，再读取 `GET /api/v1/workflow/{workflow_id}` 和 `/inputs`。不要用任务模型规格猜测工作流输入。

## 运行

按工作流声明的输入调用 `POST /api/v1/workflow/{workflow_id}/runs`，并保存 `run_id`。通过 `/runs/{run_id}` 或 `/runs/{run_id}/stream` 获取状态，再从 `/runs/{run_id}/outputs` 取结果；取消操作使用文档中的运行或节点取消接口。

## 鉴权与恢复

工作流发现和执行当前均需要 Bearer API 鉴权。连接中断后查询已有 `run_id`；不能因为流结束就发起第二次运行。

## Related / 相关主题

[quick-start](/api-docs/quick-start.md) · [authentication](/api-docs/authentication.md) · [model-discovery](/api-docs/model-discovery.md) · [task-api](/api-docs/task-api.md) · [errors](/api-docs/errors.md)

OpenAPI: https://x2v.light-ai.top/openapi.json · Live models: https://x2v.light-ai.top/api/v1/model/list · Skill: https://github.com/ModelTC/LightX2V-Skills
