模型广场后端API文档 V0.3

基础信息

Base URL: http://localhost:8000
API前缀: /api/models

统一响应格式

{
  "code": 200,
  "message": "success",
  "data": {}
}

字段	类型	说明
code	int	状态码：200成功，400参数错误，404资源不存在，500服务器错误
message	string	响应消息
data	object	响应数据

接口列表

1. 获取模型列表

GET /api/models

请求参数

参数	类型	必填	默认值	说明
page	int	否	1	页码，最小值1
page_size	int	否	20	每页数量，范围1-100
keyword	string	否	-	搜索关键词，在name、description、keyword字段中模糊匹配
category	string	否	-	模型分类筛选，可选值：文本、图像、视频、语音
supplier	string	否	-	供应商筛选，精确匹配供应商名称
filter_keyword	string	否	-	关键字筛选，精确匹配keyword字段
filter_tag	string	否	-	标签筛选，在tag1或tag2字段中精确匹配

分类映射关系

分类值	category值	说明
文本	0	语言模型(LLM)，用于文本生成和理解
图像	1	多模态模型，用于图像理解和生成
图像	4	图像生成模型
语音	2	TTS语音合成模型
语音	3	STT语音识别模型
视频	5	视频生成模型

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 100,
    "page": 1,
    "page_size": 20,
    "items": [
      {
        "id": 1,
        "title": "qwen-turbo",
        "img": "https://example.com/icon.svg",
        "name": "通义千问-Turbo",
        "tag1": "高速",
        "description": "通义千问超大规模语言模型，加速响应版本",
        "keyword": "文本生成",
        "time": "2025-01-01",
        "tag2": "Qwen",
        "category": 0,
        "supplier": "Qwen",
        "price_id": 1,
        "is_featured": true,
        "pricing_mode": "simple",
        "input_price": "0.0001",
        "output_price": "0.0002",
        "price_unit": "tokens",
        "price_currency": "CNY",
        "price_tiers": [],
        "created_at": "2025-01-01T00:00:00",
        "updated_at": "2025-01-01T00:00:00"
      },
      {
        "id": 2,
        "title": "qwen-max",
        "img": "https://example.com/icon2.svg",
        "name": "通义千问-Max",
        "tag1": "旗舰",
        "description": "通义千问超大规模语言模型，旗舰版本（阶梯计费）",
        "keyword": "文本生成",
        "time": "2025-01-01",
        "tag2": "Qwen",
        "category": 0,
        "supplier": "Qwen",
        "price_id": 2,
        "is_featured": true,
        "pricing_mode": "tier",
        "input_price": "0.0004",
        "output_price": "0.0012",
        "price_unit": "tokens",
        "price_currency": "CNY",
        "price_tiers": [
          {
            "tier_min": 0,
            "tier_max": 100000,
            "input_price": "0.0004",
            "output_price": "0.0012"
          },
          {
            "tier_min": 100001,
            "tier_max": 1000000,
            "input_price": "0.0002",
            "output_price": "0.0006"
          },
          {
            "tier_min": 1000001,
            "tier_max": null,
            "input_price": "0.0001",
            "output_price": "0.0003"
          }
        ],
        "created_at": "2025-01-01T00:00:00",
        "updated_at": "2025-01-01T00:00:00"
      }
    ]
  }
}

2. 获取单个模型详情

GET /api/models/{model_id}

路径参数

参数	类型	说明
model_id	int	模型ID

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "id": 1,
    "title": "qwen-turbo",
    "img": "https://example.com/icon.svg",
    "name": "通义千问-Turbo",
    "tag1": "高速",
    "description": "通义千问超大规模语言模型，加速响应版本",
    "keyword": "文本生成",
    "time": "2025-01-01",
    "tag2": "Qwen",
    "category": 0,
    "supplier": "Qwen",
    "price_id": 1,
    "is_featured": true,
    "created_at": "2025-01-01T00:00:00",
    "updated_at": "2025-01-01T00:00:00"
  }
}

错误响应

模型不存在时返回404：

{
  "code": 404,
  "message": "Model not found",
  "data": null
}

3. 获取所有关键字列表

