APIMPAPIMP
用户指南AI 接口图片接口视频接口公共接口
任务管理

查询模型参数 spec

返回指定 model 在 /api/generate/submit 上接受的字段契约（类型 / 枚举 / 范围 / 上限 / 必填 / 别名 / 位置）。

SDK / playground / 文档站可以用本接口做参数表单的自动渲染：把 spec 的每个 field 直接映射成 UI 控件（select / number / array input），并在提交前用同一份规则做客户端校验。

GET
/api/generate/spec/{model}

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

In: header

Path Parameters

model*string

model 名称。和 /api/generate/submit 请求体里写的一致。

Response Body

application/json

application/json

application/json

curl -X GET "https://api.apimp.ai/api/generate/spec/seedance-2.0-text-to-video"
{
  "code": 200,
  "data": {
    "id": "seedance-2.0",
    "default_action": "generate",
    "fields": {
      "prompt": {
        "location": "top_level",
        "type": "string"
      },
      "size": {
        "location": "top_level",
        "type": "string",
        "enum": [
          "16:9",
          "9:16",
          "1:1",
          "4:3",
          "3:4",
          "21:9",
          "adaptive"
        ]
      },
      "duration": {
        "location": "top_level",
        "type": "int",
        "min": 4,
        "max": 15,
        "aliases": [
          "seconds"
        ]
      },
      "images": {
        "location": "top_level",
        "type": "string_array",
        "max_items": 9
      },
      "quality": {
        "location": "metadata",
        "type": "string",
        "enum": [
          "480p",
          "720p",
          "1080p"
        ]
      },
      "generate_audio": {
        "location": "metadata",
        "type": "bool"
      }
    }
  }
}
{
  "code": 0,
  "error": {
    "message": "string",
    "type": "not_found"
  }
}
{
  "code": 404,
  "error": {
    "message": "no spec registered for model `xyz-unknown`",
    "type": "not_found"
  }
}

这篇文档对您有帮助吗？

最后更新于