Alibaba Cloud Model Studio:Text-to-image

Python

リクエスト例

import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# これはシンガポールリージョンのベース URL です。ベース URL はリージョン固有です。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 環境変数が設定されていない場合は、次の行をご利用の Model Studio API キーに置き換えてください: api_key="sk-xxx"
# API キーはリージョンによって異なります。API キーを取得するには、https://www.alibabacloud.com/help/model-studio/get-api-key をご参照ください
api_key = os.getenv("DASHSCOPE_API_KEY")


def main():
    message = Message(
        role="user",
        content=[
            {"text": "自然でカジュアルな自撮りスタイルの若い女性。超高解像度でリアルなライフスタイル写真。彼女は黄色の花柄の長袖トップスを着ており、長く少しウェーブのかかった髪が自然に垂れている。背景は屋外の自然な風景で、近くに緑の植物があり、遠くに水と山が見える。柔らかく自然な太陽光が彼女の顔と体に降り注ぎ、自然な光と影の効果を生み出している。カメラアングルは、彼女が持っているかのような自撮り視点からのミディアムショット。彼女は自然に立っており、リラックスして快適な状態を表現している。アングルは自然で、不意の一瞬を捉えたスナップショットのスタイル。"}
        ]
    )
    
    # 非同期タスクを送信します。
    print("非同期タスクを送信しています...")
    response = ImageGeneration.async_call(
        model="wan2.7-image-pro",
        api_key=api_key,
        messages=[message],
        enable_sequential=False,
        n=1,
        size="2K"
    )
    
    if response.status_code == 200:
        print(f"タスクは正常に送信されました。タスク ID: {response.output.task_id}")
        
        # タスクが完了するのを待ちます。
        status = ImageGeneration.wait(task=response, api_key=api_key)
        
        if status.output.task_status == "SUCCEEDED":
            print("タスクが完了しました！")
            print(f"結果:")
            print(status)
        else:
            print(f"タスクは失敗しました。ステータス: {status.output.task_status}")
    else:
        print(f"タスクの作成に失敗しました: {response.code} - {response.message}")


if __name__ == "__main__":
    try:
        main()
    except Exception as e:
        print(f"エラー: {e}")

レスポンス例

1. タスク作成のレスポンス

{
    "status_code": 200,
    "request_id": "4fb3050f-de57-4a24-84ff-e37ee5xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": null,
        "audio": null,
        "task_id": "77093787-a217-4c29-9cd4-ca7b5ac86xxx",
        "task_status": "PENDING"
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "characters": 0
    }
}

2. タスクステータスのクエリレスポンス

画像 URL の有効期間は 24 時間です。速やかに画像をダウンロードしてください。

{
    "status_code": 200,
    "request_id": "56e318fd-ed60-99e8-8ca1-cdef25ca4xxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "audio": null,
        "task_id": "77093787-a217-4c29-9cd4-ca7b5ac86xxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-03-31 23:04:46.166",
        "scheduled_time": "2026-03-31 23:04:46.208",
        "end_time": "2026-03-31 23:05:11.664",
        "finished": true
    },
    "usage": {
        "input_tokens": 720,
        "output_tokens": 11,
        "characters": 0,
        "size": "2048*2048",
        "total_tokens": 731,
        "image_count": 1
    }
}

Java

リクエスト例

import com.alibaba.dashscope.aigc.imagegeneration.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.Collections;

public class Main {

