Alibaba Cloud Video Forge

One-stop video processing through Alibaba Cloud Media Processing Service (MPS), including cover generation, multi-resolution transcoding, content moderation, and more.

🚀 Quick Start

Easiest Way - One-click video processing:

CODEBLOCK0

Common Scenarios

Scenario 1: Bilibili Video Publishing

Scenario 2: UGC Content Moderation

Scenario 3: Multi-Resolution Transcoding

python scripts/mps_transcode.py \
  --oss-object /input/course_video.mp4 \
  --preset multi \
  --output-prefix output/course_2024/

Scenario Description

This skill supports video distribution scenarios:

1. 1. Transcoding — Multi-resolution transcoding with Narrowband HD compression
2. Content Moderation — Auto-detect sensitive content (pornography, terrorism, advertising)
3. Snapshot — Generate cover images and sprite sheets
4. Anti-piracy — Configure encryption for content protection

Architecture

CODEBLOCK4

Components:

• - OSS: Store videos and outputs
• MPS Pipeline: Task queue management
• Transcoding Templates: Narrowband HD, Standard presets
• Moderation: Auto content safety checks

Target Users: Video platforms, content creators, corporate training, education platforms

Capability Overview

See references/capability-overview.md for detailed feature tree and automatic pipeline management.

Prerequisites

Pre-check: Aliyun CLI >= 3.3.1 required
Run aliyun version to verify >= 3.3.1. If not installed, see references/cli-installation-guide.md.
Then [MUST] run aliyun configure set --auto-plugin-install true to enable automatic plugin installation.

Pre-check: Python >= 3.10 required
Run python3 --version to verify.

Pre-check: Alibaba Cloud Credentials Required
Run aliyun configure list to check credential status. If no valid profile, configure via aliyun configure.
See references/security-guidelines.md for credential security rules.

Environment Variables

Required environment variables:

• - ALIBABA_CLOUD_REGION - Service region (default: cn-shanghai)
• INLINECODE7 - OSS Bucket name
• INLINECODE8 - OSS endpoint
• INLINECODE9 - MPS Pipeline ID (optional, auto-selected if not set)

Security Note: Credentials are managed via the Alibaba Cloud default credential chain. Configure credentials using aliyun configure command. NEVER handle AK/SK directly in scripts or commands.

🔒 Security Guidelines

See references/security-guidelines.md for complete security guidelines and credential management best practices.

SDK Installation

See references/sdk-installation.md for detailed installation guide and troubleshooting.

Run python3 --version to verify. Some scripts may fail with older Python versions.

RAM Permissions

[MUST] RAM Permission Pre-check: Verify that the current user has the following RAM permissions before execution.
See references/ram-policies.md for complete permission list and details.

[MUST] Permission Failure Handling: When any command or API call fails due to permission errors at any point during execution, follow this process:

1. 1. Read references/ram-policies.md to get the full list of permissions required by this SKILL
2. Use ram-permission-diagnose skill to guide the user through requesting the necessary permissions
3. Pause and wait until the user confirms that the required permissions have been granted

Parameter Confirmation

IMPORTANT: Parameter Confirmation — Before executing any command or API call,
ALL user-customizable parameters (e.g., input video path, output bucket, template ID, etc.)
MUST be confirmed with the user. Do NOT assume or use default values without explicit user approval.

Core Workflow

Scenario 1: One-stop Video Standardization

Complete workflow: User provides video → Upload to OSS → Media info probe → Cover generation (snapshot) → Multi-resolution transcoding → Content moderation → Summary results (with download links)

Step 0: Automatic Pipeline Selection (Optional)

This skill supports automatic pipeline management, typically no manual Pipeline ID configuration needed. Scripts automatically select appropriate pipelines based on task type.

To manually specify:

CODEBLOCK5

Step 1: Upload Video to OSS

CODEBLOCK6

Step 2: Media Info Probe

CODEBLOCK7

Step 3: Cover Generation (Snapshot)

Use snapshot function to generate video cover at specified time:

CODEBLOCK8

Step 4: Adaptive Transcoding (Auto-select best resolution and Narrowband HD template)

CODEBLOCK9

Step 5: Content Moderation

CODEBLOCK10

Step 6: Poll Task Status

CODEBLOCK11

Complete Example

CODEBLOCK12

Other Scenarios

Scenario 2: Transcoding Only

Execute transcoding only, without snapshot and moderation:

CODEBLOCK13

Scenario 3: Content Moderation

Execute content moderation only:

CODEBLOCK14

Success Verification

After video processing, check results:

1. 1. Script exit code is 0
2. Output contains processed media info (OSS path)
3. Transcoding job status is "Success"
4. Content moderation shows no violations
5. Artifacts downloaded locally (using oss_download.py)

Notes on Artifact Retrieval:

• - OSS files require signing for online access, direct URL access returns 403 error
• Recommend using oss_download.py to download results locally
• For online preview, use --sign-url parameter to generate temporary pre-signed URL

CODEBLOCK15

Troubleshooting

See references/troubleshooting.md for comprehensive troubleshooting guide.

Cleanup

Intermediate files and output files from this skill are stored in OSS. To clean up:

CODEBLOCK16

Note: Delete operations are irreversible. Confirm before executing. Use --dry-run to preview first.

Available Scripts

Best Practices

1. 1. Always check environment variables first — Run python scripts/load_env.py --check-only at the start of each session
2. Use polling instead of waiting — Use poll_task.py to auto-poll status after submitting jobs
3. Choose resolutions wisely — Select appropriate transcoding resolutions based on target user devices
4. Enable content moderation — For UGC content, always enable automatic moderation
5. Use virtual environment — Ensure dependency isolation to avoid version conflicts
6. Automatic pipeline management — No need to manually configure Pipeline ID, scripts auto-select appropriate pipelines based on task type

Reference Documentation

CLI Command Standards

Important: If using aliyun CLI commands, all commands MUST include the --user-agent AlibabaCloud-Agent-Skills parameter.
Example: INLINECODE34