SUTUI API 接口文档

完整的任务管理API接口说明，支持多种AI模型的任务创建、管理和查询功能。

🎬

视频合成剪映小助手插件 API 全面开放！

专业级视频编辑API，一键调用剪映核心功能

🚀 现已支持音频添加、字幕生成、特效处理、图片素材、视频合成等完整视频编辑功能
📝 完整API文档和使用示例请访问：https://jy-api.fyshark.com/docs

🔗 立即查看剪映API文档

🌐 API 基础信息

HOST https://ts-api.fyshark.com

所有API接口都基于以上域名进行访问。所有接口都需要在请求头中提供有效的 Bearer token 进行身份验证。

🔑 获取 API Token

TOKEN 请访问用户信息页面获取您的 API Token

登录后在用户信息页面可以查看和管理您的API Token，请妥善保管您的Token信息。

📝 使用示例

Curl 请求示例：

curl -X POST "https://ts-api.fyshark.com/api/create_task_ex" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "app_name": "st-ai/flux-pro/kontext/text-to-image",
    "input_params": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9",
      "num_images": 1
    }
  }'

⚠️ 请将 YOUR_API_TOKEN 替换为您的实际API Token

📚 接口概览

🚀 创建任务

创建新的 SUTUI 任务，支持 Flux、VEO3、VIDU、豆包等多种AI模型类型，包含详细的参数配置案例。

查看详情

📋 任务列表

获取当前用户的任务列表，支持分页查询和按应用名称筛选，可同时查询多个应用的任务。

查看详情

🔍 任务详情

查询单个任务的详细信息和执行状态，包含输入输出参数、用户信息和点赞状态等完整数据。

查看详情

📊 状态码说明

详细的HTTP状态码和任务状态说明，帮助开发者理解接口返回的各种状态信息。

查看详情

⚠️ 注意事项

重要的开发注意事项、费用计算说明和最佳实践建议，确保正确使用API接口。

查看详情

✨ 支持的AI模型

🖼️ 图像生成
Flux Dev, Flux Pro, Flux Max, Imagen4

📹 视频生成
VEO3, VEO2, VIDU, 豆包, 可灵, 海螺

🎨 图像编辑
图生图, 多图生图, 文生图

🎭 特殊功能
对口型, 音视频同步处理