Hongguo Video Downloader & Decryption to KVS

中文 | English

红果短剧下载器：视频下载、解密并保存到 Apify KVS

红果短剧下载器（Hongguo short drama video downloader API） 用于批量下载和解密已获授权的红果短剧剧集。输入一个或多个红果 videoId，Actor 会自动选择最佳可用画质，生成可播放 MP4，并把视频、脱敏元数据和签名下载链接保存到本次运行的 Apify Key-value store（KVS）。

与只返回临时媒体 URL 的解析工具不同，这个 Actor 会交付真实 MP4 文件；与输出到 S3、OSS 或 COS 的 video-download 不同，它不需要对象存储账号、Bucket 或云存储密钥。适合红果短剧视频下载、授权归档、转录准备、字幕处理、媒体分析和自动化工作流。

请仅下载、解密和存储你拥有或已获得明确授权的内容。此 Actor 不访问私人账号，也不绕过内容授权检查。

红果短剧视频下载和解密流程

阶段	Actor 操作	输出
解析	获取最新媒体信息并选择最佳可用画质。	可用的最佳视频版本。
下载	使用受控并发下载加密媒体，并校验文件大小。	完整的源媒体文件。
解密与验证	解密受支持的 CENC 视频，检查 MP4、时长、编码和分辨率。	可播放、未经放大的 MP4。
KVS 交付	将 MP4 和脱敏 JSON 元数据写入默认 KVS。	签名下载链接和 Dataset 索引。

每个成功的视频 ID 会生成两个 KVS 记录：

video-{videoId}.mp4
meta-{videoId}.json

为什么使用这个红果短剧视频下载 API？

• 一次运行最多处理 1,000 个唯一红果视频 ID。
• 默认并发处理 8 个视频，完成一个后立即补入下一个任务。
• 自动选择最佳可用画质，不需要手动挑选清晰度。
• 输出真实、可播放的解密 MP4，而不仅是临时 CDN URL。
• 视频和元数据直接保存在 Apify KVS，无需 AWS S3、阿里云 OSS 或腾讯云 COS。
• Dataset 返回 KVS ID、记录键、签名链接、分辨率、编码、文件大小和 SHA-256。
• 支持 Apify REST API、Python/JavaScript Client、定时任务、Webhook、Make 和 n8n。
• 只有 MP4 与元数据均成功写入后才计一次成功事件费用。

红果短剧下载器会输出哪些数据？

Dataset 字段	类型	说明
videoId	string	请求的红果短剧剧集视频 ID。
success	boolean	MP4 和元数据是否均已成功写入 KVS。
definition	string	自动选择的视频画质。
width, height	integer	验证后的 MP4 尺寸。
codec	string	从解密 MP4 中检测到的视频编码。
keyValueStoreId	string	本次运行默认 KVS 的 ID。
videoRecordKey	string	可播放 MP4 的 KVS 记录键。
metaRecordKey	string	脱敏元数据的 KVS 记录键。
videoUrl, metaUrl	string	对应 KVS 记录的签名访问地址。
fileSize, sha256	integer / string	MP4 字节数和 SHA-256 校验值。
error	string 或 null	失败结果的安全诊断信息。

源媒体临时 URL、内容密钥、解密信封和内部签名数据不会写入 Dataset、KVS 元数据或应用日志。

如何下载红果短剧视频？

1. 使用红果短剧详情与剧集列表 Actor取得已授权剧集的 videoId。
2. 打开本 Actor 的 Input 标签页。
3. 在 videoIds 中添加一个或多个纯数字视频 ID。
4. 点击 Start；Actor 会并发解析、下载、解密和验证视频。
5. 在 Output → Video files 下载 MP4，或从 Dataset 读取 videoUrl。

红果短剧视频下载如何计费？

本 Actor 使用 Pay per event：

• FREE：每个成功视频 $0.0035，即每 1,000 个成功视频 $3.50。
• BRONZE、SILVER、GOLD、PLATINUM、DIAMOND：每个成功视频 $0.0025，即每 1,000 个 $2.50。
• 失败结果不触发 video-uploaded 费用。

