⚠️ 注意事项
重要提醒
在使用 SUTUI API 之前，请仔细阅读以下注意事项，以确保正确使用接口并防止不必要的错误。
🔐 身份验证
必要要求
- 所有接口都需要在请求头中提供有效的 Bearer token
- Token 格式：
Authorization: Bearer YOUR_TOKEN - 请确保 Token 没有过期，否则会返回 401 错误
- 不要在客户端代码中直接暴露 Token，建议使用环境变量或配置文件
💰 费用计算
费用说明
- 创建任务时会检查用户余额，余额不足时会返回 400 错误
- 任务费用会根据不同的应用类型和参数自动计算
- 具体费用在任务创建成功后的
money字段中返回 - VEO3 快速模式 200 积分，标准模式 400 积分（SVIP 价格）
📦 数据格式
数据处理
input_params和output_params字段在返回时会自动解析为 JSON 对象- 请求参数必须为有效的 JSON 格式
- 所有接口都使用
application/json作为 Content-Type - 字符编码使用 UTF-8
🛠️ 任务管理
最佳实践
- 任务列表接口支持按多个应用名称筛选，应用名称间用英文逗号分隔
- 任务详情接口会同步任务状态并返回最新信息
- 对于正在运行的任务，建议定期查询状态直到完成
- 任务详情会额外返回用户信息（姓名、头像）和点赞状态
🎨 模型特定注意事项
VEO3 任务
VEO3 特殊要求
- 创建 VEO3 视频任务时，需要将
task_type设置为"veo3_api" app_name必须设置为"veo3_api"- 支持的
video_model_key选项：veo_3_i2v_s_fast- 图生视频快速模式veo_3_i2v_s- 图生视频标准模式veo_3_0_t2v_fast- 文生视频快速模式veo_3_0_t2v- 文生视频标准模式
Flux 系列模型
参数说明
- 支持多种 Flux 模型：Dev, Pro, Max 等
- 支持图生图、文生图、多图生图等多种模式
aspect_ratio支持多种尺寸比例safety_tolerance可设置安全等级
豆包(ByteDance) 模型
支持参数
- aspect_ratio：16:9, 4:3, 1:1, 9:21, 21:9, 9:16, 3:4
- resolution：480p, 720p, 1080p
- duration：5秒, 10秒
- camera_fixed：是否固定镜头（仅图生视频）
🔄 限流和重试
使用限制
- 请勿频繁调用接口，建议间隔至少 1 秒
- 对于运行中的任务，建议每 5-10 秒查询一次状态
- 遇到 5xx 错误时，建议使用指数退避策略重试
- 超时时间设置建议不少于 30 秒
🔒 安全考虑
安全最佳实践
- 始终使用 HTTPS 协议进行 API 调用
- 不要在日志中记录 Token 或敏感信息
- 定期轮换 API Token
- 使用白名单限制 IP 访问（如果支持）
- 对于生产环境，建议使用反向代理来隐藏真实 API 地址
📞 技术支持
获取帮助
如果您在使用 API 过程中遇到问题，请提供以下信息以便我们更好地帮助您：
- 完整的请求 URL 和参数
- 返回的错误信息和状态码
- 任务 ID（如果有）
- 时间戳和操作环境
- 重现问题的步骤