Skip to main content
本页是从「我已经有 sk- 密钥」到「我已经把工作流输出存到本地」 之间最短的一条路径。三次调用:
  1. POST /r/workflows/slug/{slug}/run —— 提交任务。返回 202 Acceptedtask_id;任务异步执行,所以不要断言为 200 状态码。
  2. GET /r/tasks/{taskId}/events(SSE)或 GET /r/tasks/{taskId} (轮询) —— 等待完成。
  3. GET /r/tasks/{taskId}/result —— 获取下载 URL。
如果还没有 sk- 密钥,参见 生成 API 密钥

查询工作流

工作流的 parameters 数组告诉你 run 请求里需要传哪些键。
使用 slug@version(例如 text-to-image@2)可以锁定到指定的 工作流快照

端到端:SSE

推荐路径。进入终态后流自动关闭。

端到端:轮询

当 SSE 不方便时使用 —— 受限网络、超时较短的 Serverless 函数、 不需要实时进度的批处理。

接下来读什么

订阅任务事件流(SSE)

完整的事件类型参考和兜底策略。

上传输入文件

含文件参数的工作流需要从预签名端点拿到 file_key

调用容器服务

访问托管在团队代理上的长时运行服务。

Webhooks

以推送方式接收终态事件,无需保持流式连接或轮询。