    static {
        // これはシンガポールリージョンのベース URL です。ベース URL はリージョン固有です。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // 環境変数が設定されていない場合は、次の行をご利用の Model Studio API キーに置き換えてください: apiKey="sk-xxx"
    // API キーはリージョンによって異なります。API キーを取得するには、https://www.alibabacloud.com/help/model-studio/get-api-key をご参照ください
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static ImageGenerationResult waitTask(String taskId)
            throws ApiException, NoApiKeyException {
        ImageGeneration imageGeneration = new ImageGeneration();
        return imageGeneration.wait(taskId, apiKey);
    }

    public static void asyncCall() throws ApiException, NoApiKeyException, UploadFileException {
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Collections.singletonList(
                        Collections.singletonMap("text", "自然でカジュアルな自撮りスタイルの若い女性。超高解像度でリアルなライフスタイル写真。彼女は黄色の花柄の長袖トップスを着ており、長く少しウェーブのかかった髪が自然に垂れている。背景は屋外の自然な風景で、近くに緑の植物があり、遠くに水と山が見える。柔らかく自然な太陽光が彼女の顔と体に降り注ぎ、自然な光と影の効果を生み出している。カメラアングルは、彼女が持っているかのような自撮り視点からのミディアムショット。彼女は自然に立っており、リラックスして快適な状態を表現している。アングルは自然で、不意の一瞬を捉えたスナップショットのスタイル。")
                )).build();

        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.7-image-pro")
                .messages(Collections.singletonList(message))
                .enableSequential(false)
                .n(1)
                .size("2K")
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        ImageGenerationResult taskResult = null;
        try {
            System.out.println("----非同期呼び出し、タスク作成中----");
            taskResult = imageGeneration.asyncCall(param);
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
        System.out.println("タスク作成完了: " + JsonUtils.toJson(taskResult));

        // タスクが完了するのを待ちます。
        String taskId = taskResult.getOutput().getTaskId();
        ImageGenerationResult result = waitTask(taskId);
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            asyncCall();
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            System.out.println(e.getMessage());
        }
    }
}

レスポンス例

1. タスク作成のレスポンス

