CommunityImagegithub.com

token-plan-image-gen

Token Plan通义万相图生API:正确格式、常见错误、Blender管线集成。

Qu'est-ce que token-plan-image-gen ?

token-plan-image-gen is a Codex agent skill that token Plan通义万相图生API:正确格式、常见错误、Blender管线集成。.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/dsffs488/dsh-agent-skills/tree/HEAD/skills/media-ops/references/token-plan-image-gen

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 按量 keyexport DASHSCOPE_API_KEY 为 Token Plan key
DeepSeek 看不了图vision_analyze 不走通义用 PotPlayer 等本地查看器

响应解析

响应中图片 URL 路径:output.choices[0].message.content[0].image

Blender 管线集成

生成的图可以:

  1. 贴到 Blender plane 做天空/背景板
  2. 做角色建模参考图
  3. 直接作为静态镜头(如果场景不需要 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")

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills associés