tongyi-image

Generates AI images via Alibaba DashScope APIs with async task polling and local download.

2.0k|274|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/openakita/openakita --skill tongyi-image
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tongyi-image
Source: https://github.com/openakita/openakita/tree/main/plugins/tongyi-image
Command: npx skills add https://github.com/openakita/openakita --skill tongyi-image

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, fastapi, pydantic.

What problem does it solve?

Creating production-ready images for posters, product listings, and creative concepts normally requires design tools or manual work across multiple AI services. This Skill turns text prompts or reference images into finished pictures through Alibaba Cloud DashScope, handling the async task lifecycle, polling, and local file download automatically.

Core Features & Use Cases

  • Seven generation modes: text-to-image, image editing, style repaint, background generation, outpainting, sketch-to-image, and e-commerce image suites, backed by Wanxiang and Qwen models.
  • Async task management: tasks are submitted to DashScope, polled until completion, and resulting images are auto-downloaded to local storage with asset IDs for downstream workflows.
  • Prompt optimization: an LLM-based optimizer expands short descriptions into professional prompts, with bilingual (Chinese/English) keyword libraries for style, lighting, and composition.
  • Use Case: An e-commerce seller uploads a product photo and generates a full suite of hero images, white-background shots, lifestyle scenes, and promo banners in one batch.

Quick Start

Ask the assistant to generate an image with a prompt like "a girl playing guqin in a bamboo forest, ink wash style" using the tongyi_image_create tool after configuring your DashScope API key in Settings.

Frequently Asked Questions about tongyi-image

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an image with DashScope from a text prompt?

Call the tongyi_image_create tool with a prompt, model (default wan27-pro), and size such as 1024*1024. The tool submits an async DashScope task, polls until completion, and returns image URLs, local paths, and asset IDs.

What image generation modes does Tongyi Image support?

It supports seven modes: text-to-image, image editing, style repaint, background generation, outpainting, sketch-to-image, and e-commerce suites. Each mode maps to specific DashScope models like wan2.7-image-pro or wanx-background-generation.

Do I need an API key to use DashScope image generation?

Yes, a DashScope API key from the Alibaba Cloud Bailian console is required. Configure it in the plugin Settings under dashscope_api_key, or set the DASHSCOPE_API_KEY environment variable before creating tasks.

Why did my DashScope image task fail immediately?

Common causes are a missing API key, which returns a configuration error, or DashScope content moderation rejecting sensitive prompts, which fails without retry. Modify the prompt wording and resubmit the task.

Can I use generated images in downstream video or storyboard workflows?

Yes, generated images are published to the Asset Bus with asset_ids that downstream tools like seedance-video can consume directly. The storyboard plugin can also export shots as batch request bodies for bulk image generation.

When should I not use Tongyi Image for image tasks?

Avoid it for video generation, which belongs to the seedance-video skill, and for precise mask-based local retouching, which the image-edit plugin handles better. Large e-commerce batches also increase cost, so test with one image first.