{"openapi":"3.1.0","info":{"title":"Wundership MPP API","version":"2026-07-15","description":"Public OpenAPI surface for Wundership machine-paid agent requests. Unpaid requests return HTTP 402 Payment Required.","guidance":"Use POST /v1/plan with a JSON body containing a prompt or idea to buy a structured Wundership software plan. Discovery endpoints are public. Paid operations declare x-payment-info and return HTTP 402 Payment Required until payment is authorized. After payment, retry the same request with the payment authorization or verified proxy headers described by the payment challenge.","x-guidance":"Use POST /v1/plan with a JSON body containing a prompt or idea to buy a structured Wundership software plan. Discovery endpoints are public. Paid operations declare x-payment-info and return HTTP 402 Payment Required until payment is authorized. After payment, retry the same request with the payment authorization or verified proxy headers described by the payment challenge.","contact":{"email":"hello@wundercorp.co","url":"https://wundercorp.co","name":"WunderCorp, Inc."}},"servers":[{"url":"https://mpp.openmodel.sh"}],"tags":[{"name":"Machine Payments","description":"Paid Wundership endpoints that agents can invoke after MPP payment."},{"name":"App Planning","description":"Software planning and implementation direction for agent callers."},{"name":"BuilderStudio","description":"BuilderStudio preview and app-generation support endpoints."},{"name":"AI Generation","description":"Paid AI generation utilities."},{"name":"Inference Gateway","description":"Transparent MPP routing to supported model, media, speech, and document intelligence providers."},{"name":"OpenModel Pricing","description":"Paid access to effective-dated model pricing and cost-weighted allowance estimates."},{"name":"Commerce","description":"Paid commerce metadata generation utilities."}],"paths":{"/v1/plan":{"post":{"tags":["Machine Payments","App Planning"],"summary":"Wundership app plan","description":"Generate a structured software plan, product outline, feature map, and implementation-ready app direction. This is a paid machine-payment endpoint. Unpaid calls return HTTP 402 Payment Required with machine-payment metadata. Retry the same request after payment authorization.","operationId":"postWundershipPlan","requestBody":{"required":true,"content":{"application/json":{"examples":{"softwarePlan":{"summary":"Generate an implementation-ready app plan","value":{"target_customer":"Founders, AI builders, and autonomous agents","output_format":"implementation_plan","constraints":["Use a machine-payment endpoint","Return clear implementation phases"],"project_name":"Agent Market","prompt":"Build a marketplace for AI agents that can buy and sell paid API calls.","preferred_stack":"Next.js, Spring Boot, PostgreSQL, Stripe"}}},"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"target_customer":{"type":"string","description":"Who the app or software plan is for."},"output_format":{"type":"string","description":"Requested output style, such as implementation_plan, product_outline, or feature_map."},"constraints":{"type":"array","description":"Hard requirements, limits, or product constraints.","items":{"type":"string"}},"project_name":{"type":"string","description":"Optional project or product name."},"prompt":{"type":"string","description":"Software idea, product request, or agent task to turn into an implementation-ready plan."},"preferred_stack":{"type":"string","description":"Preferred technical stack, framework, language, or deployment target."}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"wundership_plan","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true,"properties":{"buildPhases":{"type":"array","items":{"type":"string"}},"recommendedNextPaidCall":{"additionalProperties":true,"type":"object"},"risks":{"type":"array","items":{"type":"string"}},"architecture":{"type":"array","items":{"type":"string"}},"productBrief":{"type":"string"}}},"ok":{"type":"boolean"},"productName":{"example":"Wundership app plan","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"1.00","currency":"USD","minorUnits":100},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"1.000000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"1.000000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"100","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]}}},"/mpp/plan":{"post":{"tags":["Machine Payments","App Planning"],"summary":"Wundership app plan","description":"Generate a structured software plan, product outline, feature map, and implementation-ready app direction. This path is deprecated. Use https://mpp.openmodel.sh/v1/plan instead.","operationId":"postWundershipPlan","requestBody":{"required":true,"content":{"application/json":{"examples":{"softwarePlan":{"summary":"Generate an implementation-ready app plan","value":{"target_customer":"Founders, AI builders, and autonomous agents","output_format":"implementation_plan","constraints":["Use a machine-payment endpoint","Return clear implementation phases"],"project_name":"Agent Market","prompt":"Build a marketplace for AI agents that can buy and sell paid API calls.","preferred_stack":"Next.js, Spring Boot, PostgreSQL, Stripe"}}},"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"target_customer":{"type":"string","description":"Who the app or software plan is for."},"output_format":{"type":"string","description":"Requested output style, such as implementation_plan, product_outline, or feature_map."},"constraints":{"type":"array","description":"Hard requirements, limits, or product constraints.","items":{"type":"string"}},"project_name":{"type":"string","description":"Optional project or product name."},"prompt":{"type":"string","description":"Software idea, product request, or agent task to turn into an implementation-ready plan."},"preferred_stack":{"type":"string","description":"Preferred technical stack, framework, language, or deployment target."}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"wundership_plan","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true,"properties":{"buildPhases":{"type":"array","items":{"type":"string"}},"recommendedNextPaidCall":{"additionalProperties":true,"type":"object"},"risks":{"type":"array","items":{"type":"string"}},"architecture":{"type":"array","items":{"type":"string"}},"productBrief":{"type":"string"}}},"ok":{"type":"boolean"},"productName":{"example":"Wundership app plan","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"1.00","currency":"USD","minorUnits":100},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"1.000000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"1.000000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"100","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]},"deprecated":true,"x-successor-path":"/v1/plan"}},"/mpp/aurelius/plan":{"post":{"tags":["Machine Payments","App Planning"],"summary":"Wundership app plan","description":"Generate a structured software plan, product outline, feature map, and implementation-ready app direction. This path is deprecated. Use https://mpp.openmodel.sh/v1/plan instead.","operationId":"postWundershipPlan","requestBody":{"required":true,"content":{"application/json":{"examples":{"softwarePlan":{"summary":"Generate an implementation-ready app plan","value":{"target_customer":"Founders, AI builders, and autonomous agents","output_format":"implementation_plan","constraints":["Use a machine-payment endpoint","Return clear implementation phases"],"project_name":"Agent Market","prompt":"Build a marketplace for AI agents that can buy and sell paid API calls.","preferred_stack":"Next.js, Spring Boot, PostgreSQL, Stripe"}}},"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"target_customer":{"type":"string","description":"Who the app or software plan is for."},"output_format":{"type":"string","description":"Requested output style, such as implementation_plan, product_outline, or feature_map."},"constraints":{"type":"array","description":"Hard requirements, limits, or product constraints.","items":{"type":"string"}},"project_name":{"type":"string","description":"Optional project or product name."},"prompt":{"type":"string","description":"Software idea, product request, or agent task to turn into an implementation-ready plan."},"preferred_stack":{"type":"string","description":"Preferred technical stack, framework, language, or deployment target."}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"wundership_plan","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true,"properties":{"buildPhases":{"type":"array","items":{"type":"string"}},"recommendedNextPaidCall":{"additionalProperties":true,"type":"object"},"risks":{"type":"array","items":{"type":"string"}},"architecture":{"type":"array","items":{"type":"string"}},"productBrief":{"type":"string"}}},"ok":{"type":"boolean"},"productName":{"example":"Wundership app plan","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"1.00","currency":"USD","minorUnits":100},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"1.000000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"1.000000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"100","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]},"deprecated":true,"x-successor-path":"/v1/plan"}},"/v1/builder/preview":{"post":{"tags":["Machine Payments","BuilderStudio"],"summary":"BuilderStudio preview","description":"Prepare a BuilderStudio preview package for a product idea. This is a paid machine-payment endpoint. Unpaid calls return HTTP 402 Payment Required with machine-payment metadata. Retry the same request after payment authorization.","operationId":"postBuilderPreview","requestBody":{"required":true,"content":{"application/json":{"examples":{"default":{"summary":"Invoke paid endpoint","value":{"output_format":"json","prompt":"Complete this Wundership task for an agent caller."}}},"schema":{"type":"object","additionalProperties":true,"required":["prompt"],"properties":{"output_format":{"type":"string","description":"Optional requested output format."},"context":{"type":"object","additionalProperties":true,"description":"Optional structured context for the request."},"prompt":{"type":"string","description":"Agent task or generation prompt for this paid Wundership endpoint."}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"builder_preview","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"BuilderStudio preview","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"5.00","currency":"USD","minorUnits":500},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"5.000000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"5.000000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"500","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]}}},"/mpp/builder/preview":{"post":{"tags":["Machine Payments","BuilderStudio"],"summary":"BuilderStudio preview","description":"Prepare a BuilderStudio preview package for a product idea. This path is deprecated. Use https://mpp.openmodel.sh/v1/builder/preview instead.","operationId":"postBuilderPreview","requestBody":{"required":true,"content":{"application/json":{"examples":{"default":{"summary":"Invoke paid endpoint","value":{"output_format":"json","prompt":"Complete this Wundership task for an agent caller."}}},"schema":{"type":"object","additionalProperties":true,"required":["prompt"],"properties":{"output_format":{"type":"string","description":"Optional requested output format."},"context":{"type":"object","additionalProperties":true,"description":"Optional structured context for the request."},"prompt":{"type":"string","description":"Agent task or generation prompt for this paid Wundership endpoint."}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"builder_preview","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"BuilderStudio preview","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"5.00","currency":"USD","minorUnits":500},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"5.000000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"5.000000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"500","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]},"deprecated":true,"x-successor-path":"/v1/builder/preview"}},"/v1/images/generate":{"post":{"tags":["Machine Payments","AI Generation"],"summary":"Image generation","description":"Generate an image from a prompt after machine payment. This is a paid machine-payment endpoint. Unpaid calls return HTTP 402 Payment Required with machine-payment metadata. Retry the same request after payment authorization.","operationId":"postImageGeneration","requestBody":{"required":true,"content":{"application/json":{"examples":{"default":{"summary":"Invoke paid endpoint","value":{"output_format":"json","prompt":"Complete this Wundership task for an agent caller."}}},"schema":{"type":"object","additionalProperties":true,"required":["prompt"],"properties":{"output_format":{"type":"string","description":"Optional requested output format."},"context":{"type":"object","additionalProperties":true,"description":"Optional structured context for the request."},"prompt":{"type":"string","description":"Agent task or generation prompt for this paid Wundership endpoint."}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"image_generation","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"Image generation","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"1.00","currency":"USD","minorUnits":100},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"1.000000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"1.000000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"100","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]}}},"/mpp/images/generate":{"post":{"tags":["Machine Payments","AI Generation"],"summary":"Image generation","description":"Generate an image from a prompt after machine payment. This path is deprecated. Use https://mpp.openmodel.sh/v1/images/generate instead.","operationId":"postImageGeneration","requestBody":{"required":true,"content":{"application/json":{"examples":{"default":{"summary":"Invoke paid endpoint","value":{"output_format":"json","prompt":"Complete this Wundership task for an agent caller."}}},"schema":{"type":"object","additionalProperties":true,"required":["prompt"],"properties":{"output_format":{"type":"string","description":"Optional requested output format."},"context":{"type":"object","additionalProperties":true,"description":"Optional structured context for the request."},"prompt":{"type":"string","description":"Agent task or generation prompt for this paid Wundership endpoint."}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"image_generation","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"Image generation","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"1.00","currency":"USD","minorUnits":100},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"1.000000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"1.000000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"100","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]},"deprecated":true,"x-successor-path":"/v1/images/generate"}},"/v1/listings/from-image":{"post":{"tags":["Machine Payments","Commerce"],"summary":"Listing from image","description":"Generate commerce listing metadata from image input after machine payment. This is a paid machine-payment endpoint. Unpaid calls return HTTP 402 Payment Required with machine-payment metadata. Retry the same request after payment authorization.","operationId":"postListingFromImage","requestBody":{"required":true,"content":{"application/json":{"examples":{"default":{"summary":"Invoke paid endpoint","value":{"output_format":"json","prompt":"Complete this Wundership task for an agent caller."}}},"schema":{"type":"object","additionalProperties":true,"required":["prompt"],"properties":{"output_format":{"type":"string","description":"Optional requested output format."},"context":{"type":"object","additionalProperties":true,"description":"Optional structured context for the request."},"prompt":{"type":"string","description":"Agent task or generation prompt for this paid Wundership endpoint."}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"listing_from_image","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"Listing from image","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"0.75","currency":"USD","minorUnits":75},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"0.750000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"0.750000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"75","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]}}},"/mpp/listings/from-image":{"post":{"tags":["Machine Payments","Commerce"],"summary":"Listing from image","description":"Generate commerce listing metadata from image input after machine payment. This path is deprecated. Use https://mpp.openmodel.sh/v1/listings/from-image instead.","operationId":"postListingFromImage","requestBody":{"required":true,"content":{"application/json":{"examples":{"default":{"summary":"Invoke paid endpoint","value":{"output_format":"json","prompt":"Complete this Wundership task for an agent caller."}}},"schema":{"type":"object","additionalProperties":true,"required":["prompt"],"properties":{"output_format":{"type":"string","description":"Optional requested output format."},"context":{"type":"object","additionalProperties":true,"description":"Optional structured context for the request."},"prompt":{"type":"string","description":"Agent task or generation prompt for this paid Wundership endpoint."}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"listing_from_image","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"Listing from image","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"0.75","currency":"USD","minorUnits":75},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"0.750000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"0.750000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"75","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]},"deprecated":true,"x-successor-path":"/v1/listings/from-image"}},"/mpp/chat/completions":{"post":{"tags":["Machine Payments","AI Generation"],"summary":"Legacy fixed-price chat completion","description":"Deprecated fixed-price Wundership chat route retained during migration to the unified MPP inference gateway. This path is deprecated. Use https://mpp.openmodel.sh/v1/chat/completions instead.","operationId":"postChatCompletion","requestBody":{"required":true,"content":{"application/json":{"examples":{"default":{"summary":"Invoke paid endpoint","value":{"output_format":"json","prompt":"Complete this Wundership task for an agent caller."}}},"schema":{"type":"object","additionalProperties":true,"required":["prompt"],"properties":{"output_format":{"type":"string","description":"Optional requested output format."},"context":{"type":"object","additionalProperties":true,"description":"Optional structured context for the request."},"prompt":{"type":"string","description":"Agent task or generation prompt for this paid Wundership endpoint."}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"chat_completion","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"Legacy fixed-price chat completion","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"0.50","currency":"USD","minorUnits":50},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"0.500000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"0.500000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"50","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]},"deprecated":true,"x-successor-path":"/v1/chat/completions"}},"/v1/pricing/estimate":{"post":{"tags":["Machine Payments","OpenModel Pricing"],"summary":"OpenModel pricing estimate","description":"Resolve effective-dated provider pricing and cost-weighted monthly allowance consumption after machine payment. This is a paid machine-payment endpoint. Unpaid calls return HTTP 402 Payment Required with machine-payment metadata. Retry the same request after payment authorization.","operationId":"postOpenmodelPricingEstimate","requestBody":{"required":true,"content":{"application/json":{"examples":{"pricingEstimate":{"summary":"Estimate provider cost and cost-weighted allowance consumption","value":{"model":"gpt-4o-mini","region":"global","serviceTier":"default","usage":{"reasoningTokens":0,"cachedInputTokens":0,"outputTokens":250000,"cacheWriteTokens":0,"inputTokens":1000000},"provider":"openai"}}},"schema":{"type":"object","additionalProperties":false,"required":["provider","model","usage"],"properties":{"provider":{"type":"string"},"occurredAt":{"format":"date-time","type":"string"},"usage":{"type":"object","properties":{"inputTokens":{"type":"integer","format":"int64","minimum":0},"outputTokens":{"type":"integer","format":"int64","minimum":0},"cachedInputTokens":{"type":"integer","format":"int64","minimum":0},"cacheWriteTokens":{"type":"integer","format":"int64","minimum":0},"reasoningTokens":{"type":"integer","format":"int64","minimum":0}},"additionalProperties":false},"region":{"type":"string","default":"global"},"serviceTier":{"type":"string","default":"default"},"model":{"type":"string"}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"openmodel_pricing_estimate","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"OpenModel pricing estimate","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"0.01","currency":"USD","minorUnits":1},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"0.010000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"0.010000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"1","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]}}},"/mpp/openmodel/pricing/estimate":{"post":{"tags":["Machine Payments","OpenModel Pricing"],"summary":"OpenModel pricing estimate","description":"Resolve effective-dated provider pricing and cost-weighted monthly allowance consumption after machine payment. This path is deprecated. Use https://mpp.openmodel.sh/v1/pricing/estimate instead.","operationId":"postOpenmodelPricingEstimate","requestBody":{"required":true,"content":{"application/json":{"examples":{"pricingEstimate":{"summary":"Estimate provider cost and cost-weighted allowance consumption","value":{"model":"gpt-4o-mini","region":"global","serviceTier":"default","usage":{"reasoningTokens":0,"cachedInputTokens":0,"outputTokens":250000,"cacheWriteTokens":0,"inputTokens":1000000},"provider":"openai"}}},"schema":{"type":"object","additionalProperties":false,"required":["provider","model","usage"],"properties":{"provider":{"type":"string"},"occurredAt":{"format":"date-time","type":"string"},"usage":{"type":"object","properties":{"inputTokens":{"type":"integer","format":"int64","minimum":0},"outputTokens":{"type":"integer","format":"int64","minimum":0},"cachedInputTokens":{"type":"integer","format":"int64","minimum":0},"cacheWriteTokens":{"type":"integer","format":"int64","minimum":0},"reasoningTokens":{"type":"integer","format":"int64","minimum":0}},"additionalProperties":false},"region":{"type":"string","default":"global"},"serviceTier":{"type":"string","default":"default"},"model":{"type":"string"}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"openmodel_pricing_estimate","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"OpenModel pricing estimate","type":"string"},"receipt":{"type":"string"}}}}},"description":"Paid request completed"},"402":{"description":"Payment required","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Machine-payment challenge header when a compatible payment rail is active."},"X-Wundership-Agent-Price":{"schema":{"type":"string"},"description":"Human-readable price for the paid endpoint."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Paid forwarding failed"}},"x-agent-price":{"display":"0.01","currency":"USD","minorUnits":1},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"currency":"USD","amount":"0.010000","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"0.010000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"1","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]},"deprecated":true,"x-successor-path":"/v1/pricing/estimate"}},"/v1/capabilities":{"get":{"tags":["Inference Gateway"],"operationId":"getMppInferenceCapabilities","summary":"List OpenModel MPP gateway capabilities","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Discovery response"}}}},"/v1/providers":{"get":{"tags":["Inference Gateway"],"operationId":"getMppInferenceProviders","summary":"List supported MPP inference providers","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Discovery response"}}}},"/v1/models":{"get":{"tags":["Inference Gateway"],"operationId":"getMppInferenceModels","summary":"List curated provider model families","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Discovery response"}}}},"/v1/chat/completions":{"post":{"tags":["Inference Gateway"],"operationId":"postMppChatCompletions","summary":"Create a chat completion","description":"Routes the request to a supported MPP provider. Select the provider with X-OpenModel-Provider, a top-level provider field, or a provider-prefixed model ID. The upstream HTTP 402 challenge and payment receipt are passed through.","parameters":[{"schema":{"type":"string"},"description":"Provider key such as openai, anthropic, gemini, openrouter, deepseek, groq, mistral, perplexity, grok, fal, replicate, stability-ai, suno, deepgram, or mathpix.","name":"X-OpenModel-Provider","in":"header","required":false}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}}},"responses":{"200":{"description":"Upstream provider response"},"202":{"description":"Upstream asynchronous operation accepted"},"400":{"description":"Unknown provider or invalid gateway request"},"402":{"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Upstream MPP payment challenge."}},"description":"Upstream MPP payment required"},"502":{"description":"Upstream MPP provider unavailable"},"503":{"description":"Gateway or provider route disabled"}},"x-payment-mode":"upstream_mpp_challenge_passthrough","x-gateway-api-key-required":false}},"/v1/responses":{"post":{"tags":["Inference Gateway"],"operationId":"postMppResponses","summary":"Create a model response","description":"Routes the request to a supported MPP provider. Select the provider with X-OpenModel-Provider, a top-level provider field, or a provider-prefixed model ID. The upstream HTTP 402 challenge and payment receipt are passed through.","parameters":[{"schema":{"type":"string"},"description":"Provider key such as openai, anthropic, gemini, openrouter, deepseek, groq, mistral, perplexity, grok, fal, replicate, stability-ai, suno, deepgram, or mathpix.","name":"X-OpenModel-Provider","in":"header","required":false}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}}},"responses":{"200":{"description":"Upstream provider response"},"202":{"description":"Upstream asynchronous operation accepted"},"400":{"description":"Unknown provider or invalid gateway request"},"402":{"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Upstream MPP payment challenge."}},"description":"Upstream MPP payment required"},"502":{"description":"Upstream MPP provider unavailable"},"503":{"description":"Gateway or provider route disabled"}},"x-payment-mode":"upstream_mpp_challenge_passthrough","x-gateway-api-key-required":false}},"/v1/messages":{"post":{"tags":["Inference Gateway"],"operationId":"postMppMessages","summary":"Create an Anthropic-style message","description":"Routes the request to a supported MPP provider. Select the provider with X-OpenModel-Provider, a top-level provider field, or a provider-prefixed model ID. The upstream HTTP 402 challenge and payment receipt are passed through.","parameters":[{"schema":{"type":"string"},"description":"Provider key such as openai, anthropic, gemini, openrouter, deepseek, groq, mistral, perplexity, grok, fal, replicate, stability-ai, suno, deepgram, or mathpix.","name":"X-OpenModel-Provider","in":"header","required":false}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}}},"responses":{"200":{"description":"Upstream provider response"},"202":{"description":"Upstream asynchronous operation accepted"},"400":{"description":"Unknown provider or invalid gateway request"},"402":{"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Upstream MPP payment challenge."}},"description":"Upstream MPP payment required"},"502":{"description":"Upstream MPP provider unavailable"},"503":{"description":"Gateway or provider route disabled"}},"x-payment-mode":"upstream_mpp_challenge_passthrough","x-gateway-api-key-required":false}},"/v1/embeddings":{"post":{"tags":["Inference Gateway"],"operationId":"postMppEmbeddings","summary":"Create embeddings","description":"Routes the request to a supported MPP provider. Select the provider with X-OpenModel-Provider, a top-level provider field, or a provider-prefixed model ID. The upstream HTTP 402 challenge and payment receipt are passed through.","parameters":[{"schema":{"type":"string"},"description":"Provider key such as openai, anthropic, gemini, openrouter, deepseek, groq, mistral, perplexity, grok, fal, replicate, stability-ai, suno, deepgram, or mathpix.","name":"X-OpenModel-Provider","in":"header","required":false}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}}},"responses":{"200":{"description":"Upstream provider response"},"202":{"description":"Upstream asynchronous operation accepted"},"400":{"description":"Unknown provider or invalid gateway request"},"402":{"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Upstream MPP payment challenge."}},"description":"Upstream MPP payment required"},"502":{"description":"Upstream MPP provider unavailable"},"503":{"description":"Gateway or provider route disabled"}},"x-payment-mode":"upstream_mpp_challenge_passthrough","x-gateway-api-key-required":false}},"/v1/images/generations":{"post":{"tags":["Inference Gateway"],"operationId":"postMppImageGeneration","summary":"Generate images","description":"Routes the request to a supported MPP provider. Select the provider with X-OpenModel-Provider, a top-level provider field, or a provider-prefixed model ID. The upstream HTTP 402 challenge and payment receipt are passed through.","parameters":[{"schema":{"type":"string"},"description":"Provider key such as openai, anthropic, gemini, openrouter, deepseek, groq, mistral, perplexity, grok, fal, replicate, stability-ai, suno, deepgram, or mathpix.","name":"X-OpenModel-Provider","in":"header","required":false}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}}},"responses":{"200":{"description":"Upstream provider response"},"202":{"description":"Upstream asynchronous operation accepted"},"400":{"description":"Unknown provider or invalid gateway request"},"402":{"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Upstream MPP payment challenge."}},"description":"Upstream MPP payment required"},"502":{"description":"Upstream MPP provider unavailable"},"503":{"description":"Gateway or provider route disabled"}},"x-payment-mode":"upstream_mpp_challenge_passthrough","x-gateway-api-key-required":false}},"/v1/audio/transcriptions":{"post":{"tags":["Inference Gateway"],"operationId":"postMppAudioTranscription","summary":"Transcribe audio","description":"Routes the request to a supported MPP provider. Select the provider with X-OpenModel-Provider, a top-level provider field, or a provider-prefixed model ID. The upstream HTTP 402 challenge and payment receipt are passed through.","parameters":[{"schema":{"type":"string"},"description":"Provider key such as openai, anthropic, gemini, openrouter, deepseek, groq, mistral, perplexity, grok, fal, replicate, stability-ai, suno, deepgram, or mathpix.","name":"X-OpenModel-Provider","in":"header","required":false}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}}},"responses":{"200":{"description":"Upstream provider response"},"202":{"description":"Upstream asynchronous operation accepted"},"400":{"description":"Unknown provider or invalid gateway request"},"402":{"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Upstream MPP payment challenge."}},"description":"Upstream MPP payment required"},"502":{"description":"Upstream MPP provider unavailable"},"503":{"description":"Gateway or provider route disabled"}},"x-payment-mode":"upstream_mpp_challenge_passthrough","x-gateway-api-key-required":false}},"/v1/audio/speech":{"post":{"tags":["Inference Gateway"],"operationId":"postMppAudioSpeech","summary":"Generate speech","description":"Routes the request to a supported MPP provider. Select the provider with X-OpenModel-Provider, a top-level provider field, or a provider-prefixed model ID. The upstream HTTP 402 challenge and payment receipt are passed through.","parameters":[{"schema":{"type":"string"},"description":"Provider key such as openai, anthropic, gemini, openrouter, deepseek, groq, mistral, perplexity, grok, fal, replicate, stability-ai, suno, deepgram, or mathpix.","name":"X-OpenModel-Provider","in":"header","required":false}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}}},"responses":{"200":{"description":"Upstream provider response"},"202":{"description":"Upstream asynchronous operation accepted"},"400":{"description":"Unknown provider or invalid gateway request"},"402":{"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Upstream MPP payment challenge."}},"description":"Upstream MPP payment required"},"502":{"description":"Upstream MPP provider unavailable"},"503":{"description":"Gateway or provider route disabled"}},"x-payment-mode":"upstream_mpp_challenge_passthrough","x-gateway-api-key-required":false}},"/v1/moderations":{"post":{"tags":["Inference Gateway"],"operationId":"postMppModeration","summary":"Moderate content","description":"Routes the request to a supported MPP provider. Select the provider with X-OpenModel-Provider, a top-level provider field, or a provider-prefixed model ID. The upstream HTTP 402 challenge and payment receipt are passed through.","parameters":[{"schema":{"type":"string"},"description":"Provider key such as openai, anthropic, gemini, openrouter, deepseek, groq, mistral, perplexity, grok, fal, replicate, stability-ai, suno, deepgram, or mathpix.","name":"X-OpenModel-Provider","in":"header","required":false}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}}},"responses":{"200":{"description":"Upstream provider response"},"202":{"description":"Upstream asynchronous operation accepted"},"400":{"description":"Unknown provider or invalid gateway request"},"402":{"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Upstream MPP payment challenge."}},"description":"Upstream MPP payment required"},"502":{"description":"Upstream MPP provider unavailable"},"503":{"description":"Gateway or provider route disabled"}},"x-payment-mode":"upstream_mpp_challenge_passthrough","x-gateway-api-key-required":false}},"/providers/{provider}/{upstreamPath}":{"get":{"tags":["Inference Gateway"],"operationId":"relayMppProviderRequest","summary":"Relay a request to a whitelisted MPP provider","description":"Preserves the provider-specific upstream path, request body, MPP Authorization credential, HTTP 402 challenge, and payment receipt. upstreamPath may contain multiple path segments.","parameters":[{"required":true,"in":"path","name":"provider","schema":{"type":"string"}},{"required":true,"in":"path","name":"upstreamPath","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}},"application/octet-stream":{"schema":{"format":"binary","type":"string"}}}},"responses":{"200":{"description":"Upstream provider response"},"202":{"description":"Upstream asynchronous operation accepted"},"400":{"description":"Unknown provider or invalid gateway request"},"402":{"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Upstream MPP payment challenge."}},"description":"Upstream MPP payment required"},"502":{"description":"Upstream MPP provider unavailable"},"503":{"description":"Gateway or provider route disabled"}},"x-supported-methods":["GET","POST","PUT","PATCH","DELETE","HEAD"],"x-payment-mode":"upstream_mpp_challenge_passthrough"},"post":{"tags":["Inference Gateway"],"operationId":"relayMppProviderRequest","summary":"Relay a request to a whitelisted MPP provider","description":"Preserves the provider-specific upstream path, request body, MPP Authorization credential, HTTP 402 challenge, and payment receipt. upstreamPath may contain multiple path segments.","parameters":[{"required":true,"in":"path","name":"provider","schema":{"type":"string"}},{"required":true,"in":"path","name":"upstreamPath","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}},"application/octet-stream":{"schema":{"format":"binary","type":"string"}}}},"responses":{"200":{"description":"Upstream provider response"},"202":{"description":"Upstream asynchronous operation accepted"},"400":{"description":"Unknown provider or invalid gateway request"},"402":{"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Upstream MPP payment challenge."}},"description":"Upstream MPP payment required"},"502":{"description":"Upstream MPP provider unavailable"},"503":{"description":"Gateway or provider route disabled"}},"x-supported-methods":["GET","POST","PUT","PATCH","DELETE","HEAD"],"x-payment-mode":"upstream_mpp_challenge_passthrough"}}},"components":{"securitySchemes":{"mppPayment":{"type":"http","description":"MPP payment authorization returned after satisfying the HTTP 402 challenge.","scheme":"Payment"}},"schemas":{"ErrorResponse":{"type":"object","properties":{"fallback":{"type":"string"},"error":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true},"PaymentRequired":{"type":"object","required":["error","status","resource","amount","payment"],"properties":{"error":{"example":"payment_required","type":"string"},"type":{"example":"machine_payment_required","type":"string"},"status":{"example":402,"type":"integer"},"protocols":{"type":"array","items":{"type":"string"}},"provider":{"example":"wundership","type":"string"},"resource":{"format":"uri","type":"string"},"product":{"additionalProperties":true,"type":"object"},"amount":{"additionalProperties":true,"type":"object"},"payment":{"additionalProperties":true,"type":"object"},"requestId":{"type":"string"}}}}}}