{"uid":"cap_BynknWIR0fe3HhFhsp2E1","slug":"x402engine-gpt-5-2-llm-api-4c53b11c","name":"x402engine GPT-5.2 LLM API","description":"OpenAI's latest flagship model — top-tier reasoning, coding, and multimodal capabilities","url":"https://x402engine.app/api/llm/gpt-5.2?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"type":"object","required":["messages"],"properties":{"seed":{"type":"integer","description":"Model-supported seed; see /docs/llm-capabilities.md."},"tools":{"type":"array","items":{"type":"object","required":["function"],"properties":{"type":{"enum":["function"],"type":"string"},"function":{"type":"object","properties":{"name":{"type":"string"},"strict":{"type":"boolean"},"parameters":{"type":"object"},"description":{"type":"string"}}}}},"description":"Client-executed function definitions; return results using role=tool and tool_call_id."},"stream":{"type":"boolean","description":"Return live OpenAI-compatible SSE after payment settlement."},"plugins":{"type":"array","items":{"type":"object","required":["pdf"],"properties":{"id":{"enum":["file-parser"],"type":"string"},"pdf":{"type":"object","properties":{"engine":{"enum":["native"],"type":"string"}}}}},"description":"Optional native PDF parser only; automatically enabled for file inputs."},"messages":{"type":"array","items":{"type":"object","anyOf":[{"required":["content"]},{"required":["tool_calls"]}],"required":["role"],"properties":{"name":{"type":"string"},"role":{"enum":["system","developer","user","assistant","tool"],"type":"string"},"content":{"oneOf":[{"type":"string"},{"type":"null"},{"type":"array","items":{"type":"object","required":["type"],"properties":{"type":{"enum":["text","file","image_url"],"type":"string"}},"additionalProperties":true},"maxItems":100,"minItems":1}]},"refusal":{"type":["string","null"]},"reasoning":{"type":"string"},"tool_calls":{"type":"array","items":{"type":"object"}},"annotations":{"type":"array","items":{"type":"object"}},"tool_call_id":{"type":"string"},"cache_control":{"type":"object"},"reasoning_details":{"type":"array","items":{"type":"object"}}},"additionalProperties":false},"maxItems":100,"minItems":1,"description":"Text or model-supported multimodal messages; assistant tool calls may have null content"},"reasoning":{"type":"object","description":"Model-supported reasoning; see /docs/llm-capabilities.md."},"max_tokens":{"type":"integer","example":1024,"description":"Total output budget, including reasoning. Use this or max_completion_tokens."},"tool_choice":{"oneOf":[{"enum":["auto","none","required"],"type":"string"},{"type":"object"}],"description":"Model-supported tool_choice; see /docs/llm-capabilities.md."},"stream_options":{"type":"object","description":"Optional include_usage boolean; usage is always requested upstream."},"response_format":{"type":"object","description":"Model-supported response_format; see /docs/llm-capabilities.md."},"reasoning_effort":{"type":"string","description":"Model-supported reasoning_effort; see /docs/llm-capabilities.md."},"include_reasoning":{"type":"boolean","description":"Model-supported include_reasoning; see /docs/llm-capabilities.md."},"max_completion_tokens":{"type":"integer","description":"Alias for total output budget; bounded by model maxOutputTokens."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["choices","content"],"properties":{"model":{"type":"string"},"usage":{"type":"object","description":"Provider token and usage accounting, when returned."},"choices":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"message":{"type":"object","properties":{"role":{"type":"string"},"content":{"type":["string","null"]},"tool_calls":{"type":"array","items":{"type":"object"}}}},"finish_reason":{"type":["string","null"]}}}},"content":{"type":"string","description":"Convenience copy of the first assistant message's text."}}}}}}},"responseSchema":{"type":"json","example":{"model":"openai/gpt-5.2","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"content":"Hello!"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.035179","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.035179/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.035179","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.035179","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UCtxWhbTtrGvyQdxmWPl2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.035179","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Provides pay-per-call access to OpenAI's GPT-5.2 flagship model with top-tier reasoning, coding, and multimodal capabilities via HTTP 402 micropayments","exampleAgentPrompt":"Use GPT-5.2 to analyze this complex Python codebase and suggest refactoring improvements — specifically focusing on reducing cyclomatic complexity and improving readability across the main module.","exampleUseCases":[{"title":"Complex multi-step reasoning task","prompt":"I need you to work through this logic puzzle step by step and explain your reasoning: five people live in five houses, each with a different color, and I want you to figure out who owns the fish using the Einstein riddle clues I'll give you."},{"title":"Production code generation","prompt":"Write me a complete, production-ready TypeScript class for a rate-limited HTTP client that handles retries with exponential backoff, includes proper error handling, and has JSDoc comments throughout."},{"title":"Multimodal document analysis","prompt":"I have a screenshot of a financial report — can you extract the key metrics, identify any anomalies in the numbers, and summarize the overall financial health in plain language?"}],"resultDescription":"Returns the model's generated text response, which may include reasoning chains, code blocks, structured analysis, or conversational replies depending on the prompt. Response follows standard OpenAI chat completion format with choices, token usage, and finish reason.","failureModes":["Payment not included or insufficient USDC — returns HTTP 402 with payment required details","Invalid or malformed message format — returns 400 with schema validation error","Rate limit or capacity exceeded — returns 429 or 503","Prompt triggers content policy — returns refusal or 400","Network timeout on long-form generation — returns 504 or incomplete response"],"whenToPreferThis":"Choose this endpoint when you need OpenAI's most capable GPT-5.2 model with no subscription or API key setup, paying only per call via USDC micropayments. Ideal for AI agents that need occasional high-quality reasoning, coding, or multimodal analysis without committing to a monthly plan. Prefer this over GPT-4 or Claude endpoints when GPT-5.2's top-tier reasoning or specific OpenAI model behavior is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-19T18:39:01.873Z","isFirstParty":false,"canonicalSlug":"x402engine-gpt-5-2-llm-api-4c53b11c"}