You need to enable JavaScript to run this app.
Torch Object Storage

Torch Object Storage

Copy page
Download PDF
Media processing
CreateRemuxJob
Copy page
Download PDF
CreateRemuxJob
Description​
This interface processes audio and video files through remuxing.​
Notes​
  • Audio and video remux tasks only support asynchronous processing (x-tos-async-process mode).​
  • You must have CreateMediaProcessJobs permissions required for data processing.​
Request syntax​
​
POST /?job_type=Remux&media_jobs= HTTP/1.1​
Host: {BucketName}.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Content-Type: application/json​
Content-Length: <length>​
Authorization: authorization string​
​
{​
"Input": {​
"Object": "sample.mp4"​
},​
"RemuxConfig": {​
"Format": "mp4",​
"TranscodeIndex": 0,​
"AIGCMetadata": {​
"Label": "",​
"ContentProducer": "",​
"ProduceID": "",​
"ContentPropagator": "",​
"PropagateID": "",​
"ReservedCode1": "",​
"ReservedCode2": ""​
}​
},​
"Output": {​
"Region": "cn-beijing",​
"Bucket": "testbkt",​
"Object": "output.mp4"​
}​
} ​
​
Request parameters and headers ​
For common request headers, see Common Parameters.​
​
Field name​
Location​
Type​
Required​
Example value​
Description​
job_type​
Query​
String​
Yes​
Remux​
Task type, the value is Remux only in remux scenarios.​
media_jobs​
Query​
String​
Yes​
-​
Represents a unique identifier for media task requests.​
​
Request body elements​
​
Field name​
Type​
Required​
Example value​
Description​
RemuxConfig​
Container​
Yes​
-​
Specific configuration for the transmuxing task.​
Format​
String​
Yes​
mp4​
Audio and video container formats.​
Supported:​
  • mp4​
  • mkv​
  • avi​
  • mkv​
  • ts​
  • mp3​
  • aac​
  • flac​
Parent node: RemuxConfig​
TranscodeIndex​
String​
No​
0​
Stream number to process. Once specified, the output file will only retain the designated audio and video streams.​
Process all streams by default.​
Parent node: RemuxConfig​
AIGCMetadata​
Container​
No​
-​
AIGC metadata identifier content.​
  • Encoding format supports only mp4 when not nil;​
  • All field lengths under AIGCMetadata are limited to 22,048 UTF-8 characters, with character restrictions set to GB18030—2022 (ASCII) code points from 0x21 to 0x7E.​
Parent node: RemuxConfig​
Label​
String​
Yes​
test_label​
Generate synthetic label elements to indicate if the video is, may be, or is suspected to be AI-generated synthetic content.​
Parent node: AIGCMetadata​
ContentProducer​
String​
Yes​
test_content_producer​
Generates an element for the synthesis service provider, containing the name or code of the video generation synthesis service provider.​
Parent node: AIGCMetadata​
ProduceID​
String​
Yes​
test_produce_id​
Content production identification element, representing the unique identifier assigned to the content by the video generation and synthesis service provider.​
Parent node: AIGCMetadata​
ContentPropagator​
String​
No​
test_content_propagator​
Content distribution provider element, representing the name or code of the video distribution service provider.​
Parent node: AIGCMetadata​
PropagateID​
String​
No​
test_propagate_id​
Content distribution ID element; the value is the unique ID assigned by the video service provider to this video.​
Parent node: AIGCMetadata​
ReservedCode1​
String​
No​
dGVzdF9yZXNlcnZlZF9jb2RlXzE=​
Reserved field 1 contains user-initiated security protection information to safeguard content and identify integrity. Must be base64 encoded before transmission.​
Parent node: AIGCMetadata​
ReservedCode2​
String​
No​
dGVzdF9yZXNlcnZlZF9jb2RlXzI=​
Reserved field 2, containing information for user-initiated security protection to safeguard content and identify integrity. The data must be transmitted after base64 encoding.​
Parent node: AIGCMetadata​
​
Response headers​
The response contains common headers. For more information, see Common Parameters.​
Response body elements​
​
Field name​
Type​
Example value​
Description​
Code​
String​
OK​
Status code.​
Message​
String​
Success​
Request status information.​
JobId​
String​
187919df106a49aa402300013e6ba5bf0593​
Audio and video transmuxing task ID.​
​
Sample request​
​
POST /?job_type=Remux&media_jobs= HTTP/1.1​
Host: {BucketName}.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Content-Type: application/json​
Content-Length: <length>​
Authorization: authorization string​
​
{​
"Input": {​
"Object": "sample.mp4"​
},​
"RemuxConfig": {​
"Format": "mp4",​
"TranscodeIndex": 0,​
"AIGCMetadata": {​
"Label": "test_label",​
"ContentProducer": "test_content_producer",​
"ProduceID": "test_produce_id",​
"ContentPropagator": "test_content_propagator",​
"PropagateID": "test_propagate_id",​
"ReservedCode1": "dGVzdF9yZXNlcnZlZF9jb2RlXzE=",​
"ReservedCode2": "dGVzdF9yZXNlcnZlZF9jb2RlXzI="​
}​
},​
"Output": {​
"Region": "cn-beijing",​
"Bucket": "testbkt",​
"Object": "output.mp4"​
}​
} ​
​
Sample response​
​
HTTP/1.1 200 OK​
x-tos-id-2: f91b0c03a01300c1-a444ed0 ​
x-tos-request-id: f91b0c03a01300c1-a444ed0 ​
Date: Fri, 30 Jul 2021 06:45:39 GMT​
server: TosServer​
Content-Length: 80​
​
{​
"Code": "OK",​
"Message": "Success",​
"JobId": "187919df106a49aa402300013e6ba5bf0593"​
}​
​
​
Last updated: 2025.12.03 16:14:57