标签 剪映API 下的文章

GET_URL API 接口文档

接口信息

POST /openapi/capcut-mate/v1/get_url

功能描述

提取链接。该接口用于提取输入内容中的链接信息，用于多值返回变成单值返回。

更多文档

📖 更多详细文档和教程请访问：https://docs.jcaigc.cn

请求参数

{
  "output": "[魂牵梦萦https://sf.com；中国人https://jcaigc.cn],\"[]\""
}

参数说明

参数名类型必填默认值说明
outputstring✅-提取内容

参数详解

output
  • 类型: string
  • 说明: 需要提取链接的内容
  • 示例: "[魂牵梦萦https://sf.com；中国人https://jcaigc.cn],\"[]\""

响应格式

成功响应 (200)

{
  "output": "[魂牵梦萦https://sf.com；中国人https://jcaigc.cn],\"[]\""
}

响应字段说明

字段名类型说明
outputstring提取结果

错误响应 (4xx/5xx)

{
  "detail": "错误信息描述"
}

使用示例

cURL 示例

1. 基本使用
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_url \
  -H "Content-Type: application/json" \
  -d '{
    "output": "[魂牵梦萦https://sf.com；中国人https://jcaigc.cn],\"[]\""
  }'

错误码说明

错误码错误信息说明解决方案
400output是必填项缺少output参数提供有效的output参数
500提取链接失败内部处理错误联系技术支持

注意事项

  1. 参数要求: output参数为必填项
  2. 返回值: 当前版本直接返回输入的内容，不做额外处理

工作流程

  1. 验证必填参数（output）
  2. 调用服务层处理业务逻辑
  3. 返回处理结果

相关接口

📚 项目资源
GitHub项目名称: capcut-mate

GET_TEXT_ANIMATIONS API 接口文档

接口信息

POST /openapi/capcut-mate/v1/get_text_animations

功能描述

获取文字出入场动画列表，返回所有支持的且满足条件的文字出入场动画。支持根据动画类型（入场、出场、循环）和会员模式（所有、VIP、免费）进行筛选。

更多文档

📖 更多详细文档和教程请访问：https://docs.jcaigc.cn

请求参数

{
  "mode": 0,
  "type": "in"
}

参数说明

参数名类型必填默认值说明
modeinteger❌0动画模式：0=所有，1=VIP，2=免费
typestring✅-动画类型：in=入场，out=出场，loop=循环

参数详解

动画模式参数

  • mode: 动画筛选模式

    • 0 = 返回所有动画（包括VIP和免费）
    • 1 = 仅返回VIP动画
    • 2 = 仅返回免费动画
    • 默认值：0
动画类型参数

  • type: 动画类型，必填参数

    • "in" = 入场动画（文字出现时的动画效果）
    • "out" = 出场动画（文字消失时的动画效果）
    • "loop" = 循环动画（文字持续播放的循环动画效果）
动画模式说明
模式值模式名称描述
0所有返回所有动画（包括VIP和免费）
1VIP仅返回VIP动画
2免费仅返回免费动画
动画类型说明
类型值类型名称描述
in入场动画文字出现时的动画效果
out出场动画文字消失时的动画效果
loop循环动画文字持续播放的循环动画效果

响应格式

成功响应 (200)

{
  "effects": [
    {
      "resource_id": "7314291622525538843",
      "type": "in",
      "category_id": "ruchang",
      "category_name": "入场",
      "duration": 500000,
      "id": "35395178",
      "name": "冰雪飘动",
      "request_id": "",
      "start": 0,
      "icon_url": "https://lf5-hl-hw-effectcdn-tos.byteeffecttos.com/obj/ies.fe.effect/459c196951cadbd024456a63db89481f",
      "material_type": "sticker",
      "panel": "",
      "path": "",
      "platform": "all"
    },
    {
      "resource_id": "7397306443147252233",
      "type": "in",
      "category_id": "ruchang",
      "category_name": "入场",
      "duration": 500000,
      "id": "77035159",
      "name": "变色输入",
      "request_id": "",
      "start": 0,
      "icon_url": "https://lf5-hl-hw-effectcdn-tos.byteeffecttos.com/obj/ies.fe.effect/c15f5c313f8170c558043abf300a0692",
      "material_type": "sticker",
      "panel": "",
      "path": "",
      "platform": "all"
    }
  ]
}

响应字段说明

字段名类型说明
effectsarray文字出入场动画对象数组
动画对象结构

每个动画对象包含以下字段：

