Token Plan 通义万相 图片生成
选型/计价以
model-package技能为准(含批处理与免费额度口径),本技能只写 Token Plan 专属端点与鉴权流程。
环境
- 端点:
https://token-plan.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation - 模型:
wan2.7-image - Key:Token Plan key(sk-sp-...格式),通常在 plan-agent 的
.env中 - 额度消耗:单张约 1-2 token
实用脚本(推荐直接用,别手写 curl)
D:\Hermes\plugins\scripts\dashscope_gen.py 封装了图生/视频/图生视频全套,自动处理异步轮询和下载:
python "D:/Hermes/plugins/scripts/dashscope_gen.py" image "提示词" --model wan2.7-image-pro --size 1024*1280
python "D:/Hermes/plugins/scripts/dashscope_gen.py" video "提示词" --duration 5
--model值是wan2.7-image/wan2.7-image-pro(不是pro)- 竖屏概念图用
--size 1024*1280(3:4),横屏用1280*720 - 输出默认
<DOWNLOAD_DIR>,用环境变量DASHSCOPE_OUTPUT改目录 - key 读取:优先
HERMES_CUSTOM_TOKEN_PLAN...环境变量,fallback.env的DASHSCOPE_API_KEY。后台 Python 进程读不到 bash export 的变量时,用export DASHSCOPE_OUTPUT=... && python ...在 terminal 里跑(terminal 的 bash 有变量) - 出图质量好(wan2.7-image-pro),适合概念图/角色设定图/小红书场景图;额度按周窗口重置,耗尽报
1-week quota has been exhausted
正确请求格式(OpenAI 兼容)
KEY=$(grep HERMES_CUSTOM_TOKEN_PLAN ".env路径" | cut -d= -f2-)
curl -s -X POST "$ENDPOINT" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $KEY" \
-d '{
"model":"wan2.7-image",
"input":{
"messages":[{
"role":"user",
"content":[{"text":"图片描述"}]
}]
},
"parameters":{"size":"1280*720"}
}'
关键陷阱
| 错误 | 原因 | 修复 |
|---|---|---|
InvalidApiKey | 用了 DashScope 按量 key (sk-ws-...) | 必须用 Token Plan key (sk-sp-...) |
Field required: input.messages | 用了 input.prompt | 改用 input.messages (OpenAI格式) |
image_generate 工具 401 | 工具读的是 DASHSCOPE_API_KEY,但环境里设的是 DashScope 按量 key | export DASHSCOPE_API_KEY 为 Token Plan key |
| DeepSeek 看不了图 | vision_analyze 不走通义 | 用 PotPlayer 等本地查看器 |
响应解析
响应中图片 URL 路径:output.choices[0].message.content[0].image
Blender 管线集成
生成的图可以:
- 贴到 Blender plane 做天空/背景板
- 做角色建模参考图
- 直接作为静态镜头(如果场景不需要 3D 运动)
参考 skill:
blender-3d-pipeline(3D 场景构建和渲染)
LLM 文本生成(同一 Token Plan key,夜间 0.2 折)
Token Plan key 不止图生/视频,还能做 LLM 文本生成(compatible-mode,OpenAI 兼容)。批量小说润色、剧本生成、分集脚本等大文本工作用它,夜间最省。
- 端点:
https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions - 模型:
qwen3.8-max-preview(夜间 22:00-08:00 享 0.2 折,最省额度;实际路由到 qwen3.8-max,能力相同) - 关键参数:
"enable_thinking": false关闭推理思考——不传会返回大量reasoning_content(思考过程)白耗 token;传了直接返回content正文 - key 读取:环境变量
HERMES_CUSTOM_TOKEN_PLAN_CN_BEIJING_MAAS_ALIYUNCS_COM_API_KEY,实际在D:\Hermes\.env。⚠️execute_code的os.environ读不到它,脚本里要主动从.env文件解析(fallback os.environ) - 响应:
choices[0].message.content= 正文,reasoning_content= 思考过程(忽略)
body = {"model": "qwen3.8-max-preview", "messages": [...],
"max_tokens": 9000, "temperature": 0.85, "enable_thinking": False}
# 400 报错时去掉 enable_thinking 重试(个别长 prompt 会报 "url error")