抖音AI生成任务接口文档

建议查看旧版文档及在线测试更加方便 https://yutangxiaowu.cn/step/api/aic.html

接口概述

本接口用于处理基于文本（ugc_text）和媒体资源（图片/视频URL）的AI生成任务，支持任务提交（process/image_process/video_process）和任务查询（query）两类操作，适配抖音生态的媒体资源处理流程。

接口信息

请求地址：/api/ai/douyin

请求方式：GET/POST（推荐POST）

请求参数

公共参数

参数名	类型	必填	说明
type	string	否	操作类型，可选值： - process：图文处理 - image_process：纯图片处理 - video_process：视频处理 - query：任务查询
model	string	否	模型标识，格式为`模块名/功能名`，仅支持`SuiBian/process`
ugc_text	array/string	创建任务时必填	文本内容数组（任务提交时必填，query类型除外）；URL传参时需为URL编码后的JSON字符串
task_id	string	查询任务时必填	任务ID（query类型必填，其他类型可选）
url	string	视情况	媒体资源URL，多个用英文逗号分隔； - process/image_process：图片URL - video_process：视频URL（必填）

ugc_text参数格式

ugc_text为JSON数组，数组内每个对象结构如下：

字段名	类型	必填	说明
type	number	否	类型，默认值为2
content	string	是	文本内容
full_word	string	否	完整文本（非image_process类型必填）
示例（JSON格式）：

1. 参数校验逻辑

ugc_text为空且无task_id时，返回400（缺少ugc_text参数）；

ugc_text数组中每一项必须包含content字段，非image_process类型需包含full_word字段；

model格式必须为模块名/功能名，且模块名仅支持SuiBian；

video_process类型必须传入url参数，且url不能为空；

url参数多个值时，需用英文逗号分隔，且不能为空值。

2. 媒体资源上传逻辑

图片/视频URL会先通过Attachments工具类进行签名获取上传凭证；

调用web_upload/web_upload_video接口将资源上传至抖音服务器；

上传成功后生成resource_list（包含资源URI、尺寸、类型等信息），传入SuiBian.process方法处理。

3. 不同类型任务处理

类型	处理逻辑
process	处理图文混合内容，上传图片生成resource_list，调用SuiBian.process
image_process	仅处理图片内容，resource_list中faceCount设为0，调用SuiBian.process（传Image标识）
video_process	上传视频生成resource_list（包含视频元信息），调用SuiBian.process
query	根据task_id查询任务状态/结果，调用SuiBian.query

{ "type": "process", "model": "SuiBian/process", "ugc_text": [ { "type": 2, "content": "string", "full_word": "string" } ], "url": "string" }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

示例

{
    "code": 200,
    "msg": "请求成功",
    "data": {
        "task_id": "7611130037182660627"
    },
    "api_version": "1.0.0",
    "timestamp": 1772100247.228,
    "created": 1772104305
}

抖音suibian AI生图/视频-创建任务

抖音AI生成任务接口文档

建议查看旧版文档及在线测试更加方便 https://yutangxiaowu.cn/step/api/aic.html

接口概述

接口信息

请求参数

公共参数

ugc_text参数格式

1. 参数校验逻辑

2. 媒体资源上传逻辑

3. 不同类型任务处理

请求参数

请求示例代码

返回响应

抖音suibian AI生图/视频-创建任务

抖音AI生成任务接口文档#

建议查看旧版文档及在线测试更加方便 https://yutangxiaowu.cn/step/api/aic.html#

接口概述#

接口信息#

请求参数#

公共参数#

ugc_text参数格式#

1. 参数校验逻辑#

2. 媒体资源上传逻辑#

3. 不同类型任务处理#

请求参数

请求示例代码

返回响应

抖音AI生成任务接口文档

建议查看旧版文档及在线测试更加方便 https://yutangxiaowu.cn/step/api/aic.html

接口概述

接口信息

请求参数

公共参数

ugc_text参数格式

1. 参数校验逻辑

2. 媒体资源上传逻辑

3. 不同类型任务处理