aliyun-image

# 阿里云百炼图像生成与编辑 > 🔄 **同步更新**：本项目在 [GitHub](https://github.com/StanleyChanH/aliyun-image-skill) 和 [ClawHub](https://clawhub.com/skill/aliyun-image) 同步发布。 ## 快速开始 ### 前提条件 ```bash # 配置 API Key export DASHSCOPE_API_KEY="sk-xxxx" ``` ### 文生图 ```python import os, requests resp = requests.post( "https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation", headers={"Authorization": f"Bearer {os.getenv('DASHSCOPE_API_KEY')}"}, 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": f"Bearer {os.getenv('DASHSCOPE_API_KEY')}"}, 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": f"Bearer {os.getenv('DASHSCOPE_API_KEY')}", "X-DashScope-Async": "enable" }, json={ "model": "qwen-mt-image", "input": { "image_url": "https://example.com/english-poster.jpg", "source_lang": "en", "target_lang": "zh" } } ) task_id = resp.json()["output"]["task_id"] # 2. 轮询获取结果 while True: time.sleep(3) result = requests.get( f"https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}", headers={"Authorization": f"Bearer {os.getenv('DASHSCOPE_API_KEY')}"} ).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](references/text-to-image.md) | 文生图完整API参考：模型列表、分辨率、所有参数 | | [references/image-edit.md](references/image-edit.md) | 图像编辑完整API参考：单图编辑、多图融合、输入要求 | | [references/image-translate.md](references/image-translate.md) | 图像翻译完整API参考：支持语言、异步调用、术语定义 | --- ## 工具脚本 | 脚本 | 用途 | |------|------| | [scripts/client.py](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. **图像URL有效期**：生成的图像URL仅保留 **24小时**，请及时下载 2. **地域**：API Key 和请求地址必须属于同一地域（北京/新加坡） 3. **费用**：按成功生成的图像张数计费 --- ## 常见错误 | 错误码 | 原因 | 解决方案 | |--------|------|----------| | `InvalidApiKey` | API Key无效 | 检查环境变量配置 | | `InvalidParameter` | 参数错误 | 检查请求格式 | | `DataInspectionFailed` | 内容审核失败 | 修改输入内容 |