1. token配置和使用手册
silievo用户使用手册
  • token配置和使用手册
    • 01-概要
    • 02-模型、价格
    • 03-模型接入
    • 04-常见问题
    • 05-合作伙伴与法律声明
    • 06-联系我们
    • 周活动特辑-免费模型接入指南
    • 视频模型
      • wan2.7视频模型接口
      • happyhorse视频模型接口
    • 向量模型
      • 向量模型接口
    • 语音模型
      • 语音合成接口
      • 音色创建接口
    • 文件上传
      • 文件上传接口
    • cc-switch接入各种工具
      • CC-Switch接入claude code命令行版
      • cc-switch接入claude code桌面版
    • 图像模型
      • gpt-image-2生图接入
  1. token配置和使用手册

03-模型接入

03. 广泛设备的接入与调优指南#

无论您是单纯想尝试 AI 对话的用户，还是进行严肃开发的工程师，SiliEvo 都提供了完美的"热插拔"适配体验。
前提条件：
请牢记 SiliEvo 中转服务的核心两要素，缺一不可：
1.
中转基地址 (Base URL): https://api.numspirit.com/
2.
安全秘钥 (API Key / Token): 通过平台官网 https://numspirit.com 或联系 15685255305 申请，形如 sk-silievo-xxxxxxxx。

🛠️ 第一部分：开发者快速连通测试#

方法 1：使用 Postman#

若需要抓包或详尽测试网络响应时间：
1.
Method: POST
2.
URL: https://api.numspirit.com/v1/chat/completions
3.
Headers 头部:
Content-Type: application/json
Authorization: Bearer sk-silievo-xxxxxxxx (在这里换成你的Key，注意 Bearer 后带空格)
4.
Body 内容 (raw + JSON):
{
    "model": "qwen3.6-plus",
    "messages": [
        { "role": "system", "content": "你是一位优秀的向导。" },
        { "role": "user", "content": "跟我打个招呼！" }
    ],
    "stream": false
}
点击 Send 后，您会在下方窗口收到带有 choices 的 JSON 格式的回复大包。

方法 2：使用 cURL 命令行终端#

打开 Mac Terminal 或 Windows PowerShell/CMD 进行一键测试：

💬 第二部分：文字聊天接口#

2.1 OpenAI 标准格式 - /v1/chat/completions#

接口: POST https://api.numspirit.com/v1/chat/completions
请求 Header:
Content-Type: application/json
Authorization: Bearer sk-silievo-xxxxxxxx
请求参数:
{
    "model": "huawei/glm-5.1",
    "messages": [
        {
            "role": "user",
            "content": "你觉得所有的疾病可以被攻克吗？"
        }
    ],
    "stream": false
}
响应示例:
{
    "id": "a92e1dfb5fe642ae8bd115af2c8300e0",
    "object": "chat.completion",
    "created": 1781526640,
    "model": "glm-5.1",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "这是一个非常宏大且深刻的问题..."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 12,
        "total_tokens": 2070,
        "completion_tokens": 2058
    }
}

2.2 Anthropic 兼容格式 - /v1/messages#

接口: POST https://api.numspirit.com/v1/messages
请求参数:
{
    "model": "gpt-5.2",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "猪八戒为啥老是嚷嚷着分行李？"
        }
    ],
    "stream": false
}
响应示例:
{
    "id": "resp_0e497ebcaf76e3a1006a2fee23ec7c8196b288e482e1433da9",
    "type": "message",
    "role": "assistant",
    "model": "gpt-5.2",
    "usage": {
        "input_tokens": 32,
        "output_tokens": 429
    },
    "content": [
        {
            "type": "text",
            "text": "猪八戒老嚷嚷“分行李”，主要是《西游记》里作者用来塑造他..."
        }
    ],
    "stop_reason": "end_turn"
}

2.3 OpenAI Responses 兼容格式 - /v1/responses#

接口: POST https://api.numspirit.com/v1/responses
请求参数:
{
    "model": "qwen3.6-flash",
    "input": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "猪八戒为什么在取经路上不断地要分行李？"
        }
    ],
    "stream": true
}
响应示例:
{
    "id": "chatcmpl-9a1d18cd-e83b-96d4-90e8-c0b8ce4d5d6e",
    "object": "response",
    "created": 1781527443,
    "model": "qwen3.6-flash",
    "status": "completed",
    "output": [
        {
            "type": "message",
            "role": "assistant",
            "content": [
                {
                    "type": "output_text",
                    "text": "猪八戒在《西游记》中屡次嚷着“分行李”..."
                }
            ]
        }
    ],
    "usage": {
        "input_tokens": 31,
        "output_tokens": 2097,
        "total_tokens": 2128
    }
}

🖼️ 第三部分：图片生成接口（文生图/图生图）#

SiliEvo 平台支持图片生成能力，接口采用 OpenAI 兼容格式。

3.1 接口概览#

功能接口路径方法说明
图片生成/v1/images/generationsPOST文生图（同步返回）

3.2 文生图#

接口: POST https://api.numspirit.com/v1/images/generations
请求参数:
{
    "prompt": "孙悟空在天空上飞行，他正在追赶一个妖怪！",
    "model":"gpt-image-2",
    "size": "1024x1024",
    "quality": "low",
    "output_compression": 100,
    "output_format": "png",
    "n": 1
}
参数说明:
参数类型必填说明
promptstring是提示词，描述要生成的图片内容
modelstring是模型名称，当前仅gpt-image-2
sizestring是图片尺寸，可选值：1024x1024、1920x1080、1080x1920、1440x2560、2560x1440、1280x3840、3840x1280
qualitystring是图片质量，可选值：low、medium、high
output_compressioninteger否输出压缩比例，默认 100（100%不压缩），范围 1-100
output_formatstring否输出格式，默认 png，可选值：png、jpeg、webp
ninteger否生成数量，默认 1，范围 1-10
响应示例（成功）:
{
    "created": 1781526551,
    "background": "opaque",
    "data": [
        {
            "b64_json": "这是一段图片的base64编码。。很长很长这里暂时用一段描述替代"
        }
    ],
    "output_format": "png",
    "quality": "low",
    "size": "1024x1024",
    "usage": {
        "input_tokens": 22,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 22
        },
        "output_tokens": 196,
        "output_tokens_details": {
            "image_tokens": 196,
            "text_tokens": 0
        },
        "total_tokens": 218
    }
}
cURL 示例 - 文生图:
cURL 示例 - 图生图:
待补充

3.3 图生图#

待补充

3.4 完整的图片生成工作流示例（Python）#

🎬 第四部分：视频生成接口（文生视频/图生视频）#

happyhorse视频模型接入： https://app.apifox.com/project/8220618
wan2.7视频接入：https://app.apifox.com/project/8220618

💻 第五部分：主流编程语言代码挂载#

我们对 OpenAI 官方 SDK 做到了零代码修改级兼容，您只需将其重定向到 SiliEvo：

Python (推荐使用官方 openai 包)#

Node.js / TypeScript#

🦞 第六部分：高级场景 - 接入龙虾 (Lobster / OpenClaw) Agent 构架#

龙虾是强大的 Multi-Agent 开发框架。在其 JSON 配置文件中，您可以极速将底层心智引擎替换为我们要提供的丰富模型矩阵。

片段 1: 初始化大模型提供商 (Providers)#

在配置文件全局部分声明 Provider 节点：
"custom-coding-dashscope-aliyuncs-com": {
  "baseUrl": "https://api.numspirit.com/",
  "apiKey": "sk-silievo-xxxxxxxxxxxxxxxxxx",
  "api": "openai-completions",
  "models": [
    {
      "id": "qwen3.6-plus",
      "name": "qwen3.6-plus (Custom Provider)",
      "reasoning": false,
      "input": ["text"],
      "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
      "contextWindow": 262144,
      "maxTokens": 8192,
      "compat": { "supportsStrictMode": true }
    }
  ]
}

片段 2: 全局 Agents 的模型路由规划 (Defaults)#

在 agents -> defaults 下指派您的偏好机制，这样框架崩溃率会大幅降低：
"agents": {
  "defaults": {
    "model": {
      "primary": "custom-coding-dashscope-aliyuncs-com/qwen3.6-plus",
      "fallbacks": [
        "custom-coding-dashscope-aliyuncs-com/qwen3.6-plus",
        "nvidia/minimaxai/minimax-m2.5",
        "openrouter/auto",
        "openai/gpt-5.4",
        "anthropic/claude-sonnet-4-5",
        "deepseek/deepseek-reasoner",
        "opencode/qwen3.6-plus-free"
      ]
    },
    "imageModel": {
      "primary": "custom-coding-dashscope-aliyuncs-com/qwen3.6-plus"
    },
    "compaction": {
      "mode": "safeguard",
      "reserveTokens": 8000,
      "keepRecentTokens": 12000,
      "maxHistoryShare": 0.6,
      "identifierInstructions": "每次调用 read/write/edit 工具必须包含 path 参数，严禁发送空参数。"
    }
  }
}
通过以上配置，您的系统就能像搭载了 V8 引擎一样，随时享受 SiliEvo 带来的稳定模型分发响应。

📱 第七部分：接入大众化图形客户端软件#

绝大部分图形化客户端 (如 NextChat, ChatBox, ChatGPT-Web) 的配置皆为"套路化"操作：
1.
寻找 "设置 (Settings)" -> "服务商设置 / 模型配置"。
2.
选中类别：OpenAI （注意，即便是由于您要使用 Claude 或 Gemini 这类模型，在此处设置服务商分类时也必须强制选择基于 OpenAI 格式）。
3.
填入 接口地址 (API Endpoint / Base URL)：https://api.numspirit.com/。
4.
填入 秘钥 (API Key)：sk-silievo-...。
5.
在 自定义模型 (Custom Model) 文本框内，严格照抄您想调用的模型全名，例如 qwen3.6-plus 或 anthropic/claude-sonnet-4-5。

图形客户端多媒体功能配置#

对于支持图片/视频生成的客户端（如部分自定义客户端），可按照上述接口路径配置：
图片生成:
Endpoint: https://api.numspirit.com/v1/images/generations
Model: gpt-image-2
视频生成:
Endpoint: https://api.numspirit.com/v1/videos/generations
Model: happyhorse-1.0-t2v 或 happyhorse-1.0-i2v 或 happyhorse-1.0-r2v

📚 附录：错误码速查表#

错误类型HTTP 状态码说明解决方案
auth_error401认证失败，API Key 无效或未提供检查 Authorization Header 格式
quota_exceeded402额度已用尽充值或联系客服
invalid_request400请求参数错误检查请求体 JSON 格式和必填字段
no_channel503模型未配置有效渠道检查 model 参数是否正确
upstream_error502/500上游 API 错误稍后重试或联系客服
技术支持: 如有任何问题，请联系客服微信或加入服务群获取帮助。
修改于 2026-07-12 04:28:52
上一页
02-模型、价格
下一页
04-常见问题
Built with