{"openapi":"3.1.0","x-pricing":{"currency":"USDC","formula":"ceil_micro_USDC(max(minimum, variable_cost * multiplier))","cost_basis":"conservative_estimate","multiplier":3,"minimum_usdc":0.01,"model_version":"9ed6983bfe088bc1","description":"Cost-based prepaid tiers. Exact invoice cost is reconciled separately; no later surcharge. No language or geography surcharge.","tiers":{"simple":"Up to 5,000 normalized JSON characters and 100 spreadsheet cells.","standard":"Up to 25,000 normalized JSON characters and 2,000 spreadsheet cells.","complex":"Larger documents within the service limits."},"formats":{"docx":{"simple":{"tier":"simple","format":"docx","amount":"0.018146","currency":"USDC","model_version":"9ed6983bfe088bc1","cost_basis":"conservative_estimate","estimated_variable_cost_usd":0.006048428657777777,"components_usd":{"llm":0,"search_api":0,"browser_rendering":0,"payment_provider":0.001,"cpu":0.000096,"memory":0.00017077777777777778,"invocations":0.0000042,"edge_requests":0.000022400000000000002,"database_compute":0.004416666666666666,"storage":0.000007645866666666667,"history":0.000007645866666666667,"database_transfer":0.00004096,"delivery":0.00028213248,"other":0},"multiplier":3,"minimum_usdc":0.01},"standard":{"tier":"standard","format":"docx","amount":"0.019490","currency":"USDC","model_version":"9ed6983bfe088bc1","cost_basis":"conservative_estimate","estimated_variable_cost_usd":0.006496666595555554,"components_usd":{"llm":0,"search_api":0,"browser_rendering":0,"payment_provider":0.001,"cpu":0.00023822222222222224,"memory":0.00019433333333333333,"invocations":0.0000042,"edge_requests":0.000022400000000000002,"database_compute":0.004416666666666666,"storage":0.000012233386666666665,"history":0.00002599594666666667,"database_transfer":0.00013926400000000003,"delivery":0.00044335104000000003,"other":0},"multiplier":3,"minimum_usdc":0.01},"complex":{"tier":"complex","format":"docx","amount":"0.023999","currency":"USDC","model_version":"9ed6983bfe088bc1","cost_basis":"conservative_estimate","estimated_variable_cost_usd":0.007999507235555555,"components_usd":{"llm":0,"search_api":0,"browser_rendering":0,"payment_provider":0.001,"cpu":0.0005582222222222222,"memory":0.00024733333333333335,"invocations":0.0000042,"edge_requests":0.000022400000000000002,"database_compute":0.004416666666666666,"storage":0.00003058346666666666,"history":0.00009939626666666668,"database_transfer":0.00053248,"delivery":0.00108822528,"other":0},"multiplier":3,"minimum_usdc":0.01}},"xlsx":{"simple":{"tier":"simple","format":"xlsx","amount":"0.018146","currency":"USDC","model_version":"9ed6983bfe088bc1","cost_basis":"conservative_estimate","estimated_variable_cost_usd":0.006048428657777777,"components_usd":{"llm":0,"search_api":0,"browser_rendering":0,"payment_provider":0.001,"cpu":0.000096,"memory":0.00017077777777777778,"invocations":0.0000042,"edge_requests":0.000022400000000000002,"database_compute":0.004416666666666666,"storage":0.000007645866666666667,"history":0.000007645866666666667,"database_transfer":0.00004096,"delivery":0.00028213248,"other":0},"multiplier":3,"minimum_usdc":0.01},"standard":{"tier":"standard","format":"xlsx","amount":"0.019366","currency":"USDC","model_version":"9ed6983bfe088bc1","cost_basis":"conservative_estimate","estimated_variable_cost_usd":0.006455222151111111,"components_usd":{"llm":0,"search_api":0,"browser_rendering":0,"payment_provider":0.001,"cpu":0.00020266666666666667,"memory":0.00018844444444444445,"invocations":0.0000042,"edge_requests":0.000022400000000000002,"database_compute":0.004416666666666666,"storage":0.000012233386666666665,"history":0.00002599594666666667,"database_transfer":0.00013926400000000003,"delivery":0.00044335104000000003,"other":0},"multiplier":3,"minimum_usdc":0.01},"complex":{"tier":"complex","format":"xlsx","amount":"0.028145","currency":"USDC","model_version":"9ed6983bfe088bc1","cost_basis":"conservative_estimate","estimated_variable_cost_usd":0.009381628088888889,"components_usd":{"llm":0,"search_api":0,"browser_rendering":0,"payment_provider":0.001,"cpu":0.0004515555555555556,"memory":0.00022966666666666667,"invocations":0.0000042,"edge_requests":0.000022400000000000002,"database_compute":0.004416666666666666,"storage":0.00005505024,"history":0.00019726336000000004,"database_transfer":0.001056768,"delivery":0.0019480576,"other":0},"multiplier":3,"minimum_usdc":0.01}},"pdf":{"simple":{"tier":"simple","format":"pdf","amount":"0.020496","currency":"USDC","model_version":"9ed6983bfe088bc1","cost_basis":"conservative_estimate","estimated_variable_cost_usd":0.006831835697777777,"components_usd":{"llm":0,"search_api":0,"browser_rendering":0,"payment_provider":0.001,"cpu":0.00020266666666666667,"memory":0.00018844444444444445,"invocations":0.0000042,"edge_requests":0.000022400000000000002,"database_compute":0.004416666666666666,"storage":0.000018350079999999998,"history":0.00005046272,"database_transfer":0.000270336,"delivery":0.00065830912,"other":0},"multiplier":3,"minimum_usdc":0.01},"standard":{"tier":"standard","format":"pdf","amount":"0.023999","currency":"USDC","model_version":"9ed6983bfe088bc1","cost_basis":"conservative_estimate","estimated_variable_cost_usd":0.007999507235555555,"components_usd":{"llm":0,"search_api":0,"browser_rendering":0,"payment_provider":0.001,"cpu":0.0005582222222222222,"memory":0.00024733333333333335,"invocations":0.0000042,"edge_requests":0.000022400000000000002,"database_compute":0.004416666666666666,"storage":0.00003058346666666666,"history":0.00009939626666666668,"database_transfer":0.00053248,"delivery":0.00108822528,"other":0},"multiplier":3,"minimum_usdc":0.01},"complex":{"tier":"complex","format":"pdf","amount":"0.041287","currency":"USDC","model_version":"9ed6983bfe088bc1","cost_basis":"conservative_estimate","estimated_variable_cost_usd":0.013762203128888888,"components_usd":{"llm":0,"search_api":0,"browser_rendering":0,"payment_provider":0.001,"cpu":0.001624888888888889,"memory":0.000424,"invocations":0.0000042,"edge_requests":0.000022400000000000002,"database_compute":0.004416666666666666,"storage":0.00010398378666666665,"history":0.0003929975466666667,"database_transfer":0.002105344,"delivery":0.0036677222399999995,"other":0},"multiplier":3,"minimum_usdc":0.01}}}},"info":{"title":"Agent Documents","version":"1.0.0","description":"Project 4. Generate supplied content into validated DOCX, XLSX or PDF. Unicode is preserved. No translation/model calls. See /docs for limits, retention and payment recovery."},"servers":[{"url":"https://agentdocuments.online"}],"paths":{"/api/v1/documents":{"post":{"operationId":"createDocument","summary":"Generate a document with x402 USDC payment","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Secret randomly generated key, 32–128 URL-safe characters; also the retrieval Bearer credential. Reuse on retry.","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"Base64 x402 v2 PaymentPayload from the 402 challenge.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentInput"},"example":{"format":"docx","title":"Quarterly update","filename":"quarterly-update","content":{"markdown":"# Results\n\nRevenue grew **12%**.\n\n| Region | Status |\n| --- | --- |\n| 東京 | Ready |\n| München | Ready |"}}}}},"responses":{"200":{"description":"Validated, stored and settled document.","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"Base64 settlement response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"202":{"description":"In progress or settlement unknown. Poll using original key; never pay again.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pending"}}}},"400":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 v2 PaymentRequired plus pricing. Retry identical request after signing.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 PaymentRequired.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","accepts"],"properties":{"x402Version":{"const":2},"accepts":{"type":"array","items":{"type":"object"}},"mode":{"enum":["demo","live"]},"pricing":{"type":"object","description":"Prepaid cost-based tier quote; same model as x-pricing and /api/v1/formats.","example":{"tier":"simple","format":"docx","amount":"0.018146","currency":"USDC","model_version":"9ed6983bfe088bc1","cost_basis":"conservative_estimate","estimated_variable_cost_usd":0.006048428657777777,"components_usd":{"llm":0,"search_api":0,"browser_rendering":0,"payment_provider":0.001,"cpu":0.000096,"memory":0.00017077777777777778,"invocations":0.0000042,"edge_requests":0.000022400000000000002,"database_compute":0.004416666666666666,"storage":0.000007645866666666667,"history":0.000007645866666666667,"database_transfer":0.00004096,"delivery":0.00028213248,"other":0},"multiplier":3,"minimum_usdc":0.01}}}}}}},"409":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/documents/{id}":{"get":{"operationId":"getDocument","security":[{"documentKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Document metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"202":{"description":"Pending or settlement unknown"},"404":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/documents/{id}/download":{"get":{"operationId":"downloadDocument","security":[{"documentKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Actual file bytes; Content-Disposition includes Unicode filename.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/vnd.openxmlformats-officedocument.wordprocessingml.document":{"schema":{"type":"string","format":"binary"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"202":{"description":"Not ready yet"},"404":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Machine-readable error. See code for handling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/formats":{"get":{"operationId":"getFormats","responses":{"200":{"description":"Formats, templates, pricing and limits"}}}},"/api/v1/health":{"get":{"operationId":"getHealth","responses":{"200":{"description":"Configured and database ready"},"503":{"description":"Not configured or unavailable"}}}}},"components":{"securitySchemes":{"documentKey":{"type":"http","scheme":"bearer","description":"The original secret Idempotency-Key. No cookies or user session."}},"schemas":{"DocumentInput":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"format":{"type":"string","enum":["docx","xlsx","pdf"]},"title":{"default":"Untitled document","type":"string","maxLength":200},"filename":{"default":"document","type":"string","maxLength":200},"content":{"anyOf":[{"type":"string","maxLength":100000},{"type":"object","properties":{"markdown":{"type":"string","maxLength":100000}},"required":["markdown"],"additionalProperties":false},{"type":"object","properties":{"blocks":{"minItems":1,"maxItems":1000,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"heading"},"level":{"default":1,"type":"integer","minimum":1,"maximum":3},"text":{"anyOf":[{"type":"string","maxLength":100000},{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","maxLength":100000},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"href":{"type":"string","maxLength":100000}},"required":["text"],"additionalProperties":false}}]}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"paragraph"},"text":{"anyOf":[{"type":"string","maxLength":100000},{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","maxLength":100000},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"href":{"type":"string","maxLength":100000}},"required":["text"],"additionalProperties":false}}]}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"list"},"ordered":{"default":false,"type":"boolean"},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"anyOf":[{"type":"string","maxLength":100000},{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","maxLength":100000},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"href":{"type":"string","maxLength":100000}},"required":["text"],"additionalProperties":false}}]}}},"required":["type","items"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"table"},"columns":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","maxLength":200}},"rows":{"maxItems":500,"type":"array","items":{"maxItems":12,"type":"array","items":{"anyOf":[{"type":"string","maxLength":4000},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},"required":["date"],"additionalProperties":false}]}}}},"required":["type","columns","rows"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"page_break"}},"required":["type"],"additionalProperties":false}]}}},"required":["blocks"],"additionalProperties":false}]},"sheets":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":31},"columns":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","maxLength":200}},"rows":{"maxItems":2000,"type":"array","items":{"maxItems":100,"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string","maxLength":4000},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},"required":["date"],"additionalProperties":false}]},{"type":"object","properties":{"formula":{"type":"string","minLength":1,"maxLength":2000}},"required":["formula"],"additionalProperties":false}]}}}},"required":["name","columns","rows"],"additionalProperties":false}},"metadata":{"default":{},"type":"object","properties":{"author":{"type":"string","maxLength":200},"subject":{"type":"string","maxLength":500},"language":{"type":"string","maxLength":50}},"additionalProperties":false},"options":{"default":{"template":"standard","page_size":"A4"},"type":"object","properties":{"template":{"default":"standard","type":"string","enum":["standard","compact"]},"page_size":{"default":"A4","type":"string","enum":["A4","LETTER"]}},"additionalProperties":false}},"required":["format"],"additionalProperties":false,"oneOf":[{"properties":{"format":{"const":"xlsx"}},"required":["sheets"],"not":{"required":["content"]}},{"properties":{"format":{"enum":["docx","pdf"]}},"required":["content"],"not":{"required":["sheets"]}}]},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Pending":{"type":"object","required":["request_id","status"],"properties":{"request_id":{"type":"string","format":"uuid"},"status":{"enum":["processing","settling","settlement_unknown"]},"status_url":{"type":"string"},"message":{"type":"string"}}},"Document":{"type":"object","required":["request_id","status","format","filename","download_url","file_size","created_at","expires_at","validation"],"properties":{"request_id":{"type":"string","format":"uuid"},"status":{"const":"completed"},"format":{"enum":["docx","xlsx","pdf"]},"filename":{"type":"string"},"download_url":{"type":"string","format":"uri"},"download_headers":{"type":"object"},"file_size":{"type":"integer","minimum":1},"mime_type":{"type":"string"},"sha256":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"validation":{"type":"object","properties":{"valid":{"const":true}}},"payment":{"type":"object"}}}}}}