Alibaba Cloud Model Studio：通義千問-影像編輯API參考

通過公網URL傳入圖片

import json
import os
import dashscope
from dashscope import MultiModalConversation

# 以下為新加坡地區url，若使用北京地區的模型，需將url替換為：https://dashscope.aliyuncs.com/api/v1
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# 模型支援輸入1-3張圖片
messages = [
    {
        "role": "user",
        "content": [
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/thtclx/input1.png"},
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/iclsnx/input2.png"},
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/gborgw/input3.png"},
            {"text": "圖1中的女生穿著圖2中的黑色裙子按圖3的姿勢坐下"}
        ]
    }
]

# 新加坡和北京地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/zh/model-studio/get-api-key
# 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

# qwen-image-edit-plus支援輸出1-6張圖片，此處以2張為例
response = MultiModalConversation.call(
    api_key=api_key,
    model="qwen-image-edit-plus",
    messages=messages,
    stream=False,
    n=2,
    watermark=False,
    negative_prompt=" ",
    prompt_extend=True,
    # 僅當輸出映像數量n=1時支援設定size參數，否則會報錯
    # size="1024*2048",
)

if response.status_code == 200:
    # 如需查看完整響應，請取消下行注釋
    # print(json.dumps(response, ensure_ascii=False))
    for i, content in enumerate(response.output.choices[0].message.content):
        print(f"輸出映像{i+1}的URL:{content['image']}")
else:
    print(f"HTTP返回碼：{response.status_code}")
    print(f"錯誤碼：{response.code}")
    print(f"錯誤資訊：{response.message}")
    print("請參考文檔：https://www.alibabacloud.com/help/zh/model-studio/error-code")

通過Base64編碼傳入圖片

import json
import os
import dashscope
from dashscope import MultiModalConversation
import base64
import mimetypes

# 以下為新加坡地區url，若使用北京地區的模型，需將url替換為：https://dashscope.aliyuncs.com/api/v1
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'


# ---用於 Base 64 編碼 ---
# 格式為 data:{mime_type};base64,{base64_data}
def encode_file(file_path):
    mime_type, _ = mimetypes.guess_type(file_path)
    if not mime_type or not mime_type.startswith("image/"):
        raise ValueError("不支援或無法識別的映像格式")

    try:
        with open(file_path, "rb") as image_file:
            encoded_string = base64.b64encode(
                image_file.read()).decode('utf-8')
        return f"data:{mime_type};base64,{encoded_string}"
    except IOError as e:
        raise IOError(f"讀取檔案時出錯: {file_path}, 錯誤: {str(e)}")


# 擷取映像的 Base 64 編碼
# 調用編碼函數，請將 "/path/to/your/image.png" 替換為您的本地圖片檔案路徑，否則無法運行
image = encode_file("/path/to/your/image.png")

messages = [
    {
        "role": "user",
        "content": [
            {"image": image},
            {"text": "產生一張符合深度圖的映像，遵循以下描述：一輛紅色的破舊的單車停在一條泥濘的小路上，背景是茂密的原始森林"}
        ]
    }
]

# 新加坡和北京地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/zh/model-studio/get-api-key
# 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

# qwen-image-edit-plus支援輸出1-6張圖片，此處以2張為例
response = MultiModalConversation.call(
    api_key=api_key,
    model="qwen-image-edit-plus",
    messages=messages,
    stream=False,
    n=2,
    watermark=False,
    negative_prompt=" ",
    prompt_extend=True,
    # 僅當輸出映像數量n=1時支援設定size參數，否則會報錯
    # size="2048*1024",
)

if response.status_code == 200:
    # 如需查看完整響應，請取消下行注釋
    # print(json.dumps(response, ensure_ascii=False))
    for i, content in enumerate(response.output.choices[0].message.content):
        print(f"輸出映像{i+1}的URL:{content['image']}")
else:
    print(f"HTTP返回碼：{response.status_code}")
    print(f"錯誤碼：{response.code}")
    print(f"錯誤資訊：{response.message}")
    print("請參考文檔：https://www.alibabacloud.com/help/zh/model-studio/error-code")

通過URL下載映像

# 需要安裝requests以下載映像: pip install requests
import requests


def download_image(image_url, save_path='output.png'):
    try:
        response = requests.get(image_url, stream=True, timeout=300)  # 設定逾時
        response.raise_for_status()  # 如果HTTP狀態代碼不是200，則引發異常
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"映像已成功下載到: {save_path}")

    except requests.exceptions.RequestException as e:
        print(f"映像下載失敗: {e}")


image_url = "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
download_image(image_url, save_path='output.png')

新加坡地區

北京地區