{"success":true,"schema_version":"1.0.0","request_id":"req_2b789a8cc16e4dccb8d8c0a34bbd6d58","timestamp":"2026-11-01T17:40:37.622Z","result":{"id":"F07","name":"recognize_pdf_text","title":"OCR及可搜索PDF","status":"available","phase":"P0","group":"extract","description":"Recognize scanned text and optionally add a searchable text layer. Do not use to guarantee handwriting accuracy or to bypass password protection. Inputs: 1–1 immutable authorized files and the typed parameters below. Returns an asynchronous job, not the final PDF. Poll get_pdf_job, then read artifacts and the receipt. The operation creates stored outputs and may incur charges; specify a cost ceiling. 首发en/zh-Hans/zh-Hant模型以实测启用；force可能破坏原文字层，先报价；不默认栅格化矢量页。","rest":{"method":"POST","path":"/api/v1/pdf/ocr"},"required_scopes":["jobs:create","files:read","pdf:extract"],"engine":"container","rest_input_schema":{"type":"object","properties":{"file_ids":{"type":"array","description":"Ordered authorized immutable inputs","items":{"type":"string","description":"Authorized immutable file ID.","pattern":"^fil_[A-Za-z0-9_-]+$"},"minItems":1,"maxItems":1},"parameters":{"type":"object","properties":{"pages":{"type":"array","description":"One-based page numbers; omitted means all pages.","items":{"type":"integer","description":"Page number","minimum":1},"minItems":1,"maxItems":2000},"languages":{"type":"array","description":"Explicit language codes; query capability for installed models","items":{"type":"string","description":"Language code"},"minItems":1,"maxItems":8},"mode":{"type":"string","description":"Existing text handling","enum":["missing_text_only","force"],"default":"missing_text_only"},"deskew":{"type":"boolean","description":"Deskew scanned pages","default":true},"output_searchable_pdf":{"type":"boolean","description":"Produce a searchable PDF","default":true}},"required":["languages"],"additionalProperties":false},"execution":{"$ref":"#/components/schemas/Execution"},"client_task_id":{"type":"string","description":"Caller correlation, not an authorization token","maxLength":128}},"required":["file_ids","parameters","execution"],"additionalProperties":false},"input_schema":{"type":"object","properties":{"file_ids":{"type":"array","description":"Ordered authorized immutable inputs","items":{"type":"string","description":"Authorized immutable file ID.","pattern":"^fil_[A-Za-z0-9_-]+$"},"minItems":1,"maxItems":1},"parameters":{"type":"object","properties":{"pages":{"type":"array","description":"One-based page numbers; omitted means all pages.","items":{"type":"integer","description":"Page number","minimum":1},"minItems":1,"maxItems":2000},"languages":{"type":"array","description":"Explicit language codes; query capability for installed models","items":{"type":"string","description":"Language code"},"minItems":1,"maxItems":8},"mode":{"type":"string","description":"Existing text handling","enum":["missing_text_only","force"],"default":"missing_text_only"},"deskew":{"type":"boolean","description":"Deskew scanned pages","default":true},"output_searchable_pdf":{"type":"boolean","description":"Produce a searchable PDF","default":true}},"required":["languages"],"additionalProperties":false},"execution":{"$ref":"#/components/schemas/Execution"},"client_task_id":{"type":"string","description":"Caller correlation, not an authorization token","maxLength":128},"idempotency_key":{"type":"string","description":"Required project/operation scoped deduplication key shared with REST Idempotency-Key","minLength":8,"maxLength":128}},"required":["file_ids","parameters","execution","idempotency_key"],"additionalProperties":false},"output_schema":{"type":"object","properties":{"success":{"const":true},"schema_version":{"const":"1.0.0"},"request_id":{"type":"string","description":"Request ID"},"timestamp":{"type":"string","description":"Server response time","format":"date-time"},"result":{"$ref":"#/components/schemas/Job"},"sources":{"type":"array","description":"Input provenance","items":{"$ref":"#/components/schemas/Source"},"minItems":0,"maxItems":100},"cache":{"type":"object","properties":{"hit":{"type":"boolean"},"age_seconds":{"type":"integer","description":"Cache age","minimum":0}},"required":["hit","age_seconds"],"additionalProperties":false},"next_actions":{"type":"array","description":"Non-executing suggestions","items":{"type":"object","properties":{"tool":{"type":"string","description":"Tool name"},"arguments":{"type":"object"},"reason":{"type":"string","description":"Reason"},"required_scopes":{"type":"array","description":"Scopes still enforced","items":{"type":"string","description":"Scope"},"minItems":0,"maxItems":20},"requires_confirmation":{"type":"boolean"}},"required":["tool","arguments","reason","required_scopes","requires_confirmation"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["success","schema_version","request_id","timestamp","result","sources","next_actions"],"additionalProperties":false},"result_artifact_types":["ocr.jsonl","searchable.pdf"],"limits_and_semantics":"首发en/zh-Hans/zh-Hant模型以实测启用；force可能破坏原文字层，先报价；不默认栅格化矢量页。","acceptance":"扫描/混合/旋转页样本测试；OCR正文有坐标；文本层不重叠重复。","mcp_annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"idempotency":"REST Idempotency-Key / MCP idempotency_key required; shared project/operation deduplication for at least 24h.","doc_url":"/api/v1/capabilities/recognize_pdf_text","accepted_input_media_types":["application/pdf"],"accepted_file_states":["ready"],"availability_reason":"Cloudflare Container adapter enabled"},"sources":[],"cache":{"hit":false,"age_seconds":0},"next_actions":[]}