字段名类型描述
resource_idstring动画资源ID
typestring动画类型（in/out/loop）
category_idstring动画分类ID
category_namestring动画分类名称
durationinteger动画时长（微秒）
idstring动画唯一标识ID
namestring动画名称
request_idstring请求ID（通常为空）
startinteger动画开始时间
icon_urlstring动画图标URL
material_typestring素材类型（通常为"sticker"）
panelstring面板信息
pathstring路径信息
platformstring支持平台（通常为"all"）

错误响应 (4xx/5xx)

{
  "detail": "错误信息描述"
}

使用示例

cURL 示例

1. 获取所有入场动画
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_text_animations \
  -H "Content-Type: application/json" \
  -d '{
    "mode": 0,
    "type": "in"
  }'
2. 获取VIP出场动画
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_text_animations \
  -H "Content-Type: application/json" \
  -d '{
    "mode": 1,
    "type": "out"
  }'
3. 获取免费循环动画
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_text_animations \
  -H "Content-Type: application/json" \
  -d '{
    "mode": 2,
    "type": "loop"
  }'

错误码说明

错误码错误信息说明解决方案
400type是必填项缺少动画类型参数提供有效的type参数
400mode参数无效mode参数超出范围使用0、1或2作为mode值
400type参数无效type参数值不正确使用in、out或loop作为type值
500获取文字动画失败内部处理错误联系技术支持

注意事项

  1. 参数要求: type参数为必填项，mode参数为可选项
  2. 动画类型: type参数只能是"in"、"out"、"loop"中的一个
  3. 动画模式: mode参数只能是0、1、2中的一个
  4. 响应格式: 与旧版本不同，当前版本直接返回对象数组而非JSON字符串
  5. 数据来源: 当前使用模拟数据，生产环境中应从数据库或API获取

工作流程

  1. 验证必填参数（type）
  2. 验证参数有效性（type和mode）
  3. 根据type和mode筛选动画数据
  4. 返回符合条件的动画列表

相关接口

<div align="right">

📚 项目资源
GitHub项目名称: capcut-mate

GET_IMAGE_ANIMATIONS API 接口文档

接口信息

POST /openapi/capcut-mate/v1/get_image_animations

功能描述

获取图片出入场动画列表，返回所有支持的且满足条件的图片出入场动画。支持根据动画类型（入场、出场、循环）和会员模式（所有、VIP、免费）进行筛选。

更多文档

📖 更多详细文档和教程请访问：https://docs.jcaigc.cn

请求参数

{
  "mode": 0,
  "type": "in"
}

参数说明

参数名类型必填默认值说明
modeinteger❌0动画模式：0=所有，1=VIP，2=免费
typestring✅-动画类型：in=入场，out=出场，loop=循环

参数详解

动画模式参数

  • mode: 动画筛选模式

    • 0 = 所有动画（包括VIP和免费）
    • 1 = 仅VIP动画
    • 2 = 仅免费动画
    • 默认值：0
动画类型参数

  • type: 动画类型（必填）

    • "in" = 入场动画（图片出现时的效果）
    • "out" = 出场动画（图片消失时的效果）
    • "loop" = 循环动画（图片持续播放的效果）
动画模式说明
模式值模式名称描述
0所有返回所有动画（包括VIP和免费）
1VIP仅返回VIP动画
2免费仅返回免费动画
动画类型说明
类型值类型名称描述
in入场动画图片出现时的动画效果
out出场动画图片消失时的动画效果
loop循环动画图片持续播放的循环动画效果

响应格式

成功响应 (200)

{
  "effects": [
    {
      "resource_id": "7314291622525538844",
      "type": "in",
      "category_id": "pic_ruchang",
      "category_name": "图片入场",
      "duration": 600000,
      "id": "35395179",
      "name": "渐显出现",
      "request_id": "",
      "start": 0,
      "icon_url": "https://lf5-hl-hw-effectcdn-tos.byteeffecttos.com/obj/ies.fe.effect/fade_in_pic_icon",
      "material_type": "sticker",
      "panel": "",
      "path": "",
      "platform": "all"
    }
  ]
}

响应字段说明

字段名类型说明
effectsarray图片动画对象数组
单个动画对象字段说明
字段名类型说明
resource_idstring动画资源ID
typestring动画类型（in/out/loop）
category_idstring动画分类ID
category_namestring动画分类名称
durationinteger动画时长（微秒）
idstring动画唯一标识ID
namestring动画名称
request_idstring请求ID（通常为空）
startinteger动画开始时间
icon_urlstring动画图标URL
material_typestring素材类型（通常为"sticker"）
panelstring面板信息
pathstring路径信息
platformstring支持平台（通常为"all"）

