阿里云百炼图像生成与编辑

🔄 同步更新：本项目在 GitHub 和 ClawHub 同步发布。

快速开始

前提条件

bash

配置 API Key

export DASHSCOPEAPIKEY=sk-xxxx

文生图

python
import os, requests

resp = requests.post(
https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation,
headers={Authorization: fBearer {os.getenv(DASHSCOPEAPIKEY)}},
json={
model: qwen-image-plus,
input: {messages: [{role: user, content: [{text: 一只橘猫在阳光下打盹}]}]},
parameters: {prompt_extend: True, watermark: False}
}
)
print(resp.json()[output][choices][0][message][content][0][image])

图像编辑

python
resp = requests.post(
https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation,
headers={Authorization: fBearer {os.getenv(DASHSCOPEAPIKEY)}},
json={
model: qwen-image-edit-plus,
input: {messages: [{role: user, content: [
{image: https://example.com/photo.jpg},
{text: 把背景换成星空}
]}]},
parameters: {prompt_extend: True, watermark: False}
}
)
print(resp.json()[output][choices][0][message][content][0][image])

图像翻译

python
import os, requests, time

1. 创建翻译任务

resp = requests.post( https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis, headers={ Authorization: fBearer {os.getenv(DASHSCOPEAPIKEY)}, X-DashScope-Async: enable }, json={ model: qwen-mt-image, input: { image_url: https://example.com/english-poster.jpg, source_lang: en, target_lang: zh } } ) taskid = resp.json()[output][taskid]

2. 轮询获取结果

while True: time.sleep(3) result = requests.get( fhttps://dashscope.aliyuncs.com/api/v1/tasks/{task_id}, headers={Authorization: fBearer {os.getenv(DASHSCOPEAPIKEY)}} ).json() if result[output][task_status] == SUCCEEDED: print(result[output][image_url]) break

---

默认配置

场景	默认模型	高质量模型
文生图	qwen-image-plus	qwen-image-max
图像编辑

qwen-image-edit-plus | qwen-image-edit-max | | 图像翻译 | qwen-mt-image | - |

规则：默认使用 Plus 系列，仅当用户明确要求最好的、最高质量时使用 Max 系列。

默认参数

json
{
negative_prompt: 低分辨率，低画质，肢体畸形，手指畸形，画面过饱和，蜡像感,
prompt_extend: true,
watermark: false
}

---

详细参考

按需加载以下文档：

文档	用途
references/text-to-image.md	文生图完整API参考：模型列表、分辨率、所有参数
references/image-edit.md

图像编辑完整API参考：单图编辑、多图融合、输入要求 |
| references/image-translate.md | 图像翻译完整API参考：支持语言、异步调用、术语定义 |

---

工具脚本

脚本	用途
scripts/client.py	封装好的API客户端，支持文生图、图像编辑和图像翻译

使用脚本：

bash

文生图

python scripts/client.py generate 一只橘猫在阳光下打盹 --size 1920*1080

图像编辑

python scripts/client.py edit https://example.com/photo.jpg 把背景换成星空 -n 2

图像翻译

python scripts/client.py translate https://example.com/english.jpg --source en --target zh

---

关键注意事项

1. 1. 图像URL有效期：生成的图像URL仅保留 24小时，请及时下载
2. 地域：API Key 和请求地址必须属于同一地域（北京/新加坡）
3. 费用：按成功生成的图像张数计费

---

常见错误

错误码	原因	解决方案
InvalidApiKey	API Key无效	检查环境变量配置
InvalidParameter

参数错误 | 检查请求格式 | | DataInspectionFailed | 内容审核失败 | 修改输入内容 |