只有在你已有需要迁移的 v1 代码时才需要这一页。 新用户请跳过，直接看快速上手 —— 你只需要学 v2。

v2 用结构化 JSON 取代了 v1 那 70 多个平铺的表单参数。最大的三点变化是：tier 与 version 现在必填、多数参数挪进了嵌套的选项分组，以及页索引改为从 1 开始。

v2 每个选项该放在哪里，见配置 Parse；逐字段的完整参考见 API 参考。

速查清单

• POST /api/v1/parsing/upload → POST /api/v2/parse（multipart 则用 /parse/upload）
• parse_mode → tier（fast、cost_effective、agentic、agentic_plus）
• parsing_instruction / system_prompt 挪到 agentic_options.custom_prompt
• language 挪到 processing_options.ocr_parameters.languages
• invalidate_cache + do_not_cache 合并为单个 disable_cache 布尔值
• webhook_url（字符串）→ webhook_configurations（数组，按事件类型通知）
• target_pages 的页索引从 0 基改为 1 基
• bounding_box → crop_box
• 去掉 model（由档位自动选）、gpt4o_mode、premium_mode、fast_mode、azure_openai_*、vendor_multimodal_*
• high_res_ocr 与 precise_bounding_box 在 v2 中始终开启。

参数对照

基础选项

v1	v2	备注
input_url	source_url	改名
max_pages	page_ranges.max_pages	相同
target_pages	page_ranges.target_pages	页索引从 1 开始
invalidate_cache / do_not_cache	disable_cache	合并为一个
language	processing_options.ocr_parameters.languages	相同

档位与模型

v1	v2	备注
parse_mode	tier	按档位的体系
model	Auto-selected	依档位自动选择
parsing_instruction	agentic_options.custom_prompt	cost_effective/agentic/agentic_plus only
formatting_instruction / system_prompt / user_prompt	agentic_options.custom_prompt	合并为一个

裁剪框

v1	v2
bbox_top/bottom/left/right	crop_box.top/bottom/left/right

输入格式选项

v1	v2
html_make_all_elements_visible	input_options.html.make_all_elements_visible
html_remove_fixed_elements	input_options.html.remove_fixed_elements
html_remove_navigation_elements	input_options.html.remove_navigation_elements
spreadsheet_extract_sub_tables	input_options.spreadsheet.detect_sub_tables_in_sheets
presentation_out_of_bounds_content	input_options.presentation.out_of_bounds_content

处理选项

v1	v2
aggressive_table_extraction	processing_options.aggressive_table_extraction
outlined_table_extraction + adaptive_long_table	processing_options.disable_heuristics（语义相反）
specialized_chart_parsing_*	processing_options.specialized_chart_parsing: "efficient"/"agentic"/"agentic_plus"
skip_diagonal_text	processing_options.ignore.ignore_diagonal_text
disable_ocr	processing_options.ignore.ignore_text_in_image
remove_hidden_text	processing_options.ignore.ignore_hidden_text

如果你过去用 skip_diagonal_text 来去掉水印，v2 有了专门的选项：output_options.watermark_handling: "remove"（版本 2026-09-28 或更高）。它对扫描页同样有效，而且不像 skip_diagonal_text 那样会把 PDF 文本层里所有旋转文字一并丢掉。见水印。

输出选项

v1	v2
annotate_links	output_options.markdown.annotate_links
annotate_revisions	output_options.markdown.annotate_revisions
compact_markdown_table	output_options.markdown.tables.compact_markdown_tables
output_tables_as_HTML	output_options.markdown.tables.output_tables_as_markdown（语义相反）
merge_tables_across_pages_in_markdown	output_options.markdown.tables.merge_continued_tables
save_images / take_screenshot	output_options.images_to_save (array: "screenshot", "embedded", "layout")
extract_printed_page_number	output_options.extract_printed_page_number

处理控制

v1	v2
job_timeout_in_seconds	processing_control.timeouts.base_in_seconds
job_timeout_extra_time_per_page_in_seconds	processing_control.timeouts.extra_time_per_page_in_seconds
page_error_tolerance	processing_control.job_failure_conditions.allowed_page_failure_ratio
strict_mode_image_extraction	processing_control.job_failure_conditions.fail_on_image_extraction_error
strict_mode_image_ocr	processing_control.job_failure_conditions.fail_on_image_ocr_error
strict_mode_reconstruction	processing_control.job_failure_conditions.fail_on_markdown_reconstruction_error
strict_mode_buggy_font	processing_control.job_failure_conditions.fail_on_buggy_font

v2 中已移除

gpt4o_mode、gpt4o_api_key、premium_mode、fast_mode、continuous_mode、vendor_multimodal_api_key、azure_openai_*、disable_image_extraction、hide_headers、hide_footers、page_header_prefix、page_footer_prefix、page_prefix、page_separator、input_s3_path、output_s3_path_prefix、extract_layout。

v1 端点在可预见的未来仍然可用，但新功能只提供 v2 版本。

另请参阅

• 快速上手 —— 新用户应读这页而不是本页
• 配置 Parse —— v2 各选项的位置
• REST API 指南 —— 端点总览与响应形态
• 档位 —— v2 的四个档位与版本固定。