执行工作流

POST

/v1/workflows/execute

执行预设工作流，自动串联多个任务。

可用工作流：

viral_narration — 二创解说（学习→文案→剪辑→合成→可选模板）

fast_narration — 原创文案（快速文案→可选理解→剪辑→合成→可选模板）

video_post_processing — 视频后处理（OCR→可选擦除→可选同步）

建议流程：

POST /v1/workflows/validate — 校验素材

POST /v1/workflows/estimate — 预估费用

POST /v1/workflows/execute — 执行

GET /v1/workflows/executions/{id}/stream — 查看进度

请求参数

Authorization

API Key

在 header 添加参数

app-key

示例：

app-key: ********************

Header 参数

Body 参数application/json必填

示例

{
    "workflow_type": "string",
    "params": {
        "property1": "string",
        "property2": "string"
    },
    "async_mode": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/workflows/execute' \
--header 'x-code;' \
--header 'app-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "workflow_type": "string",
    "params": {
        "property1": "string",
        "property2": "string"
    },
    "async_mode": true
}'

返回响应

🟢200OK

application/json

Successful Response

Bodyapplication/json

示例

{
    "code": 10000,
    "message": "Success",
    "data": {
        "execution_id": "string",
        "workflow_type": "string",
        "status": "string",
        "message": "string",
        "estimated_points": 0
    }
}

🟠422Parameter Error

修改于 2026-09-08 06:26:27

获取工作流详情

获取工作流执行状态