任务列表 - SUTUI API 接口文档

获取任务列表

POST https://ts-api.fyshark.com/api/sutui/tasks/list

接口描述

获取当前用户的任务列表，支持分页和按应用名称筛选

请求头

Content-Type: application/json
Authorization: Bearer {token}

请求参数

参数名	类型	必填	描述	示例
page	integer	是	页码，从1开始	1
page_size	integer	是	每页数量	10
app_name	string	是	应用名称，多个应用使用英文逗号分隔	"st-ai/fast-sdxl,st-ai/lcm"

请求示例

{
  "page": 1,
  "page_size": 10,
  "app_name": "st-ai/fast-sdxl"
}

响应格式

成功响应 200：

{
  "code": 200,
  "message": "获取成功",
  "data": {
    "list": [
      {
        "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": "completed",
        "input_params": {
          "prompt": "a beautiful landscape painting",
          "seed": 42
        },
        "output_params": {
          "images": [
            {
              "url": "https://example.com/image.jpg",
              "width": 1024,
              "height": 768
            }
          ]
        },
        "money": 0.1,
        "created_at": "2024-01-01T12:00:00",
        "updated_at": "2024-01-01T12:05:00"
      }
    ],
    "total": 25,
    "page": 1,
    "page_size": 10
  }
}

错误响应 401：

{
  "code": 401,
  "message": "Token invalid, please check out"
}

💡 使用提示

支持按多个应用名称筛选，应用名称间用英文逗号分隔
input_params 和 output_params 字段会自动解析为JSON对象
分页从第1页开始，建议每页数量设置为10-50之间
返回的任务按创建时间倒序排列（最新的在前）