aliyun-zimage-turbo

Category: provider

Model Studio Z-Image Turbo

DashScope マルチモーダル生成 API を使用して、Z-Image Turbo でテキストから画像を高速生成します。

重要なモデル名

次のモデル文字列のみを使用してください。

• z-image-turbo

前提条件

• 環境変数に DASHSCOPE_API_KEY を設定するか、~/.alibabacloud/credentials に dashscope_api_key を追加してください（環境変数が優先されます）。
• リージョンのエンドポイント（北京またはシンガポール）を選択してください。不明な場合は、最も適切と思われるリージョンを選ぶか、ユーザーに確認してください。

正規化されたインターフェース（image.generate）

リクエスト

• prompt（文字列、必須）
• size（文字列、任意）例：1024*1024
• seed（整数、任意）
• prompt_extend（ブール値、任意。デフォルトは false）
• base_url（文字列、任意）API エンドポイントを上書きします

レスポンス

• image_url（文字列）
• width（整数）
• height（整数）
• prompt（文字列）
• rewritten_prompt（文字列、任意）
• reasoning（文字列、任意）
• request_id（文字列）

クイックスタート（curl）

curl -sS 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -d '{
    "model": "z-image-turbo",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [{"text": "A calm lake at dawn, a lone angler casting a line, cinematic lighting"}]
        }
      ]
    },
    "parameters": {
      "size": "1024*1024",
      "prompt_extend": false
    }
  }'

ローカルヘルパースクリプト

python skills/ai/image/aliyun-zimage-turbo/scripts/generate_image.py \
  --request '{"prompt":"a fishing scene at dawn, cinematic, realistic","size":"1024*1024"}' \
  --output output/ai-image-zimage-turbo/images/fishing.png \
  --print-response

サイズに関する注意事項

• 総ピクセル数は 512*512 から 2048*2048 の範囲にする必要があります。
• 1024*1024、1280*720、1536*864 などの一般的なサイズを推奨します。

コストに関する注意事項

• prompt_extend=true は false よりも高い料金が請求されます。プロンプトを書き換える必要がある場合にのみ有効にしてください。

出力先

• デフォルトの出力先：output/ai-image-zimage-turbo/images/
• OUTPUT_DIR でベースディレクトリを上書きできます。

検証

mkdir -p output/aliyun-zimage-turbo
for f in skills/ai/image/aliyun-zimage-turbo/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-zimage-turbo/validate.txt

合格基準：コマンドが 0 で終了し、output/aliyun-zimage-turbo/validate.txt が生成されること。

出力とエビデンス

• 成果物、コマンド出力、API レスポンスの概要を output/aliyun-zimage-turbo/ に保存してください。
• 再現できるよう、主要なパラメーター（リージョン／リソース ID／期間）をエビデンスファイルに含めてください。

ワークフロー

1. ユーザーの意図、リージョン、識別子、操作が読み取り専用か変更を伴うかを確認します。
2. 接続と権限を確認するため、まず最小限の読み取り専用クエリを 1 つ実行します。
3. 対象の操作を、明示的なパラメーターと限定された範囲で実行します。
4. 結果を確認し、出力ファイルとエビデンスファイルを保存します。

参考資料

• リクエスト／レスポンスのスキーマとリージョン別エンドポイントについては、references/api_reference.md を参照してください。
• 公式ドキュメントについては、references/sources.md を参照してください。