ModelScope Flask Router
配置页已简化

先改常用配置,其他信息按需展开

已接入 4 个 key,配置了 7 个模型,当前可用 6 个,要处理 5 个问题。 默认先看新增说明;配置编辑器、状态和高级 JSON 都收进下面的折叠区。
Key
4
模型
7
问题
5

怎么添加模型 API、怎么调用

一个功能一块说明,先看懂聊天、看图、文生图、图生图分别怎么配、怎么调。
展开 / 收起

聊天

能力值:chat
调用路由:/v1/chat/completions
适合拿来干嘛
适合普通对话、问答、改文案、写总结。
怎么添加模型 API
  1. 在上面的配置编辑器里新增一个模型。
  2. 能力选“聊天”,填模型 ID,勾选要使用的账号,然后保存。
  3. 其他程序调用时,请求发到 /v1/chat/completions。
怎么调用
{
  "model": "modelscope-router",
  "messages": [
    {
      "role": "user",
      "content": "你好,请介绍一下你自己。"
    }
  ],
  "stream": false
}
curl 示例
curl -X POST http://127.0.0.1:2166/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"modelscope-router","messages":[{"role":"user","content":"你好,请介绍一下你自己。"}],"stream":false}'
常见报错看哪里
如果报模型不可用、账号不可用,先看下面的“问题提示”“模型列表”“账号列表”;如果只是想单独试某个账号,去“在线调试”页选账号测试。

视觉理解

能力值:vision
调用路由:/v1/chat/completions
适合拿来干嘛
适合看图描述、识别图片内容、结合图片问答。
怎么添加模型 API
  1. 新增模型后,能力选“看图”。
  2. 填模型 ID、勾选账号并保存。
  3. 调用时仍然走 /v1/chat/completions,只是 messages 里要带图片。
怎么调用
{
  "model": "modelscope-router",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "请描述图片内容。"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/demo.jpg"
          }
        }
      ]
    }
  ],
  "stream": false
}
curl 示例
curl -X POST http://127.0.0.1:2166/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"modelscope-router","messages":[{"role":"user","content":[{"type":"text","text":"请描述图片内容。"},{"type":"image_url","image_url":{"url":"https://example.com/demo.jpg"}}]}],"stream":false}'
常见报错看哪里
如果看图请求失败,先确认你配的是“看图”模型,不是普通聊天模型;再去“在线调试”点“视觉理解”直接测。

文生图

能力值:text_to_image
调用路由:/v1/images/generations
适合拿来干嘛
适合只给文字描述,让模型直接生成图片。
怎么添加模型 API
  1. 新增模型后,能力选“文生图”。
  2. 填模型 ID、勾选账号并保存。
  3. 其他程序调用时,请求发到 /v1/images/generations。
怎么调用
{
  "model": "modelscope-router",
  "prompt": "一只坐在咖啡馆里的机械猫",
  "n": 1,
  "size": "1024x1024"
}
curl 示例
curl -X POST http://127.0.0.1:2166/v1/images/generations -H "Content-Type: application/json" -d '{"model":"modelscope-router","prompt":"一只坐在咖啡馆里的机械猫","n":1,"size":"1024x1024"}'
常见报错看哪里
如果文生图失败,先确认能力配的是“文生图”;如果账号被限流,会在“账号列表”里看到状态。

图生图

能力值:image_to_image
调用路由:/v1/images/edits
适合拿来干嘛
适合拿一张现成图片,再让模型改风格、换背景、做重绘。
怎么添加模型 API
  1. 新增模型后,能力选“图生图”。
  2. 填模型 ID、勾选账号并保存。
  3. 其他程序调用时,请求发到 /v1/images/edits,并传原图地址。