错误响应 (4xx/5xx)

{
  "detail": "错误信息描述"
}

使用示例

cURL 示例

1. 获取所有入场动画
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_image_animations \
  -H "Content-Type: application/json" \
  -d '{
    "mode": 0,
    "type": "in"
  }'
2. 获取VIP出场动画
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_image_animations \
  -H "Content-Type: application/json" \
  -d '{
    "mode": 1,
    "type": "out"
  }'
3. 获取免费循环动画
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_image_animations \
  -H "Content-Type: application/json" \
  -d '{
    "mode": 2,
    "type": "loop"
  }'

错误码说明

错误码错误信息说明解决方案
400type 参数必须为 in、out 或 loop动画类型参数无效使用正确的type值："in"、"out"或"loop"
400mode 参数必须为 0、1 或 2动画模式参数无效使用正确的mode值：0、1或2
500获取图片动画失败内部处理错误联系技术支持

注意事项

  1. type参数：必填参数，只能选择 "in"、"out"、"loop" 中的一个
  2. mode参数：可选参数，默认为0（所有动画）
  3. 响应数据：与文字动画不同，图片动画有专门的分类和效果
  4. 动画时长：单位为微秒（1秒 = 1,000,000微秒）
  5. VIP标识：部分动画可能需要VIP权限才能使用

工作流程

  1. 验证必填参数（type）
  2. 验证可选参数（mode）的有效性
  3. 根据type和mode筛选图片动画数据
  4. 返回符合条件的动画对象数组
  5. 服务端自动处理数据格式化

相关接口

<div align="right">

📚 项目资源
GitHub项目名称: capcut-mate

GET_DRAFT API 接口文档

接口信息

GET /openapi/capcut-mate/v1/get_draft

功能描述

获取草稿文件列表。该接口用于获取指定草稿ID对应的所有文件列表，可以查看草稿中包含的素材文件、配置文件等信息。通常用于草稿内容的预览、文件管理或状态检查。

更多文档

📖 更多详细文档和教程请访问：https://docs.jcaigc.cn

请求参数

Query参数

参数名类型必填默认值说明
draft_idstring✅-草稿ID，长度为20-32位字符

参数详解

draft_id
  • 类型: 字符串
  • 必填: 是
  • 长度: 20-32位字符
  • 格式: 通常为UUID格式或类似的唯一标识符
  • 示例: 2f52a63b-8c6a-4417-8b01-1b2a569ccb6c
  • 获取方式: 通常从draft_url中提取或由create_draft接口返回

响应格式

成功响应 (200)

{
  "files": [
    "2f52a63b-8c6a-4417-8b01-1b2a569ccb6c.json",
    "video_123456789.mp4",
    "audio_987654321.mp3",
    "image_555666777.jpg",
    "thumbnail_888999000.png"
  ]
}

响应字段说明

字段名类型说明
filesarray草稿相关的文件列表

错误响应 (4xx/5xx)

{
  "detail": "错误信息描述"
}

使用示例

cURL 示例

1. 基本获取草稿文件列表
curl -X GET "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2f52a63b-8c6a-4417-8b01-1b2a569ccb6c" \
  -H "Content-Type: application/json"
2. 使用完整的draft_id
curl -X GET "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=7e8f9a0b-1c2d-3e4f-5g6h-7i8j9k0l1m2n" \
  -H "Content-Type: application/json"

错误码说明

错误码错误信息说明解决方案
400draft_id是必填项缺少draft_id参数提供有效的draft_id
400draft_id长度无效draft_id长度不在20-32位范围内检查draft_id格式是否正确
400draft_id格式无效draft_id格式不正确确保使用正确的草稿ID格式
404草稿不存在指定的草稿ID无法找到确认草稿ID是否正确且存在
500获取文件列表失败内部服务错误联系技术支持或稍后重试
503服务不可用系统维护中稍后重试

注意事项

  1. 参数格式: 确保draft_id格式正确且长度在20-32位之间
  2. ID提取: 从draft_url正确提取draft_id
  3. 文件类型: 返回的文件列表包含多种类型的文件
  4. 权限验证: 确保有权限访问指定的草稿
  5. 实时性: 文件列表可能不是实时更新的，存在一定延迟
  6. 文件状态: 列表中的文件可能处于不同的处理状态

工作流程

  1. 验证draft_id参数
  2. 检查draft_id格式和长度
  3. 查找指定的草稿
  4. 获取草稿关联的所有文件
  5. 返回文件列表

相关接口

📚 项目资源
GitHub项目名称: capcut-mate