ContextQMD
Back to Lobehub

ModelScope 提供商配置

docs/usage/providers/modelscope.zh-CN.mdx

2.1.563.3 KB
Original Source

ModelScope 提供商配置

ModelScope（魔塔社区）是阿里巴巴的开源模型社区，提供各种 AI 模型的访问服务。本指南将帮助您在 LobeHub 中设置 ModelScope 提供商。

前置条件

在使用 ModelScope API 之前，您需要：

  1. 创建 ModelScope 账户

  2. 绑定阿里云账户

    • 重要：ModelScope API 需要绑定阿里云账户
    • 访问您的 ModelScope 访问令牌页面
    • 按照说明绑定您的阿里云账户
    • 此步骤是 API 访问的必要条件

  3. 获取 API 令牌

    • 绑定阿里云账户后，生成 API 令牌
    • 复制令牌以在 LobeHub 中使用

配置

环境变量

在您的 .env 文件中添加以下环境变量：

bash
# 启用 ModelScope 提供商
ENABLED_MODELSCOPE=1

# ModelScope API 密钥（必需）
MODELSCOPE_API_KEY=your_modelscope_api_token

# 可选：自定义模型列表（逗号分隔）
MODELSCOPE_MODEL_LIST=deepseek-ai/DeepSeek-V3-0324,Qwen/Qwen3-235B-A22B

# 可选：代理 URL（如需要）
MODELSCOPE_PROXY_URL=https://your-proxy-url

Docker 配置

如果使用 Docker，请在您的 docker-compose.yml 中添加 ModelScope 环境变量：

yaml
environment:
  - ENABLED_MODELSCOPE=1
  - MODELSCOPE_API_KEY=your_modelscope_api_token
  - MODELSCOPE_MODEL_LIST=deepseek-ai/DeepSeek-V3-0324,Qwen/Qwen3-235B-A22B

可用模型

ModelScope 提供各种模型的访问，包括：

  • DeepSeek 模型：DeepSeek-V3、DeepSeek-R1 系列
  • Qwen 模型：Qwen3 系列、Qwen2.5 系列
  • Llama 模型：Meta-Llama-3 系列
  • 其他模型：各种开源模型

故障排除

常见问题

  1. "请先绑定阿里云账户后使用" 错误

  2. 401 认证错误

    • 检查您的 API 令牌是否正确
    • 确保令牌没有过期
    • 验证您的阿里云账户是否正确绑定

  3. 模型不可用

    • 某些模型可能需要额外权限
    • 查看 ModelScope 上模型页面的访问要求

调试模式

启用调试模式以查看详细日志：

bash
DEBUG_MODELSCOPE_CHAT_COMPLETION=1

注意事项

  • ModelScope API 与 OpenAI API 格式兼容
  • 该服务主要面向中国用户设计
  • 某些模型可能有使用限制或需要额外验证
  • 某些模型的 API 响应默认为中文

支持

对于 ModelScope 特定问题：

对于 LobeHub 集成问题：

模型 ID 格式

ModelScope 使用命名空间前缀格式的模型 ID，例如：

deepseek-ai/DeepSeek-V3-0324
deepseek-ai/DeepSeek-R1-0528
Qwen/Qwen3-235B-A22B
Qwen/Qwen3-32B

在配置模型列表时，请使用完整的模型 ID 格式。

API 限制

  • ModelScope API 有速率限制
  • 某些模型可能需要特殊权限
  • 建议在生产环境中监控 API 使用情况
  • 部分高级模型可能需要付费使用