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

活动概述

活动名称：阿里云百炼模型免费体验周

活动时间：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-20	LLM	ali_bailian
qwen3.7-max	LLM	ali_bailian
qwen-max	LLM	ali_bailian
qwen3.6-flash-2026-04-16	LLM	ali_bailian
qwen3.6-flash	LLM	ali_bailian
qwen3.6-max-preview	LLM	ali_bailian
qwen3.6-plus-2026-04-02	LLM	ali_bailian
qwen3.6-plus	LLM	ali_bailian

DeepSeek模型（2款）

模型名称	类型	渠道代码
deepseek-v4-pro	LLM	ali_bailian
deepseek-v4-flash	LLM	ali_bailian

Kimi模型（1款）

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

GLM模型（2款）

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

渠道配置说明

当前支持的渠道代码

渠道代码	渠道名称	渠道ID	说明
ali_bailian	阿里云百炼平台	-	阿里云百炼大模型服务
deepseek	DeepSeek官方	-	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
}

注意事项

Token有效期：领取后7天内有效，过期无法使用

模型限制：只能调用上述20款模型，其他模型会返回403错误

额度限制：虽然显示无限额度，但仍受阿里云上游限制

渠道选择：

优先使用 ali_bailian/ 前缀，确保走阿里云渠道

不带前缀时系统会自动选择，但可能不是最优渠道

错误处理：

401：Token无效或已过期

403：模型不在活动列表中

404：渠道配置错误

400 Arrearage：阿里云账户欠费（需联系管理员）

获取活动Token

访问活动页面：https://numspirit.com/promo/aliyun-free-week/

登录账户（确保余额≥9.9元）

点击"立即免费领取"

在个人中心查看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分钟）

参数说明

基础参数

参数	类型	必填	说明
model	string	是	模型名称：`happyhorse-1.0-t2v`/`happyhorse-1.0-i2v`/`happyhorse-1.0-r2v`
prompt	string	是	视频描述文本
image	string	I2V必填	单张图片URL（用于图生视频）
images	array	R2V必填	多张图片URL数组，2-5张（用于多图生视频）

视频生成参数（parameters）

参数	类型	必填	默认值	说明
resolution	string	否	`1080P`	视频分辨率。可选值：`1080P`、`720P`
ratio	string	否	`16:9`	视频宽高比。可选值：`16:9`、`9:16`、`3:4`、`4:3`、`4:5`、`5:4`、`1:1`、`9:21`、`21:9`
duration	integer	否	`5`	视频时长（秒）。取值范围：3~15 之间的整数
watermark	boolean	否	`true`	是否添加水印。`true`：在视频右下角添加"Happy Horse"水印；`false`：不添加水印
seed	integer	否	自动生成	随机数种子，取值范围：[0, 2147483647]。若需提升生成结果的可复现性，建议固定 seed 值。请注意，即使使用相同 seed，由于模型生成具有概率性，也不能保证每次结果完全一致

参数使用示例：

{
    "model": "happyhorse-1.0-t2v",
    "prompt": "一只可爱的柯基犬在草地上奔跑",
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false,
    "seed": 12345
}

错误码说明

错误类型	状态码	说明
`invalid_request`	400	请求参数错误
`no_channel`	503	模型未配置有效渠道
`no_channel_key`	503	渠道API Key无效
`upstream_error`	502/503	上游服务错误

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

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

活动概述#

可用模型列表（共20款）#

图像生成模型（4款）#

视频生成模型（3款）#

阿里云百炼LLM（8款）#

DeepSeek模型（2款）#

Kimi模型（1款）#

GLM模型（2款）#

渠道配置说明#

当前支持的渠道代码#

渠道代码使用方式#

API接入示例#

基础信息#

示例1：DeepSeek-V4-Pro（带思考模式）#

示例2：DeepSeek-V4-Flash#

示例3：Qwen3.7-Max（不带渠道前缀）#

示例4：Kimi-K2.6#

示例5：GLM-5.1#

示例6：GLM-5#

示例7：Qwen-Max#

流式输出示例#

注意事项#

获取活动Token#

技术支持#

视频生成接入指南#

前置步骤：上传图片#

示例1：文生视频（Text-to-Video）#

示例2：图生视频（Image-to-Video）#

示例3：多图参考生视频（Reference-to-Video）#

查询任务状态#

参数说明#

基础参数#

视频生成参数（parameters）#

错误码说明#

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

活动概述

可用模型列表（共20款）

图像生成模型（4款）

视频生成模型（3款）

阿里云百炼LLM（8款）

DeepSeek模型（2款）

Kimi模型（1款）

GLM模型（2款）

渠道配置说明

当前支持的渠道代码

渠道代码使用方式

API接入示例

基础信息

示例1：DeepSeek-V4-Pro（带思考模式）

示例2：DeepSeek-V4-Flash

示例3：Qwen3.7-Max（不带渠道前缀）

示例4：Kimi-K2.6

示例5：GLM-5.1

示例6：GLM-5

示例7：Qwen-Max

流式输出示例

注意事项

获取活动Token

技术支持

视频生成接入指南

前置步骤：上传图片

示例1：文生视频（Text-to-Video）

示例2：图生视频（Image-to-Video）

示例3：多图参考生视频（Reference-to-Video）

查询任务状态

参数说明

基础参数

视频生成参数（parameters）

错误码说明