{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/pmu0p93xo","result":{"data":{"markdownRemark":{"html":"

简介

\n

视频文字面积占比算子：抽帧 → EasyOCR 的 CRAFT 检测器找文本框 → 计算文字面积占帧面积的比例 → 多帧聚合成一个视频级数值。只产出占比，过滤交给下游表达式。

\n

功能描述

\n\n

算子参数

\n

输入

\n\n\n\n\n\n\n\n\n\n\n\n\n\n
输入含义
videos视频输入数组，内容类型由 video_src_type 决定（路径 / Base64 字符串 / bytes）
\n

输出

\n\n\n\n\n\n\n\n\n\n\n\n\n\n
输出含义
ocr_area_ratiofloat64，文字面积占比，取值 [0, 1]；无有效帧时为 None
\n

参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名称类型默认值描述
video_src_typestr\"video_url\"输入形式：video_url / video_base64 / video_binary
model_pathstr\"/opt/aihc/model\"权重根目录
model_namestr\"EasyOCR\"相对 model_path 的 EasyOCR 权重目录
lang_listlist[str] 或 NoneNone检测语言列表，None 时取 [\"ch_sim\", \"en\"]
sample_modestr\"by_count_uniform\"抽帧模式，透传 VideoFrameSampler：by_count_uniform / by_interval_time / by_interval_frames / by_fps / by_timestamps
start_time_secfloat0.0抽帧起始秒
end_time_secfloat 或 NoneNone抽帧结束秒，None 表示到视频末尾
count_kint 或 None3by_count_uniform 模式的抽帧数
interval_secfloat 或 NoneNoneby_interval_time 模式的间隔秒
interval_framesint 或 NoneNoneby_interval_frames 模式的间隔帧
target_fpsfloat 或 NoneNoneby_fps 模式的目标帧率
timestamps_seclist[float] 或 NoneNoneby_timestamps 模式的时间戳列表
max_framesint 或 NoneNone抽帧数上限
reduce_modestr\"avg\"多帧聚合方式：avg / max / min
video_formatstr\"mp4\"二进制 / Base64 输入的容器格式
rankint0多卡场景 worker 序号，当前只记录不参与设备选择
\n

注意事项

\n\n

调用示例

\n\n
\n
\n
\n Python\n \n
\n
\n 
1from __future__ import annotations\n2\n3import os\n4\n5import daft\n6from daft import col\n7\n8from daft.aihc.common.udf import aihc_udf\n9from daft.aihc.functions.video.video_ocr_area_ratio import VideoOcrAreaRatio\n10\n11os.environ.setdefault(\"BOS_ENDPOINT\", \"http://bj.bcebos.com\")\n12os.environ.setdefault(\"BOS_REGION\", \"bj\")\n13\n14if __name__ == \"__main__\":\n15    if os.getenv(\"DAFT_RUNNER\", \"native\") == \"ray\":\n16        import ray\n17        ray.init(dashboard_host=\"0.0.0.0\", ignore_reinit_error=True)\n18        daft.set_runner_ray()\n19    daft.set_execution_config(actor_udf_ready_timeout=6000, min_cpu_per_task=0)\n20\n21ds = daft.from_pydict({\"video\": [\"bos://your-bucket/sample.mp4\"]})\n22    ds = ds.with_column(\n23        \"ocr_area_ratio\",\n24        aihc_udf(\n25            VideoOcrAreaRatio,\n26            construct_args={\n27                \"video_src_type\": \"video_url\",\n28                \"model_path\": \"/path/to/models\",\n29                \"model_name\": \"EasyOCR\",\n30                \"count_k\": 3,\n31                \"reduce_mode\": \"avg\",\n32            },\n33            num_cpus=1,\n34            num_gpus=1,\n35            concurrency=1,\n36            batch_size=1,\n37        )(col(\"video\")),\n38    )\n39    # 只保留文字面积占比低于 0.3 的视频\n40    ds = ds.where(col(\"ocr_area_ratio\") < 0.3)\n41    ds.show()
\n
\n
\n
\n ","fields":{"slug":"pmu0p93xo","title":"视频 OCR 文字面积占比","date":"2026-09-14","extractedHeadings":[]},"headings":[{"value":"简介","depth":2},{"value":"功能描述","depth":3},{"value":"算子参数","depth":2},{"value":"输入","depth":3},{"value":"输出","depth":3},{"value":"参数","depth":3},{"value":"注意事项","depth":2},{"value":"调用示例","depth":2}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"pmu0p93xo","prev":{"id":"Hmu0p82z5","name":"视频水印概率","path":"Hmu0p82z5","filePath":"操作指南/AI数据处理/算子列表/视频/视频水印概率.md","seo":null,"parentIds":["ilib2qygp","Ymo88m8hi","Imob3m6so","6mpawyry0"],"parents":[{"id":"ilib2qygp","documentId":"bfa43a8b-968a-41a1-8c9d-906507eeaed9","name":"操作指南","repoName":"AIHC","filePath":"操作指南","disabled":false,"path":"ilib2qygp","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"Ymo88m8hi","documentId":"c8cb5e38-f8c5-40f4-a424-b0c7895f0c0a","name":"AI数据处理","repoName":"AIHC","filePath":"操作指南/AI数据处理","disabled":false,"path":"Ymo88m8hi","lastMergeTime":"2026-04-21 14:23:10","isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Imob3m6so","documentId":"fe548e34-6659-4ff5-86f6-eee2c43aec90","name":"算子列表","repoName":"AIHC","filePath":"操作指南/AI数据处理/算子列表","disabled":false,"path":"Imob3m6so","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"6mpawyry0","documentId":"3428d02c-e287-45b8-9d16-5a7b20881dd4","name":"视频","repoName":"AIHC","filePath":"操作指南/AI数据处理/算子列表/视频","disabled":false,"path":"6mpawyry0","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"8mu0pa52a","name":"视频音频标签","path":"8mu0pa52a","filePath":"操作指南/AI数据处理/算子列表/视频/视频音频标签.md","seo":null,"parentIds":["ilib2qygp","Ymo88m8hi","Imob3m6so","6mpawyry0"],"parents":[{"id":"ilib2qygp","documentId":"bfa43a8b-968a-41a1-8c9d-906507eeaed9","name":"操作指南","repoName":"AIHC","filePath":"操作指南","disabled":false,"path":"ilib2qygp","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"Ymo88m8hi","documentId":"c8cb5e38-f8c5-40f4-a424-b0c7895f0c0a","name":"AI数据处理","repoName":"AIHC","filePath":"操作指南/AI数据处理","disabled":false,"path":"Ymo88m8hi","lastMergeTime":"2026-04-21 14:23:10","isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Imob3m6so","documentId":"fe548e34-6659-4ff5-86f6-eee2c43aec90","name":"算子列表","repoName":"AIHC","filePath":"操作指南/AI数据处理/算子列表","disabled":false,"path":"Imob3m6so","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"6mpawyry0","documentId":"3428d02c-e287-45b8-9d16-5a7b20881dd4","name":"视频","repoName":"AIHC","filePath":"操作指南/AI数据处理/算子列表/视频","disabled":false,"path":"6mpawyry0","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"ilib2qygp","documentId":"bfa43a8b-968a-41a1-8c9d-906507eeaed9","name":"操作指南","repoName":"AIHC","filePath":"操作指南","disabled":false,"path":"ilib2qygp","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"Ymo88m8hi","documentId":"c8cb5e38-f8c5-40f4-a424-b0c7895f0c0a","name":"AI数据处理","repoName":"AIHC","filePath":"操作指南/AI数据处理","disabled":false,"path":"Ymo88m8hi","lastMergeTime":"2026-04-21 14:23:10","isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Imob3m6so","documentId":"fe548e34-6659-4ff5-86f6-eee2c43aec90","name":"算子列表","repoName":"AIHC","filePath":"操作指南/AI数据处理/算子列表","disabled":false,"path":"Imob3m6so","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"6mpawyry0","documentId":"3428d02c-e287-45b8-9d16-5a7b20881dd4","name":"视频","repoName":"AIHC","filePath":"操作指南/AI数据处理/算子列表/视频","disabled":false,"path":"6mpawyry0","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}