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 |
Version comparison
Compared to Document Moderation 1.0, Document Moderation 2.0 offers more risk types and richer risk tags. It also provides more comprehensive and flexible configuration features in the console.
Item | Document Moderation 2.0 | Document Moderation 1.0 |
Supported document formats |
|
|
Document detection limits |
|
|
Moderation capabilities and features |
|
|
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 CNY 0.225 to moderate, regardless of the amount of text. | Billed based on the actual number of images and amount of text moderated. For example, the cost to moderate a 50-page PDF document that contains 200,000 characters is the sum of the image and text moderation fees:
Total: (CNY 0.08 + CNY 0.3425) + CNY 0.072 = CNY 0.4945 |
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) | Detects non-compliant image or text content in documents, including pornography, sexually suggestive content, politically sensitive content, violent or terrorist content, and illegal content. | WORD, PPT, EXCEL, PDF | |
Standard Document Detection Service for Overseas (document_detection_cb) | Detects non-compliant image or text content in documents, including pornography, sexually suggestive content, politically sensitive content, violent or terrorist content, and illegal content. | ||
Standard Document Detection Service (Large Model Version) (document_detection_byvl) | This service detects non-compliant image or text content in documents, including pornography, sexually suggestive content, politically sensitive content, violent or terrorist content, and illegal content, by using a large model for image moderation. |
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 hour.
Moderation type | Service | Unit price | Billing rule |
Standard Document Moderation (file_standard) | Standard Document Detection Service: document_detection | CNY 0.225 per 50 pages. A document with fewer than 50 pages is counted as one 50-page block. | |
Advanced Document Moderation (file_advanced) |
| CNY 0.375 per 50 pages. A document with fewer than 50 pages is counted as one 50-page block. |
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.
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 |
Standard Document Moderation (file_standard) | 300: Each successful API call for this service consumes 300 units from your resource plan. For example, if you purchase a resource plan with 1,000 units and you moderate a document of up to 50 pages, 300 units are consumed. 700 units remain. |
Advanced Document Moderation (file_advanced) | 500: Each successful API call for this service consumes 500 units from your resource plan. For example, if you purchase a resource plan with 1,000 units and you moderate a document of up to 50 pages, 500 units are consumed. 500 units remain. |
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:
SDK — See Document Moderation 2.0 SDK and integration guide.
API — See Document Moderation 2.0 API.
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.