模型列表

GET /v1/tasks/models

返回当前任务 API Key 可用且可执行的模型，以及每个模型最终生效的用户价格、模态、能力和参数约束。

这个接口以 API Key 为作用域。Key 可以为不同模型分别选择档位；未显式选择的模型使用该模型默认档位。因此，同一用户的两个任务 API Key 可能返回不同的价格和约束。接口不接受档位参数，不同档位也不会改变公开模型名。如果某个选择失效，该模型会回到自己的默认档位，其他模型选择不受影响。

目录中配置的模型别名也可以用于提交。服务端会在创建任务前将别名归一化为公共模型名，因此任务响应、模型列表和任务费用字段都使用同一个公共模型名，不暴露各渠道不同的发送模型名。

返回列表还会校验执行链路。图片、视频和 3D 统一要求有效档位中至少存在一条已启用的渠道模型路由，且渠道 Adapter 必须与模态匹配。仅创建模型配置不会暴露模型。目前没有注册 3D Adapter，因此不会返回 3D 模型。

bash

curl https://api.llmapi.site/v1/tasks/models \
  -H 'Authorization: Bearer YOUR_TASK_API_KEY'

响应 — 200 OK

json

{
  "data": [
    {
      "model": "gemini-3.1-flash-image",
      "modality": "image",
      "status": "active",
      "pricing_mode": "image_matrix",
      "pricing_rules": {
        "unit": "usd_per_image",
        "prices": {
          "0.5K": 0.03,
          "1K": 0.05,
          "2K": 0.1,
          "4K": 0.5
        }
      },
      "capabilities": {
        "image_generation": true,
        "image_edit": true,
        "reference_image": true,
        "video_generation": false,
        "model_3d_generation": false
      },
      "parameter_constraints": {
        "supported_image_sizes": ["0.5K", "1K", "2K", "4K"],
        "supported_aspect_ratios": ["1:1", "1:4", "1:8", "2:3", "3:2", "3:4", "4:1", "4:3", "4:5", "5:4", "8:1", "9:16", "16:9", "21:9"],
        "min_images": 1,
        "max_images": 10,
        "max_input_images": 10
      }
    }
  ]
}

模态与能力字段

字段	说明
`modality`	`image`、`video` 或 `3d`。
`capabilities.image_generation`	可生成图片。
`capabilities.image_edit`	支持图片编辑或重绘。
`capabilities.reference_image`	接受参考图片；具体数量和角色仍看约束。
`capabilities.video_generation`	可生成视频。
`capabilities.model_3d_generation`	可生成 3D 模型。

parameter_constraints 是稀疏对象，只返回当前模型适用的字段：

字段	适用模态	说明
`supported_image_sizes`	图片	可用图片规格档位。
`supported_aspect_ratios`	图片	可用图片比例。
`min_images`、`max_images`	图片	结果图片数量范围。
`max_input_images`	图片	图片任务的最大参考图数量。
`max_input_assets`	视频、3D	`params.inputs` 的最大素材数量；当前公共解析器返回并执行 `16`。

可执行的视频模型沿用相同的模型列表结构。当前模型列表不会为视频返回时长、分辨率、画幅或音频值域：

json

{
  "model": "seedance-2-0-fast",
  "modality": "video",
  "pricing_mode": "video_duration",
  "pricing_rules": {
    "unit": "usd_per_video_second",
    "unit_seconds": 1,
    "step_seconds": 1,
    "minimum_seconds": 1,
    "price": 0.15
  },
  "capabilities": {
    "image_generation": false,
    "image_edit": false,
    "reference_image": false,
    "video_generation": true,
    "model_3d_generation": false
  },
  "parameter_constraints": {
    "max_input_assets": 16
  }
}

上例用于说明响应结构，不保证某个 Key 已开放该模型。实际可用模型始终以接口实时返回为准。视频的具体可用值需要参考所选上游模型文档；公共解析器只校验字段类型和基本结构，再由 Adapter 构造上游请求。

pricing_mode 当前可能是 image_matrix、video_duration 或 per_request。对应的 pricing_rules.unit 分别使用 usd_per_image、usd_per_video_second 或 usd_per_request。价格单位为美元；视频时长模式按 unit_seconds、step_seconds 和 minimum_seconds 计算。

参数规则

图片模型使用以下参数规则：

params.prompt 必填。
params.n 如存在，须为 1 到 10 的整数。
使用 params.image_size 和 params.aspect_ratio 描述规格。
params.image_size 会按模型配置的 0.5K、1K、2K、3K、4K 等档位参与路由和计费。
编辑任务需在 params.images[].image_url 中提供参考图。
上游特有参数放在扁平的 params.extra_body 中。

常见模型与协议的尺寸映射见模型规格。实际可用规格以当前接口返回为准。

extra_body 会在 LLMAPI 根据通用任务参数生成上游请求后浅合并到上游请求中。若 extra_body 覆盖了上游实际使用的数量或规格，计费会按最终上游请求解析出的规格计算；单价仍来自该模型在当前 Key 上最终生效的任务档位。

视频模型要求提供非空 prompt、正整数 duration，以及非空的 resolution 和 aspect_ratio 字符串。可选的 generate_audio 必须是布尔值；inputs 最多接受 16 个公网 HTTP(S) 素材，并由所选 Adapter 转换。协议专属控制项放在 params.provider_options。

传入语法无效的参数将返回 400 错误，error.message 会指明出错字段。若当前可用路线不支持本次模态、参数或素材组合，提交或执行时返回 TASK_NO_CAPABLE_ROUTE。上游返回图片数量或尺寸与请求不一致时，任务仍保持成功状态，并在查询响应的 diagnostics 中记录不一致原因。

错误码

状态码	原因
`401`	API Key 缺失或无效。
`403`	API Key 未启用任务 API。
`503`	任务 API 未启用或暂时不可用。

模型列表 ​

响应 — 200 OK ​

模态与能力字段 ​

参数规则 ​

错误码 ​

模型列表

响应 — 200 OK

模态与能力字段

参数规则

错误码