怎么调用
{
  "model": "modelscope-router",
  "prompt": "把这张图改成赛博朋克风格",
  "image": "https://example.com/input.png",
  "n": 1,
  "size": "1024x1024"
}
curl 示例
curl -X POST http://127.0.0.1:2166/v1/images/edits -H "Content-Type: application/json" -d '{"model":"modelscope-router","prompt":"把这张图改成赛博朋克风格","image":"https://example.com/input.png","n":1,"size":"1024x1024"}'
常见报错看哪里
如果图生图失败,先确认图片地址可访问,再确认能力配的是“图生图”;也可以去“在线调试”页直接点“图生图”按钮测试。

配置编辑(小白版)

这里只保留最常用字段。已发现 6 个环境变量名候选,只显示名字,不显示值。
展开 / 收起

通用账号池

这里只保留账号名和变量名。模型里勾选账号即可,不需要重复手填 api_key_env
可直接输入,也可从已有变量名候选中选择。只显示变量名,不显示真实 key。MS_API_KEY_A、MS_API_KEY_B、MS_API_KEY_C、MS_API_KEY_D、GPG_KEY、MS_BASE_URL
通用账号名
API Key 变量名
通用账号名
API Key 变量名
通用账号名
API Key 变量名
通用账号名
API Key 变量名
模型配置 #1
deepseek-v3-2
能力
模型 ID
显示名
账号选择
已选账号:4/4。这个模型已经套用了全部通用账号。
高级选项
优先级(越小越先试)
备注
当前能力:聊天
估算额度:50
上游路径:/chat/completions
模型配置 #2
qwen3-next-80b-instruct
能力
模型 ID
显示名
账号选择
已选账号:4/4。这个模型已经套用了全部通用账号。
高级选项
优先级(越小越先试)
备注
当前能力:聊天
估算额度:50
上游路径:/chat/completions
模型配置 #3
glm-4-6v
能力
模型 ID
显示名
账号选择
已选账号:4/4。这个模型已经套用了全部通用账号。
高级选项
优先级(越小越先试)
备注
当前能力:看图
估算额度:50
上游路径:/chat/completions
模型配置 #4
qwen3-vl-235b-instruct
能力
模型 ID
显示名
账号选择
已选账号:4/4。这个模型已经套用了全部通用账号。
高级选项
优先级(越小越先试)
备注
当前能力:看图
估算额度:30
上游路径:/chat/completions
模型配置 #5
qwen-image-2512
能力
模型 ID
显示名
账号选择
已选账号:4/4。这个模型已经套用了全部通用账号。
高级选项
优先级(越小越先试)
备注
当前能力:文生图
估算额度:20
上游路径:/images/generations
模型配置 #6
qwen-image
能力
模型 ID
显示名
账号选择
已选账号:4/4。这个模型已经套用了全部通用账号。
高级选项
优先级(越小越先试)
备注
当前能力:文生图
估算额度:20
上游路径:/images/generations
模型配置 #7
qwen-image-edit-2511
能力
模型 ID
显示名
账号选择
已选账号:4/4。这个模型已经套用了全部通用账号。
高级选项
优先级(越小越先试)
备注
当前能力:图生图
估算额度:20
上游路径:/images/generations
模型配置 #8
qwen-image-edit-2511
能力
模型 ID
显示名
账号选择
已选账号:4/4。这个模型已经套用了全部通用账号。
高级选项
优先级(越小越先试)
备注
当前能力:图生图
估算额度:20
上游路径:/images/generations
系统最终仍会按“每个模型 × 已勾选账号”展开成 backend rows,并尽量保留已有 name

问题提示

有异常时再展开看,避免首屏堆满状态提醒。
展开 / 收起
这个模型现在不能用:glm-4-6v
manual_model_pause
先看下面的模型列表和账号列表,确认是暂停了还是被限流了。
去看模型列表
这个账号现在是暂停状态:account-a
manual_model_pause
如果确认要继续用它,可以在下面点恢复。
去看账号列表
这个账号现在是暂停状态:account-b
manual_model_pause
如果确认要继续用它,可以在下面点恢复。
去看账号列表
这个账号现在是暂停状态:account-c
manual_model_pause
如果确认要继续用它,可以在下面点恢复。
去看账号列表
这个账号现在是暂停状态:account-d
manual_model_pause
如果确认要继续用它,可以在下面点恢复。
去看账号列表

