openclaw/docs/providers/shengsuanyun.md

summary	read_when
Use ShengSuanYun (胜算云) models in Moltbot	You want to use ShengSuanYun model router You need ShengSuanYun setup guidance

ShengSuanYun (胜算云)

ShengSuanYun provides a unified router for accessing multiple AI model providers through a single API endpoint, supporting both LLM models and multimodal generative models (text-to-image, image-to-video, etc.).

Why ShengSuanYun in Moltbot

• Unified API for multiple model providers
• LLM Support: OpenAI, Anthropic, Google, DeepSeek, and many others
• Multimodal Support: Text-to-image, image-to-video, and other generative models
• OpenAI-compatible /v1 endpoints for LLMs
• Anthropic-compatible /v1/messages endpoint
• Wide model selection from different providers
• Automatic model discovery from the provider's API

Features

LLM Models

• Multi-provider access: Access models from OpenAI, Anthropic, Google, Ali, ByteDance, DeepSeek, Meta, and more
• Multiple API formats: Supports /v1/chat/completions, /v1/messages, and /v1/responses
• Streaming: ✅ Supported on all compatible models
• Function calling: ✅ Supported on compatible models
• Vision: ✅ Supported on models with vision capability
• Dynamic model discovery: Models are automatically discovered from the API

Multimodal Models

• Text-to-Image: GPT-Image, Doubao-Seedream, Qwen-Image-Plus, Flux models
• Text-to-Video: Veo3.1, Sora2, 通义万相 (Wanxiang) models
• Image-to-Video: Doubao-Seedance, Wanxiang image-to-video models
• Image-to-Image: Flux-kontext-pro, Wanxiang image editing models
• Automatic discovery: Over 200+ multimodal models available

Setup

1. Get API Key

1. Sign up at ShengSuanYun
2. Navigate to API settings
3. Generate an API key

2. Configure Moltbot

Option A: Environment Variable

export SHENGSUANYUN_API_KEY="your-api-key"

Option B: Config File

Add to your moltbot.json:

{
  env: { SHENGSUANYUN_API_KEY: "your-api-key" },
  agents: {
    defaults: {
      model: { primary: "shengsuanyun/anthropic/claude-opus-4.5" }
    }
  }
}

3. Verify Setup

moltbot models list | grep shengsuanyun
moltbot chat --model shengsuanyun/anthropic/claude-opus-4.5 "Hello, are you working?"

Model Selection

ShengSuanYun provides access to hundreds of models from various providers. Models are identified by their provider prefix:

LLM Providers

• OpenAI: openai/gpt-5.1, openai/gpt-5.2, openai/o3
• Anthropic: anthropic/claude-opus-4.5, anthropic/claude-sonnet-4.5, anthropic/claude-haiku-4.5
• Google: google/gemini-3-pro-preview, google/gemini-3-flash
• DeepSeek: deepseek/deepseek-chat, deepseek/deepseek-reasoner
• Ali: Various Qwen models
• ByteDance: Various Doubao models
• Meta: Llama models
• And many more...

Multimodal Models

Multimodal models use the prefix modality/{id} format:

Text-to-Image Models

• GPT-Image: OpenAI's image generation models
• Doubao-Seedream: ByteDance's text-to-image models (4.5 series)
• Qwen-Image-Plus: Ali's advanced image generation
• Flux: BlackForestLabs' high-quality image models

Text-to-Video Models

• Veo3.1: Google's video generation model
• Sora2: OpenAI's video generation model
• 通义万相 (Wanxiang): Ali's text-to-video models (2.2-Plus)

Image-to-Video Models

• Doubao-Seedance: ByteDance's image-to-video conversion
• 通义万相 (Wanxiang): Ali's image-to-video models (2.5, 2.6)

Image-to-Image Models

• Flux-kontext-pro: Advanced image editing
• 通义万相 (Wanxiang): Ali's image editing models (2.5)

List all available models:

# List all models
moltbot models list | grep shengsuanyun

# List only LLM models
moltbot models list | grep "shengsuanyun" | grep -v "modality"

# List only multimodal models
moltbot models list | grep "shengsuanyun/modality"

Change your default model:

# Set LLM model
moltbot models set shengsuanyun/anthropic/claude-opus-4.5

# Set multimodal model (if supported by your workflow)
moltbot models set shengsuanyun/modality/256

Model Discovery

Moltbot automatically discovers models from two ShengSuanYun APIs when SHENGSUANYUN_API_KEY is configured:

1. LLM Models API: https://router.shengsuanyun.com/api/v1/models

   • Returns all text-based chat and completion models
   • Includes models from major AI providers
   • Supports filtering by API compatibility

2. Multimodal Models API: https://api.shengsuanyun.com/modelrouter/modalities/list

   • Returns generative models for images and videos
   • Includes text-to-image, image-to-video, and image-to-image models
   • Over 200+ models available

Each model includes:

• Model ID and name
• Company/provider information
• Context window size and max tokens (for LLMs)
• Maximum output tokens
• Supported APIs
• Pricing information
• Input modality support (text, image, etc.)
• Model capabilities and classifications

API Compatibility

ShengSuanYun supports multiple API formats:

API Format	Endpoint	Compatible With
OpenAI Completions	/v1/chat/completions	OpenAI SDK
Anthropic Messages	/v1/messages	Claude SDK
OpenAI Responses	/v1/responses	OpenAI SDK

Moltbot automatically uses the appropriate API format based on the model's capabilities, preferring the OpenAI completions format when available.

Usage Examples

LLM Models

# Use Claude via ShengSuanYun
moltbot chat --model shengsuanyun/anthropic/claude-opus-4.5

# Use GPT-5.2
moltbot chat --model shengsuanyun/openai/gpt-5.2

# Use Gemini
moltbot chat --model shengsuanyun/google/gemini-3-pro-preview

# Use DeepSeek
moltbot chat --model shengsuanyun/deepseek/deepseek-chat

Multimodal Models

Note: Multimodal model integration depends on your specific workflow and use case. The models are discovered and listed but may require additional configuration or API integration for image/video generation tasks.

# List available multimodal models
moltbot models list | grep "modality"

# Example multimodal model IDs (text-to-image, image-to-video, etc.)
# - shengsuanyun/modality/256  (Ali Wanxiang 2.6 I2V)
# - shengsuanyun/modality/XXX  (Other generative models)

Configuration Example

Full configuration in moltbot.json:

{
  env: { SHENGSUANYUN_API_KEY: "your-api-key" },
  agents: {
    defaults: {
      model: { primary: "shengsuanyun/anthropic/claude-opus-4.5" }
    }
  },
  models: {
    mode: "merge",
    providers: {
      shengsuanyun: {
        baseUrl: "https://router.shengsuanyun.com/api/v1",
        apiKey: "${SHENGSUANYUN_API_KEY}",
        api: "openai-completions",
        models: []  // Models are auto-discovered
      }
    }
  }
}

Pricing

ShengSuanYun uses its own pricing model. Check the ShengSuanYun dashboard for current rates per model. Pricing varies by:

• Model provider
• Model size and capability
• Input/output tokens
• Additional features (vision, etc.)

Troubleshooting

API key not recognized

echo $SHENGSUANYUN_API_KEY
moltbot models list | grep shengsuanyun

Verify your API key is valid and has the correct permissions.

Model not available

The ShengSuanYun model catalog updates dynamically. Run moltbot models list to see currently available models. Some models may be temporarily unavailable.

Connection issues

ShengSuanYun API is at https://router.shengsuanyun.com/api/v1. Ensure your network allows HTTPS connections.

Links

• ShengSuanYun Website
• Model List API