映像產生模型需通過工具的擴充機制(Skill、Slash Command 或 Agent)接入。
前提:擷取套餐專屬憑證
在控制台「我的訂閱」開啟 Token Plan 套餐詳情頁,接入資訊卡片展示套餐專屬 API Key(以 sk-sp- 為首碼,掩碼顯示),支援產生、重設與複製 API Key。
套餐詳情頁「可使用模型」以文本、編程模型為主;映像產生模型不在該列表展示,需通過 multimodal-generation API 呼叫。
樣本:在 Claude Code 中接入映像產生模型
以 Claude Code 為例,通過 Slash Command 接入映像產生模型。其他工具的接入方式類似,區別在於擴充機制和設定檔路徑不同。
步驟一:建立 Slash Command
將套餐專屬 API Key(以 sk-sp- 為首碼)配置為環境變數 $ANTHROPIC_AUTH_TOKEN,供後續 curl 鑒權使用。
在專案根目錄建立 .claude/commands/text-to-image.md,寫入以下內容:
調用 Token Plan 文生圖 API,根據描述產生圖片。
使用者需求:$ARGUMENTS
## 步驟
1. 從使用者需求中提取 prompt(圖片描述)、model、size(預設 1024*1024)。若使用者明確指定了模型(如“模型=wan2.7-image”或“用 wan2.7-image 畫”),必須嚴格使用使用者指定的模型名,不要回退到預設模型;僅當使用者未指定模型時才使用預設 qwen-image-2.0。常用映像產生模型有 qwen-image-2.0、qwen-image-2.0-pro、wan2.7-image、wan2.7-image-pro、z-image-turbo 等,完整列表以百鍊模型列表為準。
2. 調用 API 產生圖片(使用 Bash 工具執行 curl):
```
curl -s -X POST "https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" \
-H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "<model>",
"input": {
"messages": [{"role":"user","content":[{"text":"<prompt>"}]}]
},
"parameters": {"size":"<size>"}
}'
```
3. 從返回 JSON 的 output.choices[*].message.content[*].image 中提取圖片 URL。
4. 用 curl -s -o "generated_$(date +%Y%m%d_%H%M%S).png" "<URL>" 下載到目前的目錄。
5. 向使用者展示產生的圖片檔案路徑。
步驟二:產生圖片
在 Claude Code 中輸入 /text-to-image 畫一隻貓。如需使用預設模型以外的映像產生模型,在指令中寫明模型名即可,例如 /text-to-image 用 wan2.7-image 畫一隻貓。
其他工具
控制台套餐詳情頁「快速接入 AI 編程工具」入口提供 Qwen Code、OpenClaw、Claude Code、OpenCode 等工具的接入文檔。不同工具的擴充機制和設定檔路徑如下表所示,該表為支援擴充機制的主流 AI 編程工具樣本。將上述 Claude Code 樣本中的配置內容儲存到對應路徑即可。
|
工具 |
擴充機制 |
設定檔路徑 |
|
Claude Code |
Slash Command |
|
|
Codex |
Skill |
|
|
Qwen Code |
Skill |
|
|
OpenCode |
Agent |
|
|
OpenClaw |
Skill |
|
|
Hermes Agent |
Skill |
|
|
Qoder |
Skill |
|
Skill 類工具(Codex、Qwen Code、OpenClaw、Hermes Agent、Qoder)需要在設定檔開頭添加 YAML front matter:
---
name: "token-plan-image"
description: "調用 Token Plan 文生圖模型,根據文字描述產生圖片。當使用者要求畫圖、產生圖片時啟用。"
---
(... 與上述 Claude Code 樣本相同的內容 ...)
OpenCode Agent 需要不同的 front matter 格式:
---
description: "調用 Token Plan 文生圖模型,根據文字描述產生圖片。"
mode: subagent
tools:
bash: true
write: false
edit: false
---
(... 與上述 Claude Code 樣本相同的內容 ...)