模型列表

这里看模型状态,必要时暂停或恢复。
展开 / 收起
模型能力现在能不能用账号情况原因操作
glm-4-6v
真实模型:ZhipuAI/GLM-4.6V
vision全部不能用账号数 4 / 总账号 4 / 现在可用 0
已暂停 4 / 被限流 0
manual_model_pause
deepseek-v3-2
真实模型:deepseek-ai/DeepSeek-V3.2
chat能用账号数 4 / 总账号 4 / 现在可用 4
已暂停 0 / 被限流 0
这个模型现在可以正常接单。
qwen3-next-80b-instruct
真实模型:Qwen/Qwen3-Next-80B-A3B-Instruct
chat能用账号数 4 / 总账号 4 / 现在可用 4
已暂停 0 / 被限流 0
这个模型现在可以正常接单。
qwen-image-edit-2511
真实模型:Qwen/Qwen-Image-Edit-2511
image_to_image能用账号数 4 / 总账号 8 / 现在可用 8
已暂停 0 / 被限流 0
这个模型现在可以正常接单。
qwen-image
真实模型:Qwen/Qwen-Image
text_to_image能用账号数 4 / 总账号 4 / 现在可用 4
已暂停 0 / 被限流 0
这个模型现在可以正常接单。
qwen-image-2512
真实模型:Qwen/Qwen-Image-2512
text_to_image能用账号数 4 / 总账号 4 / 现在可用 4
已暂停 0 / 被限流 0
这个模型现在可以正常接单。
qwen3-vl-235b-instruct
真实模型:Qwen/Qwen3-VL-235B-A22B-Instruct
vision能用账号数 4 / 总账号 4 / 现在可用 4
已暂停 0 / 被限流 0
这个模型现在可以正常接单。

账号列表

