- What's New
- Function Overview
- Service Overview
- Billing
- Getting Started
- User Guide
-
Best Practices
- Using MPC to Transcode Media Files in OBS
- H.264 and H.265 Low-bitrate HD Creates an Amazing Experience for Video Websites
- Snapshot Capturing Facilitates the Setup of Media Processing Platform for Your Video Website
- Video Packaging Enables the Playback of Online Education Videos on Multiple Terminal Types
- Change History
-
API Reference
- Before You Start
- API Overview
- Calling APIs
- Application Examples
- Transcoding Template APIs
- Transcoding Template Group APIs
- Watermark Template APIs
- Transcoding APIs
- Packaging APIs
- Animated GIF APIs
- Video Metadata Extraction APIs
- Snapshot APIs
-
Authorization and Configuration APIs
- Configuring Transcoding Server Event Notifications
- Querying Transcoding Server Event Notifications
- Querying All Events on a Transcoding Server
- Querying Buckets
- Authorizing or Canceling Authorization of Access to OBS Buckets
- Querying Objects in a Bucket
- Requesting OBS Authorization
- Querying the Status of OBS Authorization Task Creation
- Tenant Subscription
- Appendix
- Change History
- SDK Reference
-
FAQs
- Product Consulting
- Billing
- Upload
-
Transcoding
- Files of What Formats Can Be Transcoded?
- What If Transcoding Fails?
- Can a Transcoding Task Have Multiple Outputs?
- What Is a System Template? What Is It Used for?
- How Do I Download Output Videos?
- What Are the Differences Between DASH, HLS, and MP4 Videos?
- How Do I Share Transcoded Videos?
- How Do I Determine Whether Source Videos Can Be Transcoded to SD, HD, and UHD Videos?
- Why Is There Only Audio but No Image After Video Transcoding?
- Why Can't I Find My OBS Bucket When Creating a Transcoding Task?
- How Do I Overwrite the Input Video File with the Output Video File?
- How Long Does a Transcoding Task Take?
- How Do I Configure Transcoding Event Notifications?
- Can a Low-resolution Video Be Transcoded to a High-resolution One?
- Can I Set the Same Bucket Name and Path for Both Input and Output Buckets During Transcoding?
- Notifications
- Packaging/GIF Converting
- Frame Capture
- Video Watermark
-
API and SDK Usage
- Can I Deliver Transcoding Tasks in Batches?
- How Long Does a Task Take from Submission to Execution?
- Failed to Transcode MP3 Files and A Message Is Displayed Indicating that the Source Width and Height Are Incorrect
- Why Is "The token must be updated" Returned When I Call an API?
- Why Is a Message Displayed Indicating that the Token Is Invalid When I Call an API?
- What Can I Do If an Error Message Is Displayed Indicating that the Input or Output OBS Path Is Invalid When I Use the SDK or API?
- Does MPC Support Video Rotation?
- How Do I Call a Transcoding API to Specify an Output File Name?
- Why Can't I Cancel the Authorization After the IAM User Delegates the Read and Write Permissions on OBS Buckets?
- Videos
- General Reference
Copied.
Example 3: Submit a Video Snapshot Task
Scenario
You can set snapshot parameters when submitting a video transcoding task for taking snapshots during transcoding. If you only want to take snapshots from a video file without transcoding, you can call the API for taking snapshots.
This section describes how to submit a video snapshot task by invoking an API.
Constraints
Cross-region transcoding is not supported. For example, MPC in the CN North-Beijing1 region cannot transcode video files stored in an OBS bucket in the CN North-Beijing4 region.
Prerequisites
- You have obtained the project ID of the region where the snapshot task is to be created. For details, see Obtaining a Project ID.
- You have determined the region where the snapshot capturing task to be created is located and obtained the endpoint of MPC for this region from the Regions and Endpoints.
- You have stored the video file for which snapshots will be captured in an OBS bucket. If you have not, call the API for uploading an object to upload the file.
- You have created an OBS bucket where snapshots will be stored. If you have not, call the API for creating a bucket.
Overall Process
Procedure
- Obtain a user token and use it to authenticate the calling of MPC APIs.
Obtain the username, password, domainname, and projectname from the My Credentials page. Call the following API to obtain the token. For details, see Making an API Request.
POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "********", //Username "password": "********", //Login password "domain": { "name": "domainname" //Name of the account to which the user belongs } } } }, "scope": { "project": { "name": "*******" //Project name } } } }
As shown in Figure 1, information in the red box indicates the user token.
- Create a snapshot task.
- Select the POST request method and enter the request URI.
https://{endpoint}/v1/{project_id}/thumbnails
- In the request header, add X-Auth-Token and set its value to be the token obtained in 1.
- Specify the following parameters in the request body:
{ "input": { "bucket": "example-bucket", "location": "region01", "object": "/mpc/input/sample.MP4" }, "output": { "bucket": "example-bucket", "location": "region01", "object": "/mpc/output/ "}, "tar": 1, "thumbnail_para": { "type":"DOTS", "dots":[2,4,6,8,10], "format":0, "aspect_ratio":1, "max_length":480 } }
- If the request succeeds, the snapshot task ID is returned.
{ "task_id": "2081" }
- Select the POST request method and enter the request URI.
- Query the task status.
- Select the GET request method and enter the request URI.
https://{endpoint}/v1/{project_id}/thumbnails?task_id=2081
- In the request header, add X-Auth-Token and set its value to be the token obtained in 1.
- If the request succeeds, details about the snapshot task are returned.
- Select the GET request method and enter the request URI.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot