{
  "schemaVersion": "1.0",
  "item": {
    "slug": "aliyun-image",
    "name": "aliyun-image",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/StanleyChanH/aliyun-image",
    "canonicalUrl": "https://clawhub.ai/StanleyChanH/aliyun-image",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/aliyun-image",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aliyun-image",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "metadata.json",
      "references/image-edit.md",
      "references/image-translate.md",
      "references/text-to-image.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/aliyun-image"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/aliyun-image",
    "agentPageUrl": "https://openagent3.xyz/skills/aliyun-image/agent",
    "manifestUrl": "https://openagent3.xyz/skills/aliyun-image/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/aliyun-image/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "阿里云百炼图像生成与编辑",
        "body": "🔄 同步更新：本项目在 GitHub 和 ClawHub 同步发布。"
      },
      {
        "title": "前提条件",
        "body": "# 配置 API Key\nexport DASHSCOPE_API_KEY=\"sk-xxxx\""
      },
      {
        "title": "文生图",
        "body": "import os, requests\n\nresp = requests.post(\n    \"https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation\",\n    headers={\"Authorization\": f\"Bearer {os.getenv('DASHSCOPE_API_KEY')}\"},\n    json={\n        \"model\": \"qwen-image-plus\",\n        \"input\": {\"messages\": [{\"role\": \"user\", \"content\": [{\"text\": \"一只橘猫在阳光下打盹\"}]}]},\n        \"parameters\": {\"prompt_extend\": True, \"watermark\": False}\n    }\n)\nprint(resp.json()[\"output\"][\"choices\"][0][\"message\"][\"content\"][0][\"image\"])"
      },
      {
        "title": "图像编辑",
        "body": "resp = requests.post(\n    \"https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation\",\n    headers={\"Authorization\": f\"Bearer {os.getenv('DASHSCOPE_API_KEY')}\"},\n    json={\n        \"model\": \"qwen-image-edit-plus\",\n        \"input\": {\"messages\": [{\"role\": \"user\", \"content\": [\n            {\"image\": \"https://example.com/photo.jpg\"},\n            {\"text\": \"把背景换成星空\"}\n        ]}]},\n        \"parameters\": {\"prompt_extend\": True, \"watermark\": False}\n    }\n)\nprint(resp.json()[\"output\"][\"choices\"][0][\"message\"][\"content\"][0][\"image\"])"
      },
      {
        "title": "图像翻译",
        "body": "import os, requests, time\n\n# 1. 创建翻译任务\nresp = requests.post(\n    \"https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis\",\n    headers={\n        \"Authorization\": f\"Bearer {os.getenv('DASHSCOPE_API_KEY')}\",\n        \"X-DashScope-Async\": \"enable\"\n    },\n    json={\n        \"model\": \"qwen-mt-image\",\n        \"input\": {\n            \"image_url\": \"https://example.com/english-poster.jpg\",\n            \"source_lang\": \"en\",\n            \"target_lang\": \"zh\"\n        }\n    }\n)\ntask_id = resp.json()[\"output\"][\"task_id\"]\n\n# 2. 轮询获取结果\nwhile True:\n    time.sleep(3)\n    result = requests.get(\n        f\"https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}\",\n        headers={\"Authorization\": f\"Bearer {os.getenv('DASHSCOPE_API_KEY')}\"}\n    ).json()\n    if result[\"output\"][\"task_status\"] == \"SUCCEEDED\":\n        print(result[\"output\"][\"image_url\"])\n        break"
      },
      {
        "title": "默认配置",
        "body": "场景默认模型高质量模型文生图qwen-image-plusqwen-image-max图像编辑qwen-image-edit-plusqwen-image-edit-max图像翻译qwen-mt-image-\n\n规则：默认使用 Plus 系列，仅当用户明确要求\"最好的\"、\"最高质量\"时使用 Max 系列。"
      },
      {
        "title": "默认参数",
        "body": "{\n  \"negative_prompt\": \"低分辨率，低画质，肢体畸形，手指畸形，画面过饱和，蜡像感\",\n  \"prompt_extend\": true,\n  \"watermark\": false\n}"
      },
      {
        "title": "详细参考",
        "body": "按需加载以下文档：\n\n文档用途references/text-to-image.md文生图完整API参考：模型列表、分辨率、所有参数references/image-edit.md图像编辑完整API参考：单图编辑、多图融合、输入要求references/image-translate.md图像翻译完整API参考：支持语言、异步调用、术语定义"
      },
      {
        "title": "工具脚本",
        "body": "脚本用途scripts/client.py封装好的API客户端，支持文生图、图像编辑和图像翻译\n\n使用脚本：\n\n# 文生图\npython scripts/client.py generate \"一只橘猫在阳光下打盹\" --size 1920*1080\n\n# 图像编辑\npython scripts/client.py edit \"https://example.com/photo.jpg\" \"把背景换成星空\" -n 2\n\n# 图像翻译\npython scripts/client.py translate \"https://example.com/english.jpg\" --source en --target zh"
      },
      {
        "title": "关键注意事项",
        "body": "图像URL有效期：生成的图像URL仅保留 24小时，请及时下载\n地域：API Key 和请求地址必须属于同一地域（北京/新加坡）\n费用：按成功生成的图像张数计费"
      },
      {
        "title": "常见错误",
        "body": "错误码原因解决方案InvalidApiKeyAPI Key无效检查环境变量配置InvalidParameter参数错误检查请求格式DataInspectionFailed内容审核失败修改输入内容"
      }
    ],
    "body": "阿里云百炼图像生成与编辑\n\n🔄 同步更新：本项目在 GitHub 和 ClawHub 同步发布。\n\n快速开始\n前提条件\n# 配置 API Key\nexport DASHSCOPE_API_KEY=\"sk-xxxx\"\n\n文生图\nimport os, requests\n\nresp = requests.post(\n    \"https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation\",\n    headers={\"Authorization\": f\"Bearer {os.getenv('DASHSCOPE_API_KEY')}\"},\n    json={\n        \"model\": \"qwen-image-plus\",\n        \"input\": {\"messages\": [{\"role\": \"user\", \"content\": [{\"text\": \"一只橘猫在阳光下打盹\"}]}]},\n        \"parameters\": {\"prompt_extend\": True, \"watermark\": False}\n    }\n)\nprint(resp.json()[\"output\"][\"choices\"][0][\"message\"][\"content\"][0][\"image\"])\n\n图像编辑\nresp = requests.post(\n    \"https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation\",\n    headers={\"Authorization\": f\"Bearer {os.getenv('DASHSCOPE_API_KEY')}\"},\n    json={\n        \"model\": \"qwen-image-edit-plus\",\n        \"input\": {\"messages\": [{\"role\": \"user\", \"content\": [\n            {\"image\": \"https://example.com/photo.jpg\"},\n            {\"text\": \"把背景换成星空\"}\n        ]}]},\n        \"parameters\": {\"prompt_extend\": True, \"watermark\": False}\n    }\n)\nprint(resp.json()[\"output\"][\"choices\"][0][\"message\"][\"content\"][0][\"image\"])\n\n图像翻译\nimport os, requests, time\n\n# 1. 创建翻译任务\nresp = requests.post(\n    \"https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis\",\n    headers={\n        \"Authorization\": f\"Bearer {os.getenv('DASHSCOPE_API_KEY')}\",\n        \"X-DashScope-Async\": \"enable\"\n    },\n    json={\n        \"model\": \"qwen-mt-image\",\n        \"input\": {\n            \"image_url\": \"https://example.com/english-poster.jpg\",\n            \"source_lang\": \"en\",\n            \"target_lang\": \"zh\"\n        }\n    }\n)\ntask_id = resp.json()[\"output\"][\"task_id\"]\n\n# 2. 轮询获取结果\nwhile True:\n    time.sleep(3)\n    result = requests.get(\n        f\"https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}\",\n        headers={\"Authorization\": f\"Bearer {os.getenv('DASHSCOPE_API_KEY')}\"}\n    ).json()\n    if result[\"output\"][\"task_status\"] == \"SUCCEEDED\":\n        print(result[\"output\"][\"image_url\"])\n        break\n\n默认配置\n场景\t默认模型\t高质量模型\n文生图\tqwen-image-plus\tqwen-image-max\n图像编辑\tqwen-image-edit-plus\tqwen-image-edit-max\n图像翻译\tqwen-mt-image\t-\n\n规则：默认使用 Plus 系列，仅当用户明确要求\"最好的\"、\"最高质量\"时使用 Max 系列。\n\n默认参数\n{\n  \"negative_prompt\": \"低分辨率，低画质，肢体畸形，手指畸形，画面过饱和，蜡像感\",\n  \"prompt_extend\": true,\n  \"watermark\": false\n}\n\n详细参考\n\n按需加载以下文档：\n\n文档\t用途\nreferences/text-to-image.md\t文生图完整API参考：模型列表、分辨率、所有参数\nreferences/image-edit.md\t图像编辑完整API参考：单图编辑、多图融合、输入要求\nreferences/image-translate.md\t图像翻译完整API参考：支持语言、异步调用、术语定义\n工具脚本\n脚本\t用途\nscripts/client.py\t封装好的API客户端，支持文生图、图像编辑和图像翻译\n\n使用脚本：\n\n# 文生图\npython scripts/client.py generate \"一只橘猫在阳光下打盹\" --size 1920*1080\n\n# 图像编辑\npython scripts/client.py edit \"https://example.com/photo.jpg\" \"把背景换成星空\" -n 2\n\n# 图像翻译\npython scripts/client.py translate \"https://example.com/english.jpg\" --source en --target zh\n\n关键注意事项\n图像URL有效期：生成的图像URL仅保留 24小时，请及时下载\n地域：API Key 和请求地址必须属于同一地域（北京/新加坡）\n费用：按成功生成的图像张数计费\n常见错误\n错误码\t原因\t解决方案\nInvalidApiKey\tAPI Key无效\t检查环境变量配置\nInvalidParameter\t参数错误\t检查请求格式\nDataInspectionFailed\t内容审核失败\t修改输入内容"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/StanleyChanH/aliyun-image",
    "publisherUrl": "https://clawhub.ai/StanleyChanH/aliyun-image",
    "owner": "StanleyChanH",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/aliyun-image",
    "downloadUrl": "https://openagent3.xyz/downloads/aliyun-image",
    "agentUrl": "https://openagent3.xyz/skills/aliyun-image/agent",
    "manifestUrl": "https://openagent3.xyz/skills/aliyun-image/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/aliyun-image/agent.md"
  }
}