创建任务
POST
https://ts-api.fyshark.com/api/sutui/tasks/create
接口描述
创建一个新的 SUTUI 任务，支持多种AI模型类型。
请求头
Content-Type: application/json
Authorization: Bearer {token}
请求参数
| 参数名 | 类型 | 必填 | 描述 | 示例 |
|---|---|---|---|---|
| app_name | string | 是 | 应用名称（任务格式如"flux-kontext/dev"，VEO3任务如"veo-api"） | "flux-kontext/dev" |
| input_params | object | 是 | 任务的输入参数（JSON格式） | {"prompt": "a beautiful cat", "seed": 12345} |
| task_type | string | 否 | 任务类型，默认为"fal"。如果是veo3任务则填写"veo3_api" | "fal" 或 "veo3_api" |
请求示例
VEO3任务示例：
{
"app_name": "veo3_api",
"input_params": {
"prompt": "a cat playing in the garden",
"duration": 5
},
"task_type": "veo3_api"
}
🎨 模型案例
SUTUI API 支持多种AI模型，每种模型都有不同的特性和用途。请点击下方链接查看详细的模型参数配置案例：
响应格式
成功响应 200：
{
"code": 200,
"message": "Fal任务创建成功", // 如果是veo3_api则显示"VEO任务创建成功"
"data": {
"id": 123,
"user_id": 456,
"task_id": "uuid-string",
"online_task_id": "fal-request-id",
"app_name": "st-ai/fast-sdxl",
"api_key": "key-string",
"task_type": "fal",
"status": "pending",
"input_params": "{\"prompt\":\"a beautiful landscape painting\"}",
"output_params": null,
"money": 0.1,
"created_at": "2024-01-01T12:00:00",
"updated_at": "2024-01-01T12:00:00"
}
}
错误响应：
// 401 未授权
{
"code": 401,
"message": "Token invalid, please check out"
}
// 400 余额不足
{
"code": 400,
"message": "余额不足"
}
// 500 服务器错误
{
"code": 500,
"message": "提交任务到Fal API失败: error details"
}