alicloud-ai-entry-modelstudio

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.