GET /api/models/keywords/list

请求参数

无

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "keywords": [
      "文本生成",
      "图像生成",
      "视频生成",
      "语音合成",
      "图像识别",
      "文本理解"
    ]
  }
}

数据字段说明

字段	类型	说明
id	int	模型ID
title	string	模型标识（唯一）
img	string	图标URL
name	string	显示名称
tag1	string	主标签
description	string	模型描述
keyword	string	关键词
time	string	发布时间
tag2	string	次要标签
category	int	模型分类：0=文本，1=多模态，2=TTS，3=STT，4=生图，5=生视频
supplier	string	供应商名称，默认Qwen
price_id	int	价格ID（外键关联model_price表），可为null
is_featured	boolean	是否为精选模型
pricing_mode	string	计价模式：simple=简单计费，tier=阶梯计费
input_price	decimal	输入单价（基准价格），可为null
output_price	decimal	输出单价（基准价格），可为null
price_unit	string	计价单位，可为null
price_currency	string	货币单位，可为null
price_tiers	array	阶梯价格列表（仅pricing_mode=tier时有数据）
created_at	datetime	创建时间
updated_at	datetime	更新时间

price_tiers 阶梯价格字段说明

字段	类型	说明
tier_min	int	阶梯起始token数
tier_max	int	阶梯结束token数，null表示无上限
input_price	decimal	该阶梯输入单价
output_price	decimal	该阶梯输出单价

计价模式说明

简单计费 (pricing_mode = "simple")

使用固定的 input_price 和 output_price 进行计费，与使用量无关。

{
  "pricing_mode": "simple",
  "input_price": "0.0001",
  "output_price": "0.0002",
  "price_tiers": []
}

阶梯计费 (pricing_mode = "tier")

根据使用量分段计费，使用量越大单价越优惠。

{
  "pricing_mode": "tier",
  "input_price": "0.0004",
  "output_price": "0.0012",
  "price_tiers": [
    {"tier_min": 0, "tier_max": 100000, "input_price": "0.0004", "output_price": "0.0012"},
    {"tier_min": 100001, "tier_max": 1000000, "input_price": "0.0002", "output_price": "0.0006"},
    {"tier_min": 1000001, "tier_max": null, "input_price": "0.0001", "output_price": "0.0003"}
  ]
}

阶梯计费规则：

0 - 100,000 tokens: 输入 ¥0.0004/token，输出 ¥0.0012/token
100,001 - 1,000,000 tokens: 输入 ¥0.0002/token，输出 ¥0.0006/token
1,000,000+ tokens: 输入 ¥0.0001/token，输出 ¥0.0003/token

筛选功能说明

分类筛选

使用 category 参数按模型分类筛选：

GET /api/models?category=文本

可选括值：文本、图像、视频、语音

供应商筛选

使用 supplier 参数精确匹配供应商：

GET /api/models?supplier=Qwen

关键字筛选

使用 filter_keyword 参数精确匹配关键字字段：

GET /api/models?filter_keyword=文本生成

标签筛选

使用 filter_tag 参数在tag1或tag2中精确匹配：

GET /api/models?filter_tag=高速

组合筛选

多个筛选条件可以组合使用：

GET /api/models?category=文本&supplier=Qwen&filter_tag=高速

在线文档

启动服务后访问：

Swagger UI: http://localhost:8000/docs
ReDoc: http://localhost:8000/redoc

MD001_模型广场后端API_V0.2.md 8.1 KB Verlauf Originalformat

模型广场后端API文档 V0.3

基础信息

统一响应格式

接口列表

1. 获取模型列表

请求参数

分类映射关系

响应示例

2. 获取单个模型详情

路径参数

响应示例

错误响应

3. 获取所有关键字列表

请求参数

响应示例

数据字段说明

price_tiers 阶梯价格字段说明

计价模式说明

简单计费 (pricing_mode = "simple")

阶梯计费 (pricing_mode = "tier")

筛选功能说明

分类筛选

供应商筛选

关键字筛选

标签筛选

组合筛选

在线文档

MD001_模型广场后端API_V0.2.md 8.1 KB

Verlauf Originalformat