All Products
Search
Document Center

AI Guardrails:Document Moderation 2.0: Overview and billing

Last Updated:Sep 03, 2026

Document Moderation 2.0 scans PDF, Word, PowerPoint, and Excel files for prohibited content — including pornography, violence, and contraband — and returns page-level risk tags with confidence scores. It integrates Image Moderation 2.0 and Text Moderation 2.0 to cover both visual and textual content in a single API call.

What's new in 2.0

Document Moderation 2.0 expands format support, raises concurrency limits, and replaces per-image/per-character billing with a flat per-page pricing model.

Feature

Document Moderation 2.0

Document Moderation 1.0

Supported formats

DOC, DOCX, PPT, PPTX, PPS, PPSX, PDF, XLS, XLSX, XLTX, XLTM; files without extensions supported

DOC, DOCX, PPT, PPTX, PDF, XLS, XLSX, TXT; files without extensions not supported

Document size limit

200 MB

200 MB

Page limit

1,000 pages

1,000 pages

Concurrent documents

20

10

Moderation engine

Image Moderation 2.0 + Text Moderation 2.0

Content Moderation 1.0 image and text moderation

Detection configurations

Multiple

Single

Console

Query page details; returns page count

Not available

Batch detection (offline moderation)

Not supported

Supported

Billing

Per page (flat rate)

Per image detected + per text entry detected

Features

Document Moderation 2.0 identifies various risk types, offers rich risk tags, and provides flexible configuration features in the console.

Feature

Document Moderation 2.0

Supported document formats

  • Supports common document formats such as DOC, DOCX, PPT, PPTX, PPS, PPSX, PDF, XLS, XLSX, XLTX, XLTM, HTML, and TXT.

  • Allows you to specify a format for files that do not have a file extension.

Document detection limits

  • A document cannot exceed 200 MB in size.

  • A document cannot exceed 1,000 pages.

  • The default concurrency is 20. This means you can process a maximum of 20 documents at the same time.

Moderation capabilities and features

  • Uses the moderation capabilities of Image Moderation and Text Moderation. For more information, see Image Moderation 2.0 and Text Moderation 2.0.

  • Supports text detection in document screenshots.

  • Supports selecting multiple detection configurations to return multiple risk tags.

  • You can query document page details and view the total number of pages in the console.

Billing method

Billed based on the number of pages in a document. For more information, see Billing. For example, a 50-page PDF document costs USD 0.09 to moderate, regardless of the amount of text.

Services

Document Moderation 2.0 provides the following service. Use the service ID when calling the API or SDK.

Service

Service ID

Supported formats

Get started

Standard Document Detection Service (document_detection_global)

Detects non-compliant image or text content in documents, including pornography, sexually suggestive content, politically sensitive content, violent content, and illegal content.

SDK guide · API reference

WORD, PPT, EXCEL, PDF

Standard Document Detection Service_Entering China Edition (document_detection_ec)

Designed for businesses entering the China market. Detects images and text violations in documents, optimized for Chinese context and domestic compliance.

Billing

Pay-as-you-go

Pay-as-you-go is the default billing method for Content Moderation 2.0. There is no charge when the service is not called. Bills are generated once every 24 hours.

Moderation type

Service

Unit price

Billing rule

Standard Document Moderation (file_standard)

Standard Document Detection Service (document_detection_global)

USD 0.09 per call

Each call covers up to 50 pages. Documents with fewer than 50 pages are charged as one call.

Document Moderation Standard Entering China Edition (file_standard_cn)

Standard Document Detection Service (document_detection_ec)

USD 0.035/request/per 50 pages. Documents with fewer than 50 pages are billed as one request.

Note

Billed based on actual usage. For example, moderating a document with no more than 50 pages costs USD 0.035.

How billing is calculated

Each call covers a block of 50 pages. The total number of calls is rounded up to the nearest whole number.

Example

Calculation

Total cost

50-page PDF

50 pages ÷ 50 pages/call = 1 call × USD 0.09

USD 0.09

120-page PDF

120 pages ÷ 50 pages/call = 3 calls × USD 0.09

USD 0.27

10-page PDF

10 pages < 50 pages — billed as 1 call × USD 0.09

USD 0.09

To view billing details, go to Billing Details. In the detailed billing list, moderationType corresponds to the moderation type identifiers shown above.

Note

Document Moderation 1.0 bills based on the actual number of images and text entries detected. For example, moderating a 50-page PDF with 200,000 words costs approximately CNY 0.4945 (file conversion fee + image moderation fee + text moderation fee). Document Moderation 2.0 simplifies this to a flat per-page rate.

Resource plan deduction

For large or predictable moderation volumes, consider purchasing a resource plan in advance. Larger resource plans offer greater discounts, making the unit price lower than the pay-as-you-go rate. For more information, see Purchase Content Moderation 2.0 Resource Plan.

The Content Moderation 2.0 resource plan offsets service usage and is not interchangeable with the resource plan for Content Moderation 1.0. The following table describes the offset factors.

Moderation type

Offset factor

Document Moderation Standard Entering China Edition (file_standard_cn)

116.67: Each successful request deducts 116.67 units from the resource pack capacity.

For example, if the resource pack capacity is 1,000 units, moderating one document (up to 50 pages) deducts 116.67 units, leaving 883.33 units.

After you purchase a resource plan, your usage of the Document Moderation 2.0 API is deducted from the plan first. If the plan has insufficient units to cover the usage, the system automatically bills you on a pay-as-you-go basis. Monitor your resource plan balance and pay-as-you-go bills. You can set up balance alert notifications in the Resource Plan System of the Alibaba Cloud Billing Management console.

Usage notes

Access methods

Access Document Moderation 2.0 using either of the following methods:

Console operations

Configure Document Moderation settings in the User Console before calling the service for the first time.

The console supports:

  • Modifying Document Moderation policies

  • Configuring different policies for different business lines

  • Viewing call results

  • Querying usage statistics

For details, see Console guide.