这里看每个账号服务哪些模型,以及暂停/限流状态。
展开 / 收起
查看全部
像 qwen3-next-80b-instruct、glm-4-6v 这类只看到 3 个账号的模型,不是页面漏显示,而是当前配置文件里本来就只配了 3 条账号。
账号服务模型能力当前状态原因说明操作
account-aZhipuAI/GLM-4.6Vvision已暂停manual_model_pause调用 3 / 成功 0 / 失败 3
总额度剩余 1959 / 模型额度剩余 94
系统内名称:glm-4-6v-account-a
account-bZhipuAI/GLM-4.6Vvision已暂停manual_model_pause调用 3 / 成功 0 / 失败 3
总额度剩余 1972 / 模型额度剩余 95
系统内名称:glm-4-6v-account-b
account-cZhipuAI/GLM-4.6Vvision已暂停manual_model_pause调用 3 / 成功 0 / 失败 3
总额度剩余 1975 / 模型额度剩余 95
系统内名称:glm-4-6v-account-c
account-dZhipuAI/GLM-4.6Vvision已暂停manual_model_pause调用 3 / 成功 0 / 失败 3
总额度剩余 1958 / 模型额度剩余 94
系统内名称:glm-4-6v-account-d
account-aQwen/Qwen-Imagetext_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-account-a
account-aQwen/Qwen-Image-2512text_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-2512-account-a
account-aQwen/Qwen-Image-Edit-2511image_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-edit-2511-account-a
account-aQwen/Qwen-Image-Edit-2511image_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-edit-2511-account-a-image-to-image
account-aQwen/Qwen3-Next-80B-A3B-Instructchat正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen3-next-80b-a3b-instruct-account-a
account-aQwen/Qwen3-VL-235B-A22B-Instructvision正常这个账号现在可以正常使用。调用 1 / 成功 1 / 失败 0
总额度剩余 1962 / 模型额度剩余 96
系统内名称:qwen3-vl-235b-a22b-instruct-account-a
account-adeepseek-ai/DeepSeek-V3.2chat正常这个账号现在可以正常使用。调用 3 / 成功 3 / 失败 0
总额度剩余 1957 / 模型额度剩余 12
系统内名称:deepseek-v3-2-account-a
account-bQwen/Qwen-Imagetext_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-account-b
account-bQwen/Qwen-Image-2512text_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-2512-account-b
account-bQwen/Qwen-Image-Edit-2511image_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-edit-2511-account-b-image-to-image
account-bQwen/Qwen-Image-Edit-2511image_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-edit-2511-account-b
account-bQwen/Qwen3-Next-80B-A3B-Instructchat正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen3-next-80b-instruct-account-b
account-bQwen/Qwen3-VL-235B-A22B-Instructvision正常这个账号现在可以正常使用。调用 1 / 成功 1 / 失败 0
总额度剩余 1975 / 模型额度剩余 98
系统内名称:qwen3-vl-235b-a22b-instruct-account-b
account-bdeepseek-ai/DeepSeek-V3.2chat正常这个账号现在可以正常使用。调用 3 / 成功 3 / 失败 0
总额度剩余 1969 / 模型额度剩余 14
系统内名称:deepseek-v3-2-account-b
account-cQwen/Qwen-Imagetext_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-account-c
account-cQwen/Qwen-Image-2512text_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-2512-account-c
account-cQwen/Qwen-Image-Edit-2511image_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-edit-2511-account-c
account-cQwen/Qwen-Image-Edit-2511image_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-edit-2511-account-c-image-to-image
account-cQwen/Qwen3-Next-80B-A3B-Instructchat正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen3-next-80b-a3b-instruct-account-c
account-cQwen/Qwen3-VL-235B-A22B-Instructvision正常这个账号现在可以正常使用。调用 1 / 成功 1 / 失败 0
总额度剩余 1974 / 模型额度剩余 99
系统内名称:qwen3-vl-235b-a22b-instruct-account-c
account-cdeepseek-ai/DeepSeek-V3.2chat正常这个账号现在可以正常使用。调用 3 / 成功 3 / 失败 0
总额度剩余 1971 / 模型额度剩余 16
系统内名称:deepseek-v3-2-account-c
account-dQwen/Qwen-Imagetext_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-account-d
account-dQwen/Qwen-Image-2512text_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-2512-account-d
account-dQwen/Qwen-Image-Edit-2511image_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-edit-2511-account-d
account-dQwen/Qwen-Image-Edit-2511image_to_image正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen-image-edit-2511-account-d-image-to-image
account-dQwen/Qwen3-Next-80B-A3B-Instructchat正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen3-next-80b-a3b-instruct-account-d
account-dQwen/Qwen3-VL-235B-A22B-Instructvision正常这个账号现在可以正常使用。调用 0 / 成功 0 / 失败 0
总额度剩余 None / 模型额度剩余 None
系统内名称:qwen3-vl-235b-a22b-instruct-account-d
account-ddeepseek-ai/DeepSeek-V3.2chat正常这个账号现在可以正常使用。调用 3 / 成功 3 / 失败 0
总额度剩余 1955 / 模型额度剩余 16
系统内名称:deepseek-v3-2-account-d

高级 JSON

保留原始配置兜底入口,但默认不打扰首屏。
展开 / 收起

高级模式(需要时再用)

这里只保留 config.json 原始 JSON 预览和兜底编辑入口。真实 API Key 还是继续放在 .env 或 Docker 环境变量里,不要直接写进网页。

改之前先知道

function:表示能力类型,比如聊天、看图、文生图。
alias:给调用方看的名字,可以填更好懂的别名。
api_key_env:这里填环境变量名字,不是直接填真实 key。
priority:数字越小越先尝试。
name:系统内部标识,会自动保留或自动生成。
像 qwen3-next-80b-instruct、glm-4-6v 这类当前只有 3 个账号的模型,是因为配置文件里确实只有 3 条账号配置。

当前配置提醒

当前没有配置告警。