2026-08-17
API
Billing Enabled for the Extract Specific Fields API
- The Extract Specific Fields API (
POST /api/app-api/sip/platform/v2/file/extract_fields) is now billed per page: each call is billed independently based on the number of pages of the task’s document, at the “other file types” rate (0.3 RMB/page) regardless of file type. - Billing occurs only when the extraction result is returned successfully; failed requests, failed extractions, or requests without any fields to extract are not billed.
- When the account balance is insufficient, the API returns error code
1005025075(insufficient quota or billing check failed). - See Product Pricing for details.
File Results and Translation Enhancements
- Added
/api/app-api/sip/platform/v2/file/translateto translate recognized regular fields, tables, stamps, and handwriting by task. Languages use ISO 639-1 codes; omittingsource_languageor sending an empty string enables automatic source-language detection. - Added the optional
task_idquery parameter to/api/app-api/sip/platform/v2/file/fetchfor exact lookup using a string task ID. - Added the optional
with_image_urlparameter to/api/app-api/sip/platform/v2/file/fetch. When set totrue, page data for regular, document-split, and image-crop tasks includes the correspondingimage_urltogether withangle,width, andheight. Image URLs are valid for 30 days. - When translations are available,
/api/app-api/sip/platform/v2/file/fetchreturns the correspondingtranslated_*fields in field, table, stamp, and handwriting objects. Existing response fields remain compatible. - Tokens returned by
/api/app-api/sip/platform/v2/auth/tokenare valid for 1 day.
Category Keyword Rules
- Create File Category and Update File Category now support
category_keyword_rules. Positive rules match a category, while negative rules filter it out. - List File Categories now returns
category_keyword_ruleswhen configured. - A rule group matches when at least
min_hitkeywords match. Positive groups are combined with OR, and a matching negative group excludes the category. Each category supports up to 10 positive groups and 1 negative group, with up to 20 keywords per group. - On creation, omit the parameter or pass two empty arrays to leave rules unconfigured. On update, omit it or pass
nullfor no change, pass two empty arrays to clear the rules, or pass another valid object to replace all rules. - Keywords preserve their original case and whitespace. Duplicates within a group, positive/negative conflicts, and cross-category same-type rule-group conflicts are compared using the original keyword strings; whitespace is no longer removed and case is no longer normalized.
SDK
- Python SDK
1.1.2adds category keyword-rule support for create, update, response parsing, and conflict prechecks. Keywords are validated and sent unchanged.
2026-07-08
API
Intelligent Review Model Update
-
Submit Review Task
-
Body: The available values of the
modelparameter are updated todeepseek-v4-pro,qwen3.6-plus,qwen3.7-max, andORM-O1. Starting July 8, 2026, the following legacy models were deprecated. Use the corresponding replacement model: -
Response: Added the
modelfield, which returns the model actually used for the review task.
-
Body: The available values of the
-
Get Review Task Result statistics now include
not_triggered_count, which returns the number of review rules that were not triggered.
2026-07-05
API
Extraction Model Upgrade
The extraction models have been uniformly renamed, and a new Auto intelligent routing option has been added. This affects all endpoints that containextract_model (Create File Category, Update File Category, adding and updating file category fields/tables, Extract Fields, Get File Results).
- The request parameter
extract_modelonly accepts the new model names (Auto/Acgpt/Acgpt-VL/DF-M1); the old valuesModel 1/Model 2/Model 3and the legacy code valuesllm/vlmare no longer supported. - In the Get File Results and Extract Fields responses, fields and tables now include
configModel(the configured model, which may beAuto;nullfor legacy data that was not configured); the originalextractModelsemantics have been adjusted to “actual hit model” (valuesAcgpt/Acgpt-VL/DF-M1). - A new extraction failure reason “Exceeded Acgpt-VL processing limit” has been added (
Acgpt-VLhas a document-level processing cap, surfaced when e.g. the page count exceeds the limit). - The extraction model
Acgpt-VLdoes not currently support table multi-table merging (collect_from_multi_table).
2026-06-02
API
Primary Endpoints Upgrade
Process multiple objects in a single request. All endpoints use all-or-nothing semantics — if any item fails validation, the entire batch is rejected.Deprecated Endpoints
The following single-item endpoints are now marked asdeprecated. They remain functional but will no longer be maintained. Please migrate to the primary endpoints above:
One-Step Category Creation
Create File Category now accepts atables parameter — configure tables and their fields in a single call when creating a category.
Field Advanced Config
Update File Category Field (single + batch) now support these properties:Enriched Responses
Get full config without extra queries:- Get File Category Field List — added
enabled,prompt,use_prompt,extract_model,alias,identity,multi_value,duplicate_value_distinct,transform_settings - Get File Category Table List — added
prompt,collect_from_multi_table,extract_model - List File Categories — added
category_prompt,extract_model - with_detail flag — pass
with_detail=trueon create/update to get the complete object in the response
SDK
- Python SDK
fields.update()andfields.batch_update()— added advanced config parameters and clear semantics examples
2026-05-27
API- Updated: Upload File, Upload File Synchronously endpoints now support
parser_parse_modeparameter for specifying parse mode (auto/scan/VLM) - Updated: Upload File, Upload File Synchronously endpoints now support
parser_pdf_pwdparameter for decrypting encrypted PDF files - Updated: Get File Processing Result List response now includes
parser_paramsfield showing file parsing parameter configuration
2026-05-06
Guides- Updated: Expense Reimbursement (From Scratch), AP Review (From Scratch), Contract Review (From Scratch) — improved review rule risk level indicators and descriptions
- Added: Changelog page
2026-04-30
Guides- Updated: Expense Reimbursement (From Scratch), Expense Reimbursement (Pre-configured), AP Review (From Scratch), AP Review (Pre-configured), Contract Review (From Scratch), Contract Review (Pre-configured) — added synchronous upload Upload File Synchronously code examples (Python + Java) to the upload step, with comparison between async and sync modes
- Updated: Example code files (
expense_reimbursement.py,contract_review.py,ap_review.pyand their_configuredvariants) now includeupload_file_syncfunction
2026-04-16
API- Updated: Review API upgraded to v2.1 — improved schema definitions for Submit Review Task, Get Review Task Result and related APIs
2026-04-15
API- Updated: Upload File, Upload File Synchronously, Retry File Processing endpoints now support
parser_dpiparameter for custom document parsing resolution
2026-04-14
Guides- Updated: File Format Support, Upload by URLs — file upload size limit increased from 50MB to 100MB
- Updated: Upload File, Upload File Synchronously max file size adjusted to 100MB
2026-04-12
Guides- Added: Entity Extraction vs Docflow — Atomic Capability: Entity Extraction, with comparison to Docflow extraction workflow
- Added: Document Parse vs Docflow — Atomic Capability: Document Parse, with comparison to Docflow parse workflow
2026-04-08
SDK- Added: Python SDK documentation
2026-04-07
Guides- Updated: All 6 scenario guides (Expense Reimbursement, AP Review, Contract Review and their pre-configured versions) with improved titles, descriptions, and sample file references
- Added: Java example code (
ApReview.java,ContractReview.java, etc. — 6 files) and corresponding sample documents
2026-04-03
Guides- Added: AP Review (From Scratch) — with Python/Java examples
- Added: AP Review (Pre-configured)
- Added: Contract Review (From Scratch) — with Python/Java examples
- Added: Contract Review (Pre-configured)
- Added: Expense Reimbursement (Pre-configured)
- Added:
entity_extraction.py— standalone Entity Extraction API example
- Updated: Workspace management endpoints no longer require
enterprise_idparameter
2026-04-01
API- API documentation upgraded to v2.4.0
- Added (EN): Complete workspace management and category management REST API endpoints
- Added: Amend File Category, Get File Category Tables List, Add File Category Table, Update File Category Table, Delete File Category Tables endpoints
2026-03-24
Guides- Added: Expense Reimbursement (From Scratch) — with flow diagrams and Python/Java examples
- Updated: Quick Start
2026-03-12
Guides- Added: Workspace Management - Quickstart
- Added: Category Management - Quickstart
- Added: Fields Management
- Added: Tables Management
- Added: Samples Management
- API documentation upgraded to v2.3.0
- Added endpoints: Update File Processing Result, Extract Specific Fields, Retry File Processing, Generate a Short-Lived Token, workspace CRUD, category CRUD, Get File Category Tables List, Add File Category Table, Update File Category Table, Delete File Category Tables
- Added review endpoints: Review Rule Repository, Review Rule Group, Review Rule, Review Task
2026-03-02
API- API documentation upgraded to v2.2.0
- Added endpoints: Create Workspace, Create File Category, Add File Category Field
2026-02-03
Guides- Added: 前端 iframe 嵌入
2026-01-28
API- Added workspace management endpoints: Create Workspace, Get Workspace List, Get Workspace Details, Update Workspace, Delete Workspace
- Added category management endpoints: Create File Category, Update File Category, Delete File Category, Upload Category Sample, Get Category Samples List, Download Category Sample
- Added category field management endpoints: Add File Category Field, Update File Category Field, Delete File Category Fields
2026-01-27
Guides- Added: OpenAPI File Download
2026-01-21
API- Updated: Generate a Short-Lived Token endpoint now supports expiration time configuration
- Updated: Get File Processing Result List response now includes
total_page_numfield
2025-12-25
Guides- Updated: Create Review Task — added
batch_numberparameter documentation
- Updated: Submit Review Task now accepts
batch_numberparameter - Updated: Upload File, Upload File Synchronously, Retry File Processing endpoints now support image processing parameters (
parser_remove_watermark,parser_crop_dewarp, etc.)
2025-12-24
Guides- Added: Rule Repository Management — CRUD for rule repos, rule groups, and rules
- Added: Create Review Task
- Added: Get Review Results
- Added: Retry Review Task
- Updated: Review - Quick Start
- Added endpoints: Get Review Rule Repository List, Get Review Rule Repository, Retry Review Task, Retry Specific Rule in Review Task
- Removed: Legacy review API
2025-12-19
Guides- Added: Synchronous Upload
- Added endpoint: Upload File Synchronously
- Added endpoints: Get Workspace File Category List, Get File Category Fields List
- Added review rule repo endpoints: Create Review Rule Repository, Delete Review Rule Repository, Update Review Rule Repository
2025-12-17
Guides- Added: Extract Specific Fields
- Updated: Extract - Quick Start
- Added endpoint: Extract Specific Fields
- Removed: Legacy review API endpoints
2025-12-11
Guides- Added: Enterprise Multi-Tenant
- Added: How to Get Enterprise ID
2025-12-08
Guides- Added: File Retry - Quick Start
- Added endpoint: Retry File Processing
2025-11-12
API- Updated: Get File Processing Result List response now includes export field name (
export_name)
2025-11-04
Guides- Added: Amend File Category
- Added: Amend File Category (File Split)
- Added: Amend File Category (Multi-Image Crop)
- Added endpoint: Amend File Category
2025-10-27
Guides- Added: Upload by URLs
- Added: Task Status Query — including failure reasons and duration
- Updated: Response JSON Structure — added
task_idfield documentation
- Updated: Upload File now supports URL-based upload (
urlsrequest body) - Updated: Upload File response now includes
task_idfield - Updated: Get File Processing Result List response now includes
failure_causesandduration_msfields - Updated: Get File Processing Result List table coordinate structure unified with fields and items
2025-10-16
Guides- Added: File Deletion - Quick Start
- Added endpoint: Delete Tasks
2025-09-01 ~ 2025-09-05
Guides- Added: Full English documentation launched (25+ pages covering Product Introduction, Upload, Parse, Classify, Split, Extract, Review, FAQ)
- Updated: Multi-Image Cropping — split results now include page number and rotation angle for cropped images
- Added: English OpenAPI specification
2025-08-26 ~ 2025-08-28
Guides- Added: Classification - Quick Start
- Added: Classification Only
- Added: Specify Classification Upload
- Added: Split - Quick Start
- Added: File Splitting
- Added: Multi-Image Cropping
- Added: Extract - Quick Start
- Added: Basic Field Information
- Added: Table Field Information
- Added: Stamp Information
- Added: Handwriting Information
- Added: Coordinate System
- Added: FAQ pages — How to Get Workspace ID, How to Configure File Categories, Chinese Category Parameter Issues, Product Pricing
2025-08-14
Guides- Added: Document Parse - Quick Start
- Added: Parsing Result Visualization
- Added: Response JSON Structure
2025-08-13
Guides- DocFlow API documentation site launched:
- Initial API documentation published with Upload File and Get File Processing Result List endpoints
2025-07-09
API- Fixed: Table and stamp result field definitions
2025-05-20 ~ 2025-05-21
API- Updated: Upload File now supports
split_flag(file split) andcrop_flag(multi-image crop) parameters - Updated: Upload File now supports
auto_verify_vat(automatic VAT invoice verification) parameter - Updated: Upload File now supports
target_processparameter for pipeline control (classify-only / classify+extract) - Updated: Get File Processing Result List response now supports sub-tasks and sub-image coordinates
2025-05-07 ~ 2025-05-12
API- Added APIs (legacy): Submit Review Task, Update Review Rule,
runRule— Review API
2025-04-15
API- Updated: Get Workspace File Category List endpoint added
enabledfilter parameter - Added: Get File Processing Result List API documentation
- Fixed: Stamp, handwriting, and table field definitions
2025-02-18
API- Added endpoints: Create Workspace, Get Workspace List, Get Workspace Details, Update Workspace, Delete Workspace — Workspace management
- Updated: Get File Processing Result List response now includes
task_idfield
2025-01-02 ~ 2025-01-03
API- Added endpoint: Update File Processing Result — Update file extraction results with batch update support
- Updated: Get File Processing Result List field extraction results now include
positioncoordinate information
2024-12-20 ~ 2024-12-23
API- DocFlow API initial release
- Upload File endpoint uses
multipart/form-dataformat with multi-file upload support - Authentication signature examples (Python)