{
    "requestId": "7d026dc1-e8c9-9caa-84ac-e82e2da97xxx",
    "output": {
        "task_id": "2de18c56-c151-4b80-8105-1d164733exxx",
        "task_status": "PENDING"
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

2. タスクステータスのクエリレスポンス

{
    "requestId": "daea7295-4ce0-928a-9a11-4d2bea058xxx",
    "usage": {
        "input_tokens": 720,
        "output_tokens": 11,
        "total_tokens": 731,
        "image_count": 1,
        "size": "2048*2048"
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "task_id": "2de18c56-c151-4b80-8105-1d164733exxx",
        "task_status": "SUCCEEDED",
        "finished": true,
        "submit_time": "2026-03-31 19:49:53.124",
        "scheduled_time": "2026-03-31 19:49:53.175",
        "end_time": "2026-03-31 19:50:53.160"
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

Curl

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
    --header 'Content-Type: application/json' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header "X-DashScope-Async: enable" \
    --data '{
        "model": "wan2.7-image-pro",
        "input": {
            "messages": [
                {
                    "role": "user",
                    "content": [
                        {"text": "精巧な窓、美しい木製のドア、そして花が飾られた花屋"}
                    ]
                }
            ]
        },
        "parameters": {
            "size": "2K",
            "n": 1,
            "watermark": false,
            "thinking_mode": true
        }
    }'
    

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Python

import json
import os
import dashscope
from dashscope import MultiModalConversation

# シンガポールリージョンにはこの URL を使用します。北京リージョンの場合は、https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1 に置き換えてください
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

messages = [
    {
        "role": "user",
        "content": [
            {"text": "癒し系の手描きポスター。緑豊かな芝生の上でボールで遊ぶ3匹の子犬が、鳥や星などの装飾要素で飾られている。メインタイトル「ボールで遊ぼう！」は、太字の青いカートゥーンフォントで上部に目立つように表示されている。その下には、サブタイトル「さあ、[腕前を披露して]！」が緑色のフォントで表示されている。吹き出しが「へへ、次は僕が友達を驚かせる番だ！」というテキストで遊び心を加えている。下部には、「また友達とボール遊びができるね！」という補足テキストがある。カラーパレットは、新鮮な緑と青を中心に、明るいピンクと黄色のトーンでアクセントをつけ、陽気で子供らしい雰囲気を強調している。"}
        ]
    }
]

# API キーは北京リージョンとシンガポールリージョンで異なります。API キーを取得してください: https://www.alibabacloud.com/help/model-studio/get-api-key
# 環境変数を設定していない場合は、下の行を次のように置き換えてください: api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

response = MultiModalConversation.call(
    api_key=api_key,
    model="qwen-image-2.0-pro",
    messages=messages,
    result_format='message',
    stream=False,
    watermark=False,
    prompt_extend=True,
    negative_prompt="低解像度、低品質、歪んだ手足、奇形の指、過飽和の色、蝋人形のような外観、顔のディテールの欠如、過度の滑らかさ、AIのようなアーティファクト、混沌とした構図、ぼやけたまたは歪んだテキスト。",
    size='2048*2048'
)

if response.status_code == 200:
    print(json.dumps(response, ensure_ascii=False))
else:
    print(f"HTTP ステータスコード: {response.status_code}")
    print(f"エラーコード: {response.code}")
    print(f"エラーメッセージ: {response.message}")
    print("ドキュメントを参照してください: https://www.alibabacloud.com/help/model-studio/error-code")

{
    "status_code": 200,
    "request_id": "d2d1a8c0-325f-9b9d-8b90-xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ]
    }
}

Java

import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversation;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationParam;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationResult;
import com.alibaba.dashscope.common.MultiModalMessage;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;

import java.io.IOException;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;

public class QwenImage {

    static {
        // シンガポールリージョンにはこの URL を使用します。北京リージョンの場合は、https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1 に置き換えてください
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // API キーは北京リージョンとシンガポールリージョンで異なります。API キーを取得してください: https://www.alibabacloud.com/help/model-studio/get-api-key
    // 環境変数を設定していない場合は、下の行を次のように置き換えてください: static String apiKey="sk-xxx"
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void call() throws ApiException, NoApiKeyException, UploadFileException, IOException {

        MultiModalConversation conv = new MultiModalConversation();

        MultiModalMessage userMessage = MultiModalMessage.builder().role(Role.USER.getValue())
                .content(Arrays.asList(
                        Collections.singletonMap("text", "癒し系の手描きポスター。緑豊かな芝生の上でボールで遊ぶ3匹の子犬が、鳥や星などの装飾要素で飾られている。メインタイトル「ボールで遊ぼう！」は、太字の青いカートゥーンフォントで上部に目立つように表示されている。その下には、サブタイトル「さあ、[腕前を披露して]！」が緑色のフォントで表示されている。吹き出しが「へへ、次は僕が友達を驚かせる番だ！」というテキストで遊び心を加えている。下部には、「また友達とボール遊びができるね！」という補足テキストがある。カラーパレットは、新鮮な緑と青を中心に、明るいピンクと黄色のトーンでアクセントをつけ、陽気で子供らしい雰囲気を強調している。")
                )).build();

        Map<String, Object> parameters = new HashMap<>();
        parameters.put("watermark", false);
        parameters.put("prompt_extend", true);
        parameters.put("negative_prompt", "低解像度、低品質、歪んだ手足、奇形の指、過飽和の色、蝋人形のような外観、顔のディテールの欠如、過度の滑らかさ、AIのようなアーティファクト、混沌とした構図、ぼやけたまたは歪んだテキスト。");
        parameters.put("size", "2048*2048");

        MultiModalConversationParam param = MultiModalConversationParam.builder()
                .apiKey(apiKey)
                .model("qwen-image-2.0-pro")
                .messages(Collections.singletonList(userMessage))
                .parameters(parameters)
                .build();

        MultiModalConversationResult result = conv.call(param);
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            call();
        } catch (ApiException | NoApiKeyException | UploadFileException | IOException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}

{
    "requestId": "5b6f2d04-b019-40db-a5cc-xxxxxx",
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ]
    }
}

Curl

リクエスト例

curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
    "model": "qwen-image-2.0-pro",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "text": "北京の冬の街並み。灰色の瓦屋根と朱色の外壁を持つ伝統的な中国の店が2軒隣り合って建っている。軒下には馬の切り絵をモチーフにした温かい光の提灯が吊るされ、曇り空の拡散光の下、湿った石畳に柔らかな光輪を投げかけている。左側は書道店。古びた藍色の看板には、大胆な行書体で「テキストレンダリング」と書かれている。店のガラスには縦書きの巻物が上から下に田英章の硬筆スタイルで「プロフェッショナルなスライド、バイリンガルポスター、高度なインフォグラフィック」と書かれ、「1k トークン」と読める朱印が押されている。店内には、壁に3つの縦書きの書道作品がかすかに見える。1つ目は「Alibaba」、2つ目は「Qwen」、3つ目は「画像生成」。白髪の老人がカメラに背を向けてその芸術を鑑賞している。右側は花屋で、看板には生花で「リアルな質感」と書かれている。店内には、多層の棚に赤いバラ、ピンクの牡丹、緑の植物が飾られている。ドアには円形で花柄のバッジに「2k 解像度」と書かれ、入り口のカラフルなネオンサインには「詳細な描写：人物、自然、建築」というテキストが表示されている。2つの店の間に、雪だるまが古風な黒板を持っており、チョークで「Qwen-Image-2.0 公式リリース」と書かれている。通りの左側には、若いカップルが寄り添っている。スリムな顔立ちの女性は、ベージュのカシミアコートとヌードトーンのシアータイツを着用し、「画像生成と編集を一つに」という白いテキストが印刷された透明なハート型の風船を持っている。風船の中には、ふわふわのカピバラのぬいぐるみが入っている。男性は、仕立ての良いダークグレーのウールコートの下に、明るい色のタートルネックセーターを着ている。通りの右側では、「より小さなモデル、より速いスピード」と背中に書かれた配達員がスピードを上げて通り過ぎていく。通り全体が、織り交ぜられた光と影を通して、ダイナミックな動きと静かな静けさを融合させている。"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "negative_prompt": "低解像度、低品質、歪んだ手足、奇形の指、過飽和の色、蝋人形のような外観、顔のディテールの欠如、過度の滑らかさ、AIのようなアーティファクト、混沌とした構図、ぼやけたまたは歪んだテキスト。",
        "prompt_extend": true,
        "watermark": false,
        "size": "2048*2048"
    }
}'

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
    "model": "qwen-image-2.0-pro",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            {
              "text": "癒し系の手描きポスター。緑豊かな芝生の上でボールで遊ぶ3匹の子犬が、鳥や星などの装飾要素で飾られている。メインタイトル「ボールで遊ぼう！」は、太字の青いカートゥーンフォントで上部に目立つように表示されている。その下には、サブタイトル「さあ、[腕前を披露して]！」が緑色のフォントで表示されている。吹き出しが「へへ、次は僕が友達を驚かせる番だ！」というテキストで遊び心を加えている。下部には、「また友達とボール遊びができるね！」という補足テキストがある。カラーパレットは、新鮮な緑と青を中心に、明るいピンクと黄色のトーンでアクセントをつけ、陽気で子供らしい雰囲気を強調している。"
            }
          ]
        }
      ]
    },
    "parameters": {
      "negative_prompt": "低解像度、低品質、歪んだ手足、奇形の指、過飽和の色、蝋人形のような外観、顔のディテールの欠如、過度の滑らかさ、AIのようなアーティファクト、混沌とした構図、ぼやけたまたは歪んだテキスト。",
      "prompt_extend": true,
      "watermark": false,
      "size": "2048*2048"
    }
}'

{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "content": [
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ],
                    "role": "assistant"
                }
            }
        ]
    },
    "usage": {
        "height": 2048,
        "image_count": 1,
        "width": 2048
    },
    "request_id": "d0250a3d-b07f-49e1-bdc8-6793f4929xxx"
}