Alicloud Ai Entry Modelstudio

---
name: alicloud-ai-entry-modelstudio
description: "Route Alibaba Cloud Model Studio requests to the right local skill (Qwen Image, Qwen Image Edit, Wan Video, Wan R2V, Qwen TTS, Qwen ASR and advanced TTS variants). Use when the user asks for Model Studio without specifying a capability."
---

Category: task

# Alibaba Cloud Model Studio Entry (Routing)

Route requests to existing local skills to avoid duplicating model/parameter details.

## Prerequisites

- Install SDK (virtual environment recommended to avoid PEP 668 restrictions):

```bash
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope
```
- Configure `DASHSCOPE_API_KEY` (environment variable preferred; or `dashscope_api_key` in `~/.alibabacloud/credentials`).

## Routing Table (currently supported in this repo)

| Need | Target skill |
| --- | --- |
| Text-to-image / image generation | `skills/ai/image/alicloud-ai-image-qwen-image/` |
| Image editing | `skills/ai/image/alicloud-ai-image-qwen-image-edit/` |
| Text-to-video / image-to-video (i2v) | `skills/ai/video/alicloud-ai-video-wan-video/` |
| Reference-to-video (r2v) | `skills/ai/video/alicloud-ai-video-wan-r2v/` |
| Text-to-speech (TTS) | `skills/ai/audio/alicloud-ai-audio-tts/` |
| Speech recognition/transcription (ASR) | `skills/ai/audio/alicloud-ai-audio-asr/` |
| Realtime speech recognition | `skills/ai/audio/alicloud-ai-audio-asr-realtime/` |
| Realtime TTS | `skills/ai/audio/alicloud-ai-audio-tts-realtime/` |
| Live speech translation | `skills/ai/audio/alicloud-ai-audio-livetranslate/` |
| CosyVoice voice clone | `skills/ai/audio/alicloud-ai-audio-cosyvoice-voice-clone/` |
| CosyVoice voice design | `skills/ai/audio/alicloud-ai-audio-cosyvoice-voice-design/` |
| Voice clone | `skills/ai/audio/alicloud-ai-audio-tts-voice-clone/` |
| Voice design | `skills/ai/audio/alicloud-ai-audio-tts-voice-design/` |
| Omni multimodal interaction | `skills/ai/multimodal/alicloud-ai-multimodal-qwen-omni/` |
| Visual reasoning | `skills/ai/multimodal/alicloud-ai-multimodal-qvq/` |
| Text embeddings | `skills/ai/search/alicloud-ai-search-text-embedding/` |
| Rerank | `skills/ai/search/alicloud-ai-search-rerank/` |
| Vector retrieval | `skills/ai/search/alicloud-ai-search-dashvector/` or `skills/ai/search/alicloud-ai-search-opensearch/` or `skills/ai/search/alicloud-ai-search-milvus/` |
| Document understanding | `skills/ai/text/alicloud-ai-text-document-mind/` |
| Video editing | `skills/ai/video/alicloud-ai-video-wan-edit/` |
| Model list crawl/update | `skills/ai/misc/alicloud-ai-misc-crawl-and-skill/` |

## When Not Matched

- Clarify model capability and input/output type first.
- If capability is missing in repo, add a new skill first.

## Common Missing Capabilities In This Repo (remaining gaps)

- text generation/chat (LLM)
- multimodal embeddings
- OCR-specialized extraction and image translation
- virtual try-on / digital human / advanced video personas

- For multimodal/ASR download failures, prefer public URLs listed above.
- For ASR parameter errors, use data URI in `input_audio.data`.
- For multimodal embedding 400, ensure `input.contents` is an array.

## Async Task Polling Template (video/long-running tasks)

When `X-DashScope-Async: enable` returns `task_id`, poll as follows:

```
GET https://dashscope.aliyuncs.com/api/v1/tasks/<task_id>
Authorization: Bearer $DASHSCOPE_API_KEY
```

Example result fields (success):

```
{
  "output": {
    "task_status": "SUCCEEDED",
    "video_url": "https://..."
  }
}
```

Notes:
- Recommended polling interval: 15-20 seconds, max 10 attempts.
- After success, download `output.video_url`.

## Clarifying questions (ask when uncertain)

1. Are you working with text, image, audio, or video?
2. Is this generation, editing/understanding, or retrieval?
3. Do you need speech (TTS/ASR/live translate) or retrieval (embedding/rerank/vector DB)?
4. Do you want runnable SDK scripts or just API/parameter guidance?

## References

- Model list and links:`output/alicloud-model-studio-models-summary.md`
- API/parameters/examples: see target sub-skill `SKILL.md` and `references/*.md`

- Official source list:`references/sources.md`

## Validation

```bash
mkdir -p output/alicloud-ai-entry-modelstudio
echo "validation_placeholder" > output/alicloud-ai-entry-modelstudio/validate.txt
```

Pass criteria: command exits 0 and `output/alicloud-ai-entry-modelstudio/validate.txt` is generated.

## Output And Evidence

- Save artifacts, command outputs, and API response summaries under `output/alicloud-ai-entry-modelstudio/`.
- Include key parameters (region/resource id/time range) in evidence files for reproducibility.

## Workflow

1) Confirm user intent, region, identifiers, and whether the operation is read-only or mutating.
2) Run one minimal read-only query first to verify connectivity and permissions.
3) Execute the target operation with explicit parameters and bounded scope.
4) Verify results and save output/evidence files.