Skip to main content

画像生成モデルの統合

Agent ツールから Token Plan 画像生成モデルを呼び出し、テキストの説明から画像を生成してローカルにダウンロードします。

サポートされているモデル

モデル説明
qwen-image-3.0-proQwen 画像生成・編集 3.0 Pro、text-to-image と image-to-image をサポート
qwen-image-2.0-proQwen 画像生成 2.0 Pro（Team Edition のみ）
qwen-image-2.0Qwen 画像生成 2.0（Team Edition のみ）
wan2.7-imageWan 画像生成
wan2.7-image-proWan 画像生成 Pro
その他のモデルについては、Token Plan 個人版でサポートされているモデル と Team Edition でサポートされているモデル をご参照ください。

前提条件

  • Token Planのサブスクリプション、および sk-sp- で始まるAPIキー。詳細については、統合概要をご覧ください。
  • AIコーディングツールがSlash Commandsをサポートしていること。その他のツールの設定パスについては、その他のツールをご覧ください。

インターフェース

POST https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation リクエストヘッダーで Authorization: Bearer $ANTHROPIC_AUTH_TOKEN を使用します。リクエストボディとレスポンスフィールドについては、以下のセクションを参照してください。

ステップ1: スラッシュコマンドの作成

Token Plan APIキーを環境変数 $ANTHROPIC_AUTH_TOKEN として設定します。 プロジェクトルートに .claude/commands/text-to-image.md を作成し、次の内容を追加します。 
Token Plan画像生成APIを呼び出して、説明から画像を生成し、ローカルにダウンロードします。

画像の説明: $ARGUMENTS

## 手順

1. 説明からプロンプト（画像の説明）、モデル（デフォルト: qwen-image-3.0-pro）、サイズ（デフォルト: 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. 生成された画像ファイルのパスを出力します。

ステップ2：画像を生成する

Claude Codeで、/text-to-image draw a catと入力します。別のモデルを使用するには、コマンドでモデルを指定します。例：/text-to-image use wan2.7-image to draw a cat。

リクエストパラメータ

パラメータ必須説明
modelはい画像生成モデルの ID。
input.messages[0].content[0].textはい画像の説明。
parameters.sizeいいえ画像サイズ。例: 1024*1024。省略した場合、モデルがサイズを自動的に選択します。
その他のパラメータについては、Qwen 画像生成・編集 API をご参照ください。

レスポンス

  • 画像 URL: output.choices[0].message.content[0].image。
  • 使用量: usage.image_count、usage.width、usage.height。
  • 画像 URL には有効期限があります。速やかに画像をダウンロードしてください。

制限事項

  • 画像サイズおよびサポートされるモデルは、各モデルのドキュメントによって異なります。
  • 課金は出力画像の数に基づきます。実際の Credits の消費量は、コンソールの Usage に表示されます。

その他のツール

その他のツールの拡張メカニズムおよび設定パスについては、連携概要を参照してください。上記の Slash Command を対応するパスに保存してください。