mirror of
https://github.com/lobehub/lobehub
synced 2026-04-21 09:37:28 +00:00
137 lines
3.8 KiB
Text
137 lines
3.8 KiB
Text
---
|
|
title: ModelScope Provider Configuration
|
|
description: Learn how to configure and use the ModelScope provider in LobeHub
|
|
tags:
|
|
- ModelScope
|
|
---
|
|
|
|
# ModelScope Provider Configuration
|
|
|
|
ModelScope is an open-source AI model community by Alibaba, offering access to a wide range of AI models. This guide will walk you through setting up the ModelScope provider in LobeHub.
|
|
|
|
## Prerequisites
|
|
|
|
Before using the ModelScope API, you need to:
|
|
|
|
1. **Create a ModelScope Account**
|
|
|
|
- Visit [ModelScope](https://www.modelscope.cn/)
|
|
- Sign up for an account
|
|
|
|
2. **Link Your Alibaba Cloud Account**
|
|
|
|
- **Important**: Accessing the ModelScope API requires linking your Alibaba Cloud account
|
|
- Go to your [ModelScope Access Token Page](https://www.modelscope.cn/my/myaccesstoken)
|
|
- Follow the instructions to link your Alibaba Cloud account
|
|
- This step is mandatory for API access
|
|
|
|
3. **Obtain an API Token**
|
|
- After linking your Alibaba Cloud account, generate an API token
|
|
- Copy the token for use in LobeHub
|
|
|
|
## Configuration
|
|
|
|
### Environment Variables
|
|
|
|
Add the following environment variables to your `.env` file:
|
|
|
|
```bash
|
|
# Enable ModelScope provider
|
|
ENABLED_MODELSCOPE=1
|
|
|
|
# ModelScope API key (required)
|
|
MODELSCOPE_API_KEY=your_modelscope_api_token
|
|
|
|
# Optional: Custom model list (comma-separated)
|
|
MODELSCOPE_MODEL_LIST=deepseek-ai/DeepSeek-V3-0324,Qwen/Qwen3-235B-A22B
|
|
|
|
# Optional: Proxy URL (if needed)
|
|
MODELSCOPE_PROXY_URL=https://your-proxy-url
|
|
```
|
|
|
|
### Docker Configuration
|
|
|
|
If you're using Docker, add the ModelScope environment variables to your `docker-compose.yml`:
|
|
|
|
```yaml
|
|
environment:
|
|
- ENABLED_MODELSCOPE=1
|
|
- MODELSCOPE_API_KEY=your_modelscope_api_token
|
|
- MODELSCOPE_MODEL_LIST=deepseek-ai/DeepSeek-V3-0324,Qwen/Qwen3-235B-A22B
|
|
```
|
|
|
|
## Available Models
|
|
|
|
ModelScope provides access to a variety of models, including:
|
|
|
|
- **DeepSeek Models**: DeepSeek-V3, DeepSeek-R1 series
|
|
- **Qwen Models**: Qwen3 series, Qwen2.5 series
|
|
- **Llama Models**: Meta-Llama-3 series
|
|
- **Other Models**: Various open-source models
|
|
|
|
## Troubleshooting
|
|
|
|
### Common Issues
|
|
|
|
1. **"Please link your Alibaba Cloud account first" error**
|
|
|
|
- This means your Alibaba Cloud account is not yet linked to ModelScope
|
|
- Visit the [ModelScope Access Token Page](https://www.modelscope.cn/my/myaccesstoken)
|
|
- Complete the account linking process
|
|
|
|
2. **401 Unauthorized Error**
|
|
|
|
- Check if your API token is correct
|
|
- Ensure the token has not expired
|
|
- Verify that your Alibaba Cloud account is properly linked
|
|
|
|
3. **Model Unavailable**
|
|
- Some models may require additional permissions
|
|
- Check the model's page on ModelScope for access requirements
|
|
|
|
### Debug Mode
|
|
|
|
Enable debug mode to view detailed logs:
|
|
|
|
```bash
|
|
DEBUG_MODELSCOPE_CHAT_COMPLETION=1
|
|
```
|
|
|
|
## Notes
|
|
|
|
- The ModelScope API is compatible with the OpenAI API format
|
|
- This service is primarily designed for users in China
|
|
- Some models may have usage restrictions or require additional verification
|
|
- API responses for certain models may default to Chinese
|
|
|
|
## Support
|
|
|
|
For ModelScope-specific issues:
|
|
|
|
- Visit the [ModelScope Documentation](https://www.modelscope.cn/docs)
|
|
- Check out the [ModelScope Community](https://www.modelscope.cn/community)
|
|
|
|
For LobeHub integration issues:
|
|
|
|
- Browse our [GitHub Issues](https://github.com/lobehub/lobehub/issues)
|
|
- Join our community discussions
|
|
|
|
## Model ID Format
|
|
|
|
ModelScope uses a namespace-prefixed format for model IDs, for example:
|
|
|
|
```
|
|
deepseek-ai/DeepSeek-V3-0324
|
|
deepseek-ai/DeepSeek-R1-0528
|
|
Qwen/Qwen3-235B-A22B
|
|
Qwen/Qwen3-32B
|
|
```
|
|
|
|
When configuring the model list, be sure to use the full model ID format.
|
|
|
|
## API Limitations
|
|
|
|
- The ModelScope API is subject to rate limits
|
|
- Some models may require special permissions
|
|
- It's recommended to monitor API usage in production environments
|
|
- Certain advanced models may require a paid subscription to access
|