Apify 计算、代理、数据传输、KVS 读写和按时间计算的存储容量属于额外平台用量。视频保留越久、被下载次数越多，KVS 费用越高；删除不再需要的运行存储即可停止后续容量费用。

输入

完整校验规则请查看 Input 标签页。此 Actor 只需要 videoIds，不需要对象存储配置或密钥。

{
  "videoIds": [
    "7639688323115519038",
    "7639688303955938366"
  ]
}

输出

默认 Dataset 可以下载为 JSON、HTML、CSV 或 Excel；视频本体和元数据保存在同一次运行的默认 KVS。

{
  "videoId": "7639688323115519038",
  "success": true,
  "definition": "1080p",
  "width": 1080,
  "height": 1920,
  "codec": "hevc",
  "provider": "apify-kvs",
  "keyValueStoreId": "AbCdEfGhIjKlMnOpQ",
  "videoRecordKey": "video-7639688323115519038.mp4",
  "metaRecordKey": "meta-7639688323115519038.json",
  "videoUrl": "https://api.apify.com/v2/key-value-stores/AbCdEfGhIjKlMnOpQ/records/video-7639688323115519038.mp4?signature=...",
  "fileSize": 17080494,
  "sha256": "f7db5d68490b3080fe35fbff46dfc425d1967bd0de9c0bead8b164ec9bbc838e",
  "error": null
}

通过 API 批量下载红果短剧视频

Actor 页面：Hongguo Short Drama Video Downloader API to KVS

使用 Actor 名称或稳定 Actor ID 调用异步 REST API：

curl -X POST \
  'https://api.apify.com/v2/acts/spider_studio~hongguo-video-download-kvs/runs' \
  -H 'Authorization: Bearer YOUR_APIFY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"videoIds":["7639688323115519038"]}'

运行结果会返回 defaultDatasetId 和 defaultKeyValueStoreId。也可以在 API 标签页复制 Python、JavaScript、CLI、HTTP 或 MCP 调用示例。

KVS 保留期、下载链接和适用场景

默认 KVS 与 Actor 运行关联，保留时间取决于用户的 Apify 套餐与 Storage retention 设置。videoUrl 是签名 bearer 链接，只应提供给获授权的接收方；对应 KVS 记录被删除后，链接也会失效。

此版本适合临时下载、内部处理、小规模授权归档和无需外部 Bucket 的工作流。如果需要长期保存、CDN、版本控制、生命周期规则或大量在线播放，请使用输出到用户对象存储的版本。

红果短剧下载可靠性与限制

• 云端回归验证于 2026 年 9 月 2 日完成：一个约 17 MB 的代表性剧集成功生成 MP4、JSON 元数据和 Dataset 成功行。
• 默认并发为 8，可通过 Actor 环境配置调整为 1–20。
• Actor 保留最佳可用源画质，但不会增强或放大原始视频。
• 临时上游媒体信息可能过期；重新运行会重新解析最新可用地址。
• KVS 更适合作为结果存储，而不是大规模视频 CDN。

相关红果短剧 Actor

Actor	用途
红果短剧搜索与数据爬虫 API	按剧名、题材或关键词查找红果短剧和 seriesId。
红果短剧详情与剧集列表 API	获取完整剧集列表和本 Actor 接受的 videoId。
红果短剧最佳画质视频地址 API	只解析最佳画质和临时媒体 URL，不下载文件。
红果短剧全部画质与地址 API	查看所有可用画质、分辨率、码率和 URL。
红果视频下载与解密到对象存储	将解密 MP4 上传到用户的 S3、OSS、COS 或兼容存储。

红果短剧视频下载常见问题

这个 Actor 是红果短剧下载器吗？

是。它会为已授权的红果 videoId 下载真实媒体文件、完成受支持的解密流程，并输出可播放 MP4，而不是只返回视频页面或临时 URL。

可以批量下载一整部红果短剧吗？

