us3_skill

Overview

This skill uploads files to UCloud US3 object storage and returns public URLs for sharing. It supports images, videos, documents, audio and archives, and can output either a JSON result or a URL-only string. Configure credentials and bucket info via environment variables to enable uploads. The tool is designed for simple CLI automation and integration with other processing pipelines.

How this skill works

The skill reads a local file path and optional object key, computes content-type from the file extension, and sends the file to the configured US3 bucket using the UCloud US3 API. On success it returns a JSON payload with success flag, public URL, object key, bucket name, and size; or a plain URL when run with the url-only option. It validates credentials and common error cases and surfaces clear error codes for missing credentials, missing files, invalid bucket, or upload failures.

When to use it

• You need to store files in UCloud US3 and obtain a public, shareable URL.
• You want a small CLI utility to upload images/videos/documents as part of automation.
• You need to upload Feishu-downloaded images or other temporary files for sharing.
• You want to integrate uploads into media processing pipelines (ffmpeg, OCR).
• You prefer simple JSON output for scripting or a URL-only output for quick sharing.

Best practices

• Set US3_PUBLIC_KEY, US3_PRIVATE_KEY, US3_BUCKET and US3_ENDPOINT environment variables before use.
• Use meaningful key names (paths) to organize files and avoid name collisions.
• Check your UCloud plan for file size limits and adjust batch jobs accordingly.
• Validate local file paths before running the upload to prevent wasted API calls.
• Prefer pregenerated timestamps or UUIDs in keys for deterministic, unique object names.

Example use cases

• Upload a screenshot from /tmp and get a shareable URL for chat or support.
• Upload processed videos from ffmpeg and return URLs for distribution.
• Batch-upload a directory of images to a bucket path for web hosting or archives.
• Automatically upload OCR input/output files so downstream services can access them.
• Share Feishu images by downloading them to /tmp and running the uploader.