运行工作流

操作场景

本章节指导用户通过调用API运行工作流。

前提条件

• 已开通数据智能平台（DataArts Platform）并加入工作空间并具有相应的权限，并根据开通区域确定调用API的Endpoint，详细信息请参见地区与终端节点。
• 当您使用IAM认证方式完成认证鉴权时，需要获取用户AK/SK，然后使用AK/SK进行签名认证，具体操作请参考认证鉴权。
• 已在应用开发中完成工作流开发，并已完成生产部署。

涉及接口

运行应用涉及以下接口：运行应用。

运行工作流

1. 获取接口相关信息。

   URI格式：POST /v1/{project_id}/applications/{application_id}/run

   详情请参见运行应用。

2. 查看请求示例。

   POST https://{Endpoint}/v1/ddaac8e6a4334e6998b7e1e424c0ff82/applications/f9eed8ea-acb6-401a-b33a-19e6bee21659/run
   {
       "query": "翻译“我们居住在地球村”"
   }

3. 查看响应示例。

   {
       "debug": false,
       "run_id": "11bfdc34-f3a7-40b7-ba92-f44d23cd0800",
       "message_id": "11bfdc34-f3a7-40b7-ba92-f44d23cd0800",
       "session_id": "673fb33c-b5a0-4db0-84a5-b72f8c74ff4a",
       "is_finished": true,
       "data": {
           "status": "succeeded",
           "outputs": {
               "output": "We live in the global village."
           },
           "elapsed_time": 3.67,
           "total_steps": 4,
           "create_date": "2026-10-08T10:46:25Z",
           "finish_date": "2026-10-08T10:46:28Z",
           "metadata": {
               "usage": {
                   "input_tokens": 57,
                   "output_tokens": 158,
                   "total_tokens": 215,
                   "cached_tokens": 0,
                   "reasoning_tokens": 149
               }
           }
       },
       "version": "1.0"
   }

   请求异常时，请参见错误码。