DocsICP FilingConsole
官方文档
首页

Intelligent production FAQ

更新时间：
复制 MD 格式
产品详情
我的收藏

Find answers to common questions and solutions to common issues with intelligent production.

Contents

FAQ

How do I export an output video to ApsaraVideo for VOD?

When calling the SubmitMediaProducingJob API, set the OutputMediaTarget parameter to vod-media. In the OutputMediaConfig parameter, set StorageLocation and FileName to the storage location and filename of the media asset in ApsaraVideo for VOD:

"OutputMediaConfig": {
  "StorageLocation": "outin-8e7*******.oss-cn-shanghai.aliyuncs.com",
  "FileName": "vod-output.mp4"
}

How do I get the results of an intelligent production job?

After calling SubmitMediaProducingJob, the response includes a JobId. Pass this JobId to the GetMediaProducingJob API to poll the job status. The current status is returned in the Status field.

How long does an intelligent production job take?

Production time is roughly equal to the output video duration. A 5-minute video typically takes about 5 minutes to produce. All jobs also require time for queuing, file analysis, and downloading, so even the shortest videos take at least 15 seconds. For a 15-second video, production time can range from 15 seconds to 2 minutes depending on complexity.

If you submit a large batch of jobs—such as tens of thousands at once—they are queued and processed in order. To increase processing capacity, submit a ticket.

What factors affect production time?

Video production is a frame-by-frame process, so production time scales with resolution and output duration. It also increases when jobs involve many special effects or transitions, or when the source media is scaled significantly (for example, downscaling a 4K clip to 480p). An incorrect timeline configuration can also slow down production.

If production time is consistently longer than expected, submit a ticket or join the support group on DingTalk (ID: 84650000851) for assistance.

Why is the output video duration different from what I expected?

  • Transitions shorten total duration. A transition overlaps two adjacent clips, causing the second clip to start earlier. This reduces the total output duration. To preserve the original duration, leave enough time when trimming clips to account for the overlap. Alternatively, use DLTransition, which pads frames during the transition and preserves the total duration.

  • AI_TTS can extend total duration. The generated audio track may be longer than the video track, which extends the overall output. For a solution, see Automatically align the duration of different media clips.

  • Missing In/Out points cause unexpected duration. If you set only TimelineIn and TimelineOut without setting in and out for a clip, the system processes the clip at its original duration. Set in = 0 and out = timelineOut - timelineIn to define the clip duration explicitly.

Why does my output video show a black screen after a certain time?

This usually happens when the video clip is shorter than another track. For example, if the video clip is 6 seconds but the audio track is 12 seconds, the last 6 seconds render as a black screen. To fix this, set the video track as the main track—this forces all other tracks to match its duration. Alternatively, trim the other tracks to match the video duration.

Why do I receive a "TimelineFormatError" when calling the API?

Check that your timeline structure matches the required format and that the JSON is syntactically valid. For the timeline schema, see Timeline configuration. For practical examples, see Mix and edit videos and images.

Why are subtitles not displaying correctly?

For less common scripts such as Korean, Arabic, or Mongolian, display problems are usually caused by font rendering. Try resubmitting the job with the default Alibaba Cloud Puhui font. If the issue persists, join the Intelligent Media Services product group on DingTalk (ID: 84650000851).

Why is the output position of images, text, or subtitles incorrect?

  • Make sure the output resolution matches the preview resolution. Using relative position values (0 to 1) instead of absolute pixel values keeps layout consistent across different resolutions.

  • If clips on the same track overlap in time or position, the anti-collision mechanism may shift their positions. Place overlapping clips on separate tracks for more precise control.

Why does the subtitle FontSize not match the preview?

  • If you use FontSize in Effect Type: Text, the font size is scaled relative to the clip and output dimensions. Switch to FixedFontSize to use an absolute pixel value that does not scale.

  • If you use SubtitleTrackClip with a custom font, the rendered height in pixels may be smaller than the FontSize value for certain fonts. Set SizeRequestType=Nominal to make the rendered pixel height equal the font size value.

  • Specify the preview canvas dimensions to align font size between preview and output. For example, to produce a 720p video, set FECanvas={"Height":720,"Width":1280}.

What do I do if I receive a "Throttling.User" error when submitting a job?

  • The IMS write APIs are limited to 30 queries per second (QPS). If you hit the limit, wait one second and resubmit. At 30 QPS, you can submit up to 1,800 jobs per minute, which covers most workloads.

  • If your use case requires sustained throughput above 30 QPS—for example, producing millions of videos within 30 minutes for a marketing campaign—submit a ticket to request a QPS increase.

What should I do if the index analysis fails?

On the media asset management page, select the media asset you want to re-analyze and click Index and Analyze below the list. This starts a new index analysis job.

Previous：Billing FAQNext：FAQ about batch video production