Technical Documentation and API Q&A for Creator Incentive Settlement: Document Parsing and Chunking

Core data for this category comes from content data, advertising revenue sharing systems, financial systems, and account backends. Four document types

What the data for this category looks like

Core data for this category comes from content data, advertising revenue sharing systems, financial systems, and account backends. Four document types are processed daily: incentive rules, settlement details, appeal records, and payment lists. These documents include structures such as loose clause text, structured tables, and short-text appeal entries. Common fields include creator ID, settlement cycle, revenue sharing ratio, and payment amount. Supported units include yuan, calendar days, and number of users. Data updates follow a monthly schedule or single activity cycle. The scale of settlement documents for a single activity varies based on the count of participating creators.

What constraints do these characteristics impose on document parsing and chunking?

The loose clause structure of incentive rules requires chunking logic to balance long paragraphs and nested entries, preventing associated clauses from being split across different chunks. Structured tables in settlement details must retain field alignment relationships, avoiding broken table structures after parsing. Large monthly summary documents require adaptation to timeout and upload limits for large file processing. Documents from multiple systems have inconsistent formats, so custom parsing logic is needed to support different settlement data formats. Mixed short-text appeal records and long-text rule documents require flexible chunk length adjustment to cover all content types.

Configuration Settings

Configuration ItemRecommended SettingRationale
chunkSize800–1200 charactersAdapts to the average content length of settlement details and appeal records, avoiding excessively long or short single chunks
chunkSplitterMixed newline and chunk lengthBalances the splitting needs of loose clauses and structured tables, preventing incorrect splitting of long paragraphs
customPdfParseEnabledRetains the field structure of settlement tables, avoiding structured data being parsed as plain text
PARSE_FILE_TIMEOUT_SECONDS600 secondsAdapts to the parsing time of monthly settlement summary PDFs over 10MB, avoiding timeout errors
UPLOAD_FILE_MAX_SIZE1000 MBSupports uploading complete monthly settlement summary files in one go, no need for split uploads
chunkSettingModeManual modeAdjusts chunking rules for different document types, adapting to differences between incentive rules and settlement details

Three Common Configuration Mistakes

  • A timeout of 360000ms exceeded error occurs when uploading monthly settlement PDFs over 10MB. The cause is failure to adjust the PARSE_FILE_TIMEOUT_SECONDS parameter; the default timeout duration is insufficient for large file parsing.
  • Custom parsing JS methods do not take effect. The cause is failure to correctly bind custom functions in the customPdfParse configuration, or using a FastGPT version lower than v4.17.0, which does not support custom parsing.
  • Ultra-long settlement detail paragraphs are truncated and lost after chunking. The cause is only splitting documents by a single delimiter, without performing secondary splitting on segments exceeding the chunkSize limit.

How to Confirm Configuration is Complete

  • Upload a test settlement detail PDF, review the parsed chunk results, confirm that table fields are not split chaotically and key data is not lost.
  • Adjust PARSE_FILE_TIMEOUT_SECONDS to 600 seconds, then upload a monthly settlement summary file over 10MB, confirm that no timeout errors occur during parsing.
  • After enabling customPdfParse, upload a document containing appeal records, confirm that the custom parsing logic extracts core fields such as appellant and appeal time as expected.
  • Test the chunkSize configuration set to 800 characters, confirm that long paragraphs are correctly split into segments matching the length, with no content truncation.

The values provided here are common starting points, and should be evaluated against the user's own samples.

Question material comes from public community discussions. Configuration values are common starting points and should be measured against your own samples. Verified on 2026-10-19.