Understand

Generate AI optimization suggestions for a simulation

Uses GPT-5 to analyse the simulation's current resource configuration and metric history and return prioritised suggestions for reducing cost, improving reliability, or increasing performance.

Set beginnerMode: true for simplified language.

Authentication: Requires an API key (write scope) or an x402 micro-payment (3 credits — $0.0030 USDC on Base). Pass Authorization: Bearer <key> for API key access, or include a signed x402 payment header (no account required). Use GET /api/billing/x402/config to discover the live price.

post/simulations/{simulationId}/optimize

Request

  • Base URL: https://www.cloudworldmodel.ai/api
  • URL: https://www.cloudworldmodel.ai/api/simulations/{simulationId}/optimize
  • Auth: one of:
    • HTTP bearer
    • API key in header X-PAYMENT
    • API key in header PAYMENT-SIGNATURE

Path parameters

simulationIdstring required

Simulation UUID

Request body

beginnerModeboolean

Return simplified suggestions

Response

AI optimisation suggestions

suggestionsstring

Prioritised optimisation recommendations

Changes

No recorded changes to this operation across all 1 revision of this API.