在 Agent 工具中呼叫 Token Plan 圖像生成模型，根據文字描述產生圖片並下載到本機。
支援的模型
| 模型 | 說明 |
|---|---|
qwen-image-3.0-pro | 千問圖像生成與編輯 3.0 Pro，支援文生圖和圖生圖 |
qwen-image-2.0-pro | 千問圖像生成 2.0 Pro（團隊版專屬） |
qwen-image-2.0 | 千問圖像生成 2.0（團隊版專屬） |
wan2.7-image | 萬相圖像生成 |
wan2.7-image-pro | 萬相圖像生成 Pro |
更多模型以 Token Plan 個人版支援的模型 和 團隊版支援的模型 為準。
先決條件
端點
POST https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
請求標頭使用 Authorization: Bearer $ANTHROPIC_AUTH_TOKEN。請求主體與回應欄位請參見下文。
步驟一：建立 Slash Command
將套餐 API Key 設定為環境變數 $ANTHROPIC_AUTH_TOKEN。
在專案根目錄建立 .claude/commands/text-to-image.md，並寫入以下內容：
呼叫 Token Plan 圖像產生 API，根據描述產生圖片並下載到本機。
圖片描述：$ARGUMENTS
## 步驟
1. 從描述中提取 prompt（圖片描述）、model（預設 qwen-image-3.0-pro）、size（預設 1024*1024）。如果描述中明確指定了模型，使用指定的模型名稱。
2. 使用 Bash 工具執行以下命令產生圖片：
```bash
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[0].message.content[0].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 画一只猫。
請求參數
| 參數 | 必選 | 說明 |
|---|---|---|
model | 是 | 圖像生成模型 ID。 |
input.messages[0].content[0].text | 是 | 圖片描述。 |
parameters.size | 否 | 圖片尺寸，例如 1024*1024。不指定時由模型自動選擇。 |
更多參數請參見千問圖像生成與編輯 API。
傳回結果
- 圖片 URL：
output.choices[0].message.content[0].image。 - 用量：
usage.image_count、usage.width、usage.height。 - 圖片 URL 具有時效，生成後請及時下載。
限制
- 圖片尺寸與模型支援範圍以各模型文件為準。
- 計費以實際輸出圖片數量計算，詳情請參閱控制台用量統計。
其他工具
其他工具的擴充機制與設定路徑請參閱整合概覽。將上方的 Slash Command 內容儲存至對應路徑即可。