可以。先通过 Series Details Actor 获取剧集 videoId 列表，再一次提交最多 1,000 个唯一 ID。Actor 默认同时处理 8 个视频。

是否需要 AWS S3、OSS 或 COS？

不需要。MP4 和元数据直接保存到本次运行的 Apify KVS。如果需要长期对象存储，请选择对应的外部存储版本。

会下载最佳画质吗？

Actor 自动选择最佳可用版本，并保留受支持的源画质。它不会承诺不存在的 4K，也不会进行人工放大。

KVS 中保存的是视频还是下载链接？

两者都有。KVS 保存实际 MP4 文件；Dataset 同时返回记录键和签名 videoUrl，方便浏览器、脚本或后续 Actor 获取文件。

视频文件会永久保留吗？

不一定。默认 KVS 遵循 Apify 的运行数据保留规则。需要永久保存时，应使用命名存储或外部对象存储，并管理相应费用与访问权限。

未获得内容授权可以使用吗？

不可以。用户必须拥有下载、解密、存储和处理相关内容的合法权利，并遵守红果短剧条款、版权要求及适用法律。

合法使用与支持

此 Actor 仅用于用户拥有或已明确获得授权的红果短剧内容。它不登录私人账号、不访问私人用户数据，也不覆盖平台的授权检查。不同地区法律可能不同；如不确定用途是否合法，请咨询专业律师。

需要帮助时，请在 Actor 的 Issues 标签页提交问题并附上运行链接；程序化集成请查看 API 标签页。

---

What does Hongguo Short Drama Video Downloader do?

Hongguo Short Drama Video Downloader API bulk-downloads and decrypts authorized episodes from Hongguo Duanju. Submit one or more Hongguo videoId values and the Actor selects the best available rendition, creates a playable MP4, validates the media, and stores the video plus redacted metadata in the run's Apify Key-value store (KVS).

Unlike Hongguo URL extractors, this Actor delivers the actual decrypted MP4 rather than only a temporary CDN link. Unlike the S3/OSS/COS edition, it requires no external bucket, cloud account, or storage credentials. It is designed for authorized Hongguo video downloads, Chinese short-drama archiving, transcription preparation, subtitle workflows, media analysis, and automation pipelines.

Use it only for content you own or are explicitly authorized to download, decrypt, and store.

Why use this Hongguo video downloader API?

• Process up to 1,000 unique Hongguo episode IDs in one run.
• Run eight video jobs concurrently by default with a bounded rolling task pool.
• Select the best available quality automatically.
• Produce a real playable MP4, not just a short-lived source URL.
• Store MP4 and JSON metadata directly in Apify KVS with no S3 setup.
• Return signed download links, KVS keys, resolution, codec, file size, and SHA-256 in Dataset.
• Integrate through the Apify REST API, Python/JavaScript clients, schedules, webhooks, Make, n8n, or MCP.
• Charge the success event only after both KVS records are available.

How does Hongguo video download and decryption work?

Stage	Action	Result
Resolve	Fetch fresh media details and rank available renditions.	Best available rendition for the episode.
Download	Transfer the encrypted media with size limits and retries.	Complete source media file.
Decrypt and validate	Produce and inspect the MP4 duration, codec, and dimensions.	Playable MP4 preserving supported source quality.
Deliver	Store MP4 and redacted metadata in the default KVS.	Signed links plus a searchable Dataset row.

Successful episodes create video-{videoId}.mp4 and meta-{videoId}.json records.

What Hongguo video data does the API return?

Field	Description
videoId, success, error	Requested episode ID and processing status.
definition, width, height, codec	Selected and validated media properties.
keyValueStoreId	Default KVS containing the output files.
videoRecordKey, metaRecordKey	Stable record keys for MP4 and metadata.
videoUrl, metaUrl	Signed links for retrieving the records.
fileSize, sha256	MP4 size and integrity digest.

Temporary source URLs, content keys, decryption envelopes, and internal signing data are excluded from public results.

How to download Hongguo short drama episodes

1. Obtain authorized episode IDs with the Hongguo Series Details Actor.
2. Open this Actor's Input tab.
3. Add one or more numeric IDs to videoIds.
4. Click Start and wait while videos are processed concurrently.
5. Open Output → Video files, or read videoUrl from Dataset.

How much does Hongguo video downloading cost?

FREE-tier runs cost $0.0035 per successfully stored video. BRONZE through DIAMOND tiers cost $0.0025 per success. Failed videos do not trigger the video-uploaded event.

Apify compute, proxy, transfer, KVS operations, and timed storage are separate platform usage. Retaining videos longer or downloading them repeatedly increases storage and transfer costs.

Input

See the Input tab for validation details. No storage credentials are required.

{
  "videoIds": ["7639688323115519038"]
}

Output

You can download the default Dataset as JSON, HTML, CSV, or Excel. The actual MP4 and JSON files are stored in the run's default KVS and exposed through the signed links in successful Dataset rows.

Hongguo video downloader API integration

Actor page: Hongguo Short Drama Video Downloader API to KVS

Start an asynchronous run with the stable Actor name:

curl -X POST \
  'https://api.apify.com/v2/acts/spider_studio~hongguo-video-download-kvs/runs' \
  -H 'Authorization: Bearer YOUR_APIFY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"videoIds":["7639688323115519038"]}'

The run response includes defaultDatasetId and defaultKeyValueStoreId. Open the API tab for Python, JavaScript, CLI, HTTP, OpenAPI, and MCP examples.

Reliability, retention, and limits

• Cloud-verified on September 2, 2026 with a representative episode of about 17 MB; the run produced an MP4 record, metadata record, and successful Dataset row.
• Default concurrency is 8 and can be configured from 1 to 20.
• The Actor preserves supported source quality but does not upscale video.
• Default KVS retention follows the user's Apify storage settings.
• Signed record URLs are bearer links and should be shared only with authorized recipients.
• KVS is convenient result storage, not a replacement for a high-volume video CDN.

Related Hongguo short drama Actors

Actor	Purpose
Hongguo Short Drama Search API	Find dramas and series IDs by title, trope, or keyword.
Hongguo Series Details & Episodes API	Retrieve full episode lists and accepted videoId values.
Hongguo Best Quality Video URL API	Resolve the best rendition and temporary media URL without downloading.
Hongguo All Video Qualities API	Inspect every available resolution, bitrate, codec, and URL.
Hongguo Video Downloader to Object Storage	Deliver decrypted MP4 files to S3, OSS, COS, or compatible storage.

Frequently asked questions

Is this a Hongguo short drama downloader?

Yes. For authorized Hongguo episode IDs, it downloads the media, performs the supported decryption process, validates the output, and delivers a playable MP4.

Can I bulk-download a full Hongguo series?

Yes. Retrieve episode IDs from the Series Details Actor, then submit up to 1,000 unique IDs. Eight videos are processed concurrently by default.

Does it need AWS S3, Alibaba OSS, or Tencent COS?

No. This edition stores output directly in Apify KVS. Choose the object-storage edition when you need CDN delivery, lifecycle policies, versioning, or long-term archives.

Does KVS contain the actual video or only a URL?

Both are provided: KVS contains the actual MP4 record, while Dataset contains its record key and signed videoUrl for convenient retrieval.

Does it always download the highest quality?

It selects the best rendition available for the episode and preserves supported source quality. It does not invent 4K or upscale lower-resolution media.

Are Hongguo videos stored permanently?

Not necessarily. The default KVS follows Apify run-retention settings. Use named or external object storage when permanent retention is required.

Can I use it without content authorization?

No. You must have the legal right to download, decrypt, store, and process the submitted content and comply with Hongguo's terms, copyright rules, and applicable law.

Legal use and support

This Actor is intended only for Hongguo content that the user owns or is explicitly authorized to process. It does not log into private accounts, collect private user data, or override entitlement checks. Laws vary by jurisdiction; consult qualified counsel if you are unsure whether your use is permitted.

For help, open the Issues tab and include the run URL. For programmatic integration, use the API tab.