1. token配置和使用手册
silievo用户使用手册
  • token配置和使用手册
    • 01-概要
    • 02-模型、价格
    • 03-模型接入
    • 04-常见问题
    • 05-合作伙伴与法律声明
    • 06-联系我们
    • 周活动特辑-免费模型接入指南
    • CC-Switch接入指南
  1. token配置和使用手册

周活动特辑-免费模型接入指南

周活动特辑 - 免费模型接入指南#

活动概述#

活动名称:阿里云百炼模型免费体验周
活动时间:2026年5月25日 ~ 2026年5月31日
参与条件:
已注册用户
账户余额 ≥ 9.9元
活动福利:
免费领取活动Token
7天有效期(领取后7天内可用)
无限额度调用
支持20款模型免费使用

可用模型列表(共20款)#

图像生成模型(4款)#

模型名称类型渠道代码
qwen-image-2.0图像ali_bailian
qwen-image-2.0-pro图像ali_bailian
wan2.7-image-pro图像ali_bailian
wan2.7-image图像ali_bailian

视频生成模型(3款)#

模型名称类型渠道代码
happyhorse-1.0-i2v视频ali_bailian
happyhorse-1.0-t2v视频ali_bailian
happyhorse-1.0-r2v视频ali_bailian

阿里云百炼LLM(8款)#

模型名称类型渠道代码
qwen3.7-max-2026-05-20LLMali_bailian
qwen3.7-maxLLMali_bailian
qwen-maxLLMali_bailian
qwen3.6-flash-2026-04-16LLMali_bailian
qwen3.6-flashLLMali_bailian
qwen3.6-max-previewLLMali_bailian
qwen3.6-plus-2026-04-02LLMali_bailian
qwen3.6-plusLLMali_bailian

DeepSeek模型(2款)#

模型名称类型渠道代码
deepseek-v4-proLLMali_bailian
deepseek-v4-flashLLMali_bailian

Kimi模型(1款)#

模型名称类型渠道代码
kimi-k2.6LLMali_bailian

GLM模型(2款)#

模型名称类型渠道代码
glm-5.1LLMali_bailian
glm-5LLMali_bailian

渠道配置说明#

当前支持的渠道代码#

渠道代码渠道名称渠道ID说明
ali_bailian阿里云百炼平台-阿里云百炼大模型服务
deepseekDeepSeek官方-DeepSeek官方API
huawei华为云-华为云ModelArts

渠道代码使用方式#

在模型ID前添加渠道代码前缀,格式为:渠道代码/模型ID
例如:
ali_bailian/deepseek-v4-pro
ali_bailian/glm-5.1
ali_bailian/kimi-k2.6
如果不加渠道代码前缀,系统将自动选择合适的渠道。

API接入示例#

基础信息#

API地址:https://api.numspirit.com/v1/chat/completions
认证方式:Bearer Token(活动Token)
请求格式:JSON

示例1:DeepSeek-V4-Pro(带思考模式)#

{
    "model": "ali_bailian/deepseek-v4-pro",
    "messages": [
        { "role": "user", "content": "西游记中大唐境内有哪些妖怪?" }
    ],
    "stream": false,
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high"
}

示例2:DeepSeek-V4-Flash#

{
    "model": "ali_bailian/deepseek-v4-flash",
    "messages": [
        { "role": "user", "content": "西游记中大唐境内有哪些妖怪?" }
    ],
    "stream": false,
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high"
}

示例3:Qwen3.7-Max(不带渠道前缀)#

{
    "model": "qwen3.7-max",
    "messages": [
        { "role": "user", "content": "西游记中大唐境内有哪些妖怪?" }
    ],
    "stream": false,
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high"
}

示例4:Kimi-K2.6#

{
    "model": "ali_bailian/kimi-k2.6",
    "messages": [
        { "role": "user", "content": "西游记中大唐境内有哪些妖怪?" }
    ],
    "stream": false,
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high"
}

示例5:GLM-5.1#

{
    "model": "ali_bailian/glm-5.1",
    "messages": [
        { "role": "user", "content": "西游记中大唐境内有哪些妖怪?" }
    ],
    "stream": false,
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high"
}

示例6:GLM-5#

{
    "model": "ali_bailian/glm-5",
    "messages": [
        { "role": "user", "content": "西游记中大唐境内有哪些妖怪?" }
    ],
    "stream": false,
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high"
}

示例7:Qwen-Max#

{
    "model": "ali_bailian/qwen-max",
    "messages": [
        { "role": "user", "content": "西游记中大唐境内有哪些妖怪?" }
    ],
    "stream": false,
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high"
}

流式输出示例#

将 stream 参数设置为 true 即可开启流式输出:
{
    "model": "ali_bailian/deepseek-v4-pro",
    "messages": [
        { "role": "user", "content": "你好" }
    ],
    "stream": true
}

注意事项#

1.
Token有效期:领取后7天内有效,过期无法使用
2.
模型限制:只能调用上述20款模型,其他模型会返回403错误
3.
额度限制:虽然显示无限额度,但仍受阿里云上游限制
4.
渠道选择:
优先使用 ali_bailian/ 前缀,确保走阿里云渠道
不带前缀时系统会自动选择,但可能不是最优渠道
5.
错误处理:
401:Token无效或已过期
403:模型不在活动列表中
404:渠道配置错误
400 Arrearage:阿里云账户欠费(需联系管理员)

获取活动Token#

1.
访问活动页面:https://numspirit.com/promo/aliyun-free-week/
2.
登录账户(确保余额≥9.9元)
3.
点击"立即免费领取"
4.
在个人中心查看Token详情

技术支持#

如有问题,请联系:
客服微信:扫码添加专属客服
用户服务群:加入用户群获取最新资讯

视频生成接入指南#

活动Token同样支持视频生成模型(happyhorse系列),以下是完整的接入示例。

前置步骤:上传图片#

图生视频和多图生视频需要先上传图片获取URL。
上传接口:
POST https://numspirit.com/api/media/upload-for-video
Authorization: Bearer sk-aliyun-xxxxxxxxxxxxxxxx
Content-Type: multipart/form-data
请求体:
file: 图片二进制文件
响应示例:
{
    "success": true,
    "data": {
        "ossKey": "users/11/video-inputs/2026-05/c4ac6b655c1be67e9988fc843f24c08a.png",
        "url": "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/11/video-inputs/2026-05/c4ac6b655c1be67e9988fc843f24c08a.png?OSSAccessKeyId=LTAI5t8QU7ZfDy2JxKckpbZb&Expires=1779730460&Signature=3ZOEVAZXJ%2FtYZkpxSBwleEtZHr0%3D",
        "mime": "image/png",
        "size": 2414264,
        "expiresIn": 3600
    }
}
注意:URL有效期为1小时,过期后需要重新上传获取新URL。

示例1:文生视频(Text-to-Video)#

接口信息:
POST https://api.numspirit.com/v1/videos/generations
Authorization: Bearer sk-aliyun-xxxxxxxxxxxxxxxx
Content-Type: application/json
X-DashScope-Async: enable
请求体:
{
    "model": "happyhorse-1.0-t2v",
    "prompt": "一座未来城市,飞行汽车在空中穿梭,霓虹灯光闪烁",
    "ratio": "16:9",
    "resolution": "720P",
    "duration": 5
}
响应示例:
{
    "success": true,
    "data": {
        "task_id": "f4945b26-c518-42f3-8b97-95788073ab19",
        "model": "happyhorse-1.0-t2v",
        "mode": "text2video",
        "status": "PENDING"
    }
}

示例2:图生视频(Image-to-Video)#

需要先在图片上传接口获取图片URL。
接口信息:
POST https://api.numspirit.com/v1/videos/generations
Authorization: Bearer sk-aliyun-xxxxxxxxxxxxxxxx
Content-Type: application/json
X-DashScope-Async: enable
请求体:
{
    "model": "happyhorse-1.0-i2v",
    "prompt": "让图片中的场景动起来,车辆开始行驶",
    "image": "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/11/video-inputs/2026-05/c4ac6b655c1be67e9988fc843f24c08a.png?OSSAccessKeyId=LTAI5t8QU7ZfDy2JxKckpbZb&Expires=1779730460&Signature=3ZOEVAZXJ%2FtYZkpxSBwleEtZHr0%3D",
    "ratio": "16:9",
    "resolution": "720P",
    "duration": 5
}
响应示例:
{
    "success": true,
    "data": {
        "task_id": "18bb31e9-2c01-497d-8353-6a10d75c0b2b",
        "model": "happyhorse-1.0-i2v",
        "mode": "image2video",
        "status": "PENDING"
    }
}

示例3:多图参考生视频(Reference-to-Video)#

需要上传2-5张图片作为参考。
接口信息:
POST https://api.numspirit.com/v1/videos/generations
Authorization: Bearer sk-aliyun-xxxxxxxxxxxxxxxx
Content-Type: application/json
X-DashScope-Async: enable
请求体:
{
    "model": "happyhorse-1.0-r2v",
    "prompt": "[Image 1]中的场景,[Image 2]中的元素融入其中,画面流畅过渡,展现动态效果",
    "images": [
        "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/11/video-inputs/2026-05/c4ac6b655c1be67e9988fc843f24c08a.png?OSSAccessKeyId=LTAI5t8QU7ZfDy2JxKckpbZb&Expires=1779730460&Signature=3ZOEVAZXJ%2FtYZkpxSBwleEtZHr0%3D",
        "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/11/video-inputs/2026-05/f652c3d0d59e3553d4a7654a50dcbfa8.png?OSSAccessKeyId=LTAI5t8QU7ZfDy2JxKckpbZb&Expires=1779731733&Signature=l9jWQQ99pJVfucPIDAIgZGWG%2BxI%3D"
    ],
    "ratio": "16:9",
    "resolution": "720P",
    "duration": 5
}
响应示例:
{
    "success": true,
    "data": {
        "task_id": "9255f50d-adf6-4c90-8311-3193df872fbd",
        "model": "happyhorse-1.0-r2v",
        "mode": "reference2video",
        "status": "PENDING"
    }
}

查询任务状态#

视频生成是异步任务,需要轮询查询状态。
接口信息:
GET https://api.numspirit.com/v1/videos/generations/{task_id}?model={model}
Authorization: Bearer sk-aliyun-xxxxxxxxxxxxxxxx
示例:
GET https://api.numspirit.com/v1/videos/generations/f4945b26-c518-42f3-8b97-95788073ab19?model=happyhorse-1.0-t2v
进行中响应:
{
    "success": true,
    "data": {
        "task_id": "f4945b26-c518-42f3-8b97-95788073ab19",
        "status": "running",
        "output_urls": [],
        "error": null
    }
}
完成响应:
{
    "success": true,
    "data": {
        "task_id": "f4945b26-c518-42f3-8b97-95788073ab19",
        "status": "succeeded",
        "output_urls": [
            "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../video_720p_xxx.mp4"
        ],
        "error": null
    }
}
失败响应:
{
    "success": true,
    "data": {
        "task_id": "f4945b26-c518-42f3-8b97-95788073ab19",
        "status": "failed",
        "output_urls": [],
        "error": "生成失败原因"
    }
}
状态说明:
PENDING / running:任务进行中,建议5-10秒后再次查询
succeeded:任务成功,视频URL在 output_urls 中
failed:任务失败,错误原因在 error 中
轮询建议:
视频生成通常需要 30秒 ~ 5分钟
建议轮询间隔:5-10秒
建议设置最大轮询次数:60次(约5-10分钟)

参数说明#

基础参数#

参数类型必填说明
modelstring是模型名称:happyhorse-1.0-t2v/happyhorse-1.0-i2v/happyhorse-1.0-r2v
promptstring是视频描述文本
imagestringI2V必填单张图片URL(用于图生视频)
imagesarrayR2V必填多张图片URL数组,2-5张(用于多图生视频)

视频生成参数(parameters)#

参数类型必填默认值说明
resolutionstring否1080P视频分辨率。可选值:1080P、720P
ratiostring否16:9视频宽高比。可选值:16:9、9:16、3:4、4:3、4:5、5:4、1:1、9:21、21:9
durationinteger否5视频时长(秒)。取值范围:3~15 之间的整数
watermarkboolean否true是否添加水印。true:在视频右下角添加"Happy Horse"水印;false:不添加水印
seedinteger否自动生成随机数种子,取值范围:[0, 2147483647]。若需提升生成结果的可复现性,建议固定 seed 值。请注意,即使使用相同 seed,由于模型生成具有概率性,也不能保证每次结果完全一致
参数使用示例:
{
    "model": "happyhorse-1.0-t2v",
    "prompt": "一只可爱的柯基犬在草地上奔跑",
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false,
    "seed": 12345
}

错误码说明#

错误类型状态码说明
invalid_request400请求参数错误
no_channel503模型未配置有效渠道
no_channel_key503渠道API Key无效
upstream_error502/503上游服务错误
修改于 2026-05-25 17:49:25
上一页
06-联系我们
下一页
CC-Switch接入指南
Built with