{"openapi":"3.1.0","info":{"title":"Mint Public API","version":"0.2.0-alpha","description":"REST API for creating and managing account-owned 3D Models, Asset Packs, Worlds, Materials, Images, Audio, Animations, and their files.","license":{"name":"Proprietary","url":"https://docs.mint.gg/terms-of-service"}},"servers":[{"url":"https://api.mint.gg","description":"Production"},{"url":"https://api.dev.mint.gg","description":"Development"},{"url":"http://api.mint.localhost","description":"Local development"}],"tags":[{"name":"3D Models","description":"Generate, read, revise, retry, optimize, retopologize, and convert 3D Models."},{"name":"Asset Packs","description":"Generate and manage coordinated collections of 3D assets."},{"name":"Worlds","description":"Generate, read, review, revise, and retry Worlds."},{"name":"Materials","description":"Generate and read Materials and Material Packs."},{"name":"Images","description":"Generate, edit, read, and upload reusable reference images."},{"name":"Audio","description":"Generate and read Audio assets."},{"name":"Animation","description":"Animate eligible assets and retrieve animation outputs."},{"name":"Pricing","description":"Read-only advisory Credit estimates for public API operations."},{"name":"Account","description":"Developer account, Credits, usage, and health."},{"name":"Operations","description":"Poll asynchronous work and act on review-mode Previews."},{"name":"Assets","description":"List account assets and retrieve their files, manifests, and download URLs."}],"paths":{"/health":{"get":{"tags":["Account"],"operationId":"getHealth","summary":"Check API health","security":[],"responses":{"200":{"description":"Mint public API health response.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"Check API health."}},"/v1/me":{"get":{"tags":["Account"],"operationId":"getDeveloperAccount","summary":"Get the authenticated developer account","security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Authenticated Mint developer account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperAccount"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"Get the authenticated developer account."}},"/v1/usage":{"get":{"tags":["Account"],"operationId":"getUsage","summary":"Get credit balance and API usage","security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Credit balance and API usage.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Usage"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"Get credit balance and API usage."}},"/v1/pricing:estimate":{"post":{"tags":["Pricing"],"operationId":"estimatePricing","summary":"Estimate Credits without starting work","description":"Returns conservative planned Credit reservations for a normalized request. The estimate is advisory, creates no operation or reservation, and does not mutate Credit balances. The subsequent operation is authoritative and finalized spend may be lower.","security":[{"bearerApiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricingEstimateRequest"}}}},"responses":{"200":{"description":"Advisory Credit estimate.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricingEstimate"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/worlds:generate":{"post":{"tags":["Worlds"],"operationId":"generateWorld","summary":"Start a world generation operation","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorldGenerationRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorldGenerationOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorldGenerationOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start a world generation operation."}},"/v1/models:generate":{"post":{"tags":["3D Models"],"operationId":"generateModel","summary":"Start a model generation operation","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelGenerationRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelGenerationOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelGenerationOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start a model generation operation."}},"/v1/models/{modelId}:optimize":{"post":{"tags":["3D Models"],"operationId":"optimizeModel","summary":"Start a model optimization operation","security":[{"bearerApiKey":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelOptimizationRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelOptimizationOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelOptimizationOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start a model optimization operation."}},"/v1/models/{modelId}:convert":{"post":{"tags":["3D Models"],"operationId":"convertModel","summary":"Start a model conversion operation","security":[{"bearerApiKey":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"description":"Mint 3D Model ID owned by the authenticated account.","schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelConversionRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelConversionOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelConversionOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start a model conversion operation."}},"/v1/operations/{operationId}":{"get":{"tags":["Operations"],"operationId":"getOperation","summary":"Get a long-running operation","security":[{"bearerApiKey":[]}],"parameters":[{"name":"operationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Long-running generation, optimization, or conversion operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Get a long-running operation."}},"/v1/operations/{operationId}:approve":{"post":{"tags":["Operations"],"operationId":"approveOperation","summary":"Approve a preview-ready generation operation","security":[{"bearerApiKey":[]}],"parameters":[{"name":"operationId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Approve a preview-ready generation operation."}},"/v1/operations/{operationId}:revise":{"post":{"tags":["Operations"],"operationId":"reviseOperation","summary":"Revise a preview-ready generation operation","security":[{"bearerApiKey":[]}],"parameters":[{"name":"operationId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationReviseRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Revise a preview-ready generation operation."}},"/v1/operations/{operationId}:resume":{"post":{"tags":["Operations"],"operationId":"resumeOperation","summary":"Resume an operation after resolving its billing requirement","security":[{"bearerApiKey":[]}],"parameters":[{"name":"operationId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Resume an operation after resolving its billing requirement."}},"/v1/worlds":{"get":{"tags":["Worlds"],"operationId":"listWorlds","summary":"List worlds owned by the account","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ListLimit"},{"$ref":"#/components/parameters/ListCursor"}],"responses":{"200":{"description":"Paginated worlds owned by the authenticated Mint account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorldList"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"List worlds owned by the account."}},"/v1/worlds/{worldId}":{"get":{"tags":["Worlds"],"operationId":"getWorld","summary":"Get a generated world","security":[{"bearerApiKey":[]}],"parameters":[{"name":"worldId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Generated world resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/World"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Get a generated world."}},"/v1/models":{"get":{"tags":["3D Models"],"operationId":"listModels","summary":"List models owned by the account","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ListLimit"},{"$ref":"#/components/parameters/ListCursor"}],"responses":{"200":{"description":"Paginated 3D Models owned by the authenticated Mint account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelList"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"List models owned by the account."}},"/v1/models/{modelId}":{"get":{"tags":["3D Models"],"operationId":"getModel","summary":"Get a generated model","security":[{"bearerApiKey":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Generated model resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Get a generated model."}},"/v1/assets/{assetId}":{"get":{"tags":["Assets"],"operationId":"getAsset","summary":"Get a generated asset","security":[{"bearerApiKey":[]}],"parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Generated asset resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LibraryAsset"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Get a generated asset."},"delete":{"tags":["Assets"],"operationId":"deleteAsset","summary":"Permanently delete an asset","description":"Deletes one account-owned asset. Asset Pack and Material Pack deletion cascades to direct item Models and Materials, while independently cataloged derivatives are preserved with obsolete links cleared. Physical file cleanup may continue asynchronously after this request succeeds.","security":[{"bearerApiKey":[]}],"parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"The asset was removed from the account. The response has no body.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"The asset ID is missing, malformed, already deleted, or owned by another account.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://api.mint.gg/problems/asset-not-found","title":"Asset not found","status":404}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"409":{"description":"The asset has active generation or derivative work.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://api.mint.gg/problems/asset-has-active-work","title":"Asset has active work","status":409}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Mint could not complete authoritative deletion.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://api.mint.gg/problems/asset-deletion-unavailable","title":"Asset deletion unavailable","status":503}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}}}}},"/v1/assets":{"get":{"tags":["Assets"],"operationId":"listAssets","summary":"List the authenticated account's Mint assets","description":"Returns assets owned by the account regardless of whether they were created in the web app, MCP, or the public API.","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ListLimit"},{"$ref":"#/components/parameters/ListCursor"},{"$ref":"#/components/parameters/AssetTypeFilter"}],"responses":{"200":{"description":"Paginated account asset catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LibraryAssetList"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/asset-packs/{assetPackId}":{"get":{"tags":["Asset Packs"],"operationId":"getAssetPack","summary":"Get an asset pack","security":[{"bearerApiKey":[]}],"parameters":[{"name":"assetPackId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Account-owned Mint asset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LibraryAsset"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Get an asset pack."}},"/v1/materials/{materialId}":{"get":{"tags":["Materials"],"operationId":"getMaterial","summary":"Get a material","security":[{"bearerApiKey":[]}],"parameters":[{"name":"materialId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Account-owned Mint asset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LibraryAsset"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Get a material."}},"/v1/material-packs/{materialPackId}":{"get":{"tags":["Materials"],"operationId":"getMaterialPack","summary":"Get a material pack","security":[{"bearerApiKey":[]}],"parameters":[{"name":"materialPackId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Account-owned Mint asset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LibraryAsset"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Get a material pack."}},"/v1/images/{imageId}":{"get":{"tags":["Images"],"operationId":"getImage","summary":"Get an image","security":[{"bearerApiKey":[]}],"parameters":[{"name":"imageId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Account-owned Mint asset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LibraryAsset"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Get an image."}},"/v1/audio/{audioId}":{"get":{"tags":["Audio"],"operationId":"getAudio","summary":"Get an audio asset","security":[{"bearerApiKey":[]}],"parameters":[{"name":"audioId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Account-owned Mint asset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LibraryAsset"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Get an audio asset."}},"/v1/reference-images/{referenceImageId}":{"get":{"tags":["Images"],"operationId":"getReferenceImage","summary":"Get a reference image","security":[{"bearerApiKey":[]}],"parameters":[{"name":"referenceImageId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Account-owned Mint asset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LibraryAsset"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"description":"Get a reference image."}},"/v1/asset-packs:generate":{"post":{"tags":["Asset Packs"],"operationId":"generateAssetPack","summary":"Start an asset-pack generation operation","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackGenerationRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackGenerationOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackGenerationOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start an asset-pack generation operation."}},"/v1/materials:generate":{"post":{"tags":["Materials"],"operationId":"generateMaterial","summary":"Start a material generation operation","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MaterialGenerationRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MaterialGenerationOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MaterialGenerationOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start a material generation operation."}},"/v1/material-packs:generate":{"post":{"tags":["Materials"],"operationId":"generateMaterialPack","summary":"Start a material-pack generation operation","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MaterialPackGenerationRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MaterialPackGenerationOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MaterialPackGenerationOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start a material-pack generation operation."}},"/v1/images:generate":{"post":{"tags":["Images"],"operationId":"generateImage","summary":"Start an image generation operation","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGenerationRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGenerationOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGenerationOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start an image generation operation."}},"/v1/audio:generate":{"post":{"tags":["Audio"],"operationId":"generateAudio","summary":"Start an audio generation operation","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioGenerationRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioGenerationOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioGenerationOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start an audio generation operation."}},"/v1/images/{imageId}:edit":{"post":{"tags":["Images"],"operationId":"editImage","summary":"Start a non-destructive image edit","security":[{"bearerApiKey":[]}],"parameters":[{"name":"imageId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageEditRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageLifecycleOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageLifecycleOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start a non-destructive image edit."}},"/v1/reference-images":{"post":{"tags":["Images"],"operationId":"uploadReferenceImage","summary":"Upload or import a reusable reference image","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferenceImageUploadRequest"}}}},"responses":{"201":{"description":"Reference image created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LibraryAsset"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Upload or import a reusable reference image."}},"/v1/worlds/{worldId}:approve":{"post":{"tags":["Worlds"],"operationId":"approveWorld","summary":"Approve a world preview","security":[{"bearerApiKey":[]}],"parameters":[{"name":"worldId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorldTransitionOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorldTransitionOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Approve a world preview."}},"/v1/worlds/{worldId}:revise":{"post":{"tags":["Worlds"],"operationId":"reviseWorld","summary":"Revise a world preview","security":[{"bearerApiKey":[]}],"parameters":[{"name":"worldId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorldReviseRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorldTransitionOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorldTransitionOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Revise a world preview."}},"/v1/models/{modelId}:approve":{"post":{"tags":["3D Models"],"operationId":"approveModel","summary":"Approve a model preview","security":[{"bearerApiKey":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelTransitionOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelTransitionOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Approve a model preview."}},"/v1/models/{modelId}:revise":{"post":{"tags":["3D Models"],"operationId":"reviseModel","summary":"Revise a model preview","security":[{"bearerApiKey":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelReviseRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelTransitionOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelTransitionOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Revise a model preview."}},"/v1/asset-packs/{assetPackId}:approve":{"post":{"tags":["Asset Packs"],"operationId":"approveAssetPack","summary":"Approve an asset-pack preview","security":[{"bearerApiKey":[]}],"parameters":[{"name":"assetPackId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackApproveRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackTransitionOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackTransitionOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Approve an asset-pack preview."}},"/v1/asset-packs/{assetPackId}:revise":{"post":{"tags":["Asset Packs"],"operationId":"reviseAssetPack","summary":"Revise an asset-pack preview","security":[{"bearerApiKey":[]}],"parameters":[{"name":"assetPackId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackReviseRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackTransitionOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackTransitionOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Revise an asset-pack preview."}},"/v1/worlds/{worldId}:retry":{"post":{"tags":["Worlds"],"operationId":"retryWorld","summary":"Retry a failed world generation","security":[{"bearerApiKey":[]}],"parameters":[{"name":"worldId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationRetryRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorldRetryOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorldRetryOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Retry a failed world generation."}},"/v1/models/{modelId}:retry":{"post":{"tags":["3D Models"],"operationId":"retryModel","summary":"Retry a failed model generation","security":[{"bearerApiKey":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationRetryRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelRetryOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelRetryOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Retry a failed model generation."}},"/v1/asset-packs/{assetPackId}:retry":{"post":{"tags":["Asset Packs"],"operationId":"retryAssetPack","summary":"Retry a failed asset-pack preview","security":[{"bearerApiKey":[]}],"parameters":[{"name":"assetPackId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackRetryRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackRetryOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackRetryOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Retry a failed asset-pack preview."}},"/v1/asset-packs/{assetPackId}:regenerate-failed-items":{"post":{"tags":["Asset Packs"],"operationId":"regenerateFailedAssetPackItems","summary":"Regenerate failed final asset-pack items","security":[{"bearerApiKey":[]}],"parameters":[{"name":"assetPackId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackRetryOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackRetryOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Regenerate failed final asset-pack items."}},"/v1/models/{modelId}:retopologize":{"post":{"tags":["3D Models"],"operationId":"retopologizeModel","summary":"Start smart topology for a model","security":[{"bearerApiKey":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelRetopologyRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelRetopologyOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelRetopologyOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start smart topology for a model."}},"/v1/models/{modelId}:animate":{"post":{"tags":["Animation"],"operationId":"animateModel","summary":"Start model rigging and animation","security":[{"bearerApiKey":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelAnimationRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelAnimationOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelAnimationOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start model rigging and animation."}},"/v1/asset-packs/{assetPackId}:animate":{"post":{"tags":["Animation"],"operationId":"animateAssetPackModel","summary":"Start rigging and animation for an asset-pack model","security":[{"bearerApiKey":[]}],"parameters":[{"name":"assetPackId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackAnimationRequest"}}}},"responses":{"200":{"description":"An earlier request with the same retry key returned this operation.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackAnimationOperation"}}}},"202":{"description":"Long-running operation accepted.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Location":{"schema":{"type":"string"},"description":"Relative URL for polling this operation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPackAnimationOperation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ContentPolicyBlocked"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/ContentSafetyUnavailable"}},"description":"Start rigging and animation for an asset-pack model."}},"/v1/assets/{assetType}/{assetId}/artifacts":{"get":{"tags":["Assets"],"operationId":"listAssetArtifacts","summary":"List downloadable files for an asset","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ArtifactAssetType"},{"$ref":"#/components/parameters/ArtifactAssetId"}],"responses":{"200":{"$ref":"#/components/responses/GenericSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"List downloadable files for an asset."}},"/v1/assets/{assetType}/{assetId}/artifact-manifest":{"get":{"tags":["Assets"],"operationId":"getAssetArtifactManifest","summary":"Get an integration manifest with asset URLs","description":"Returns downloadable artifacts for ordinary assets. World manifests expose the streamed RAD file and collider under runtime.runtimeUrl and runtime.collider.runtimeUrl.","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ArtifactAssetType"},{"$ref":"#/components/parameters/ArtifactAssetId"}],"responses":{"200":{"$ref":"#/components/responses/GenericSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/assets/{assetType}/{assetId}/artifacts/{artifactId}":{"get":{"tags":["Assets"],"operationId":"getAssetArtifact","summary":"Get a download URL for one asset file","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ArtifactAssetType"},{"$ref":"#/components/parameters/ArtifactAssetId"},{"name":"artifactId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/GenericSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"Get a download URL for one asset file."}},"/v1/artifact-manifests":{"post":{"tags":["Assets"],"operationId":"getAssetArtifactManifestBatch","summary":"Get file manifests for up to 25 assets","security":[{"bearerApiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactManifestBatchRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/GenericSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"Get file manifests for up to 25 assets."}},"/v1/animation-sets":{"get":{"tags":["Animation"],"operationId":"listAnimationSets","summary":"List curated animation sets","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ListLimit"},{"$ref":"#/components/parameters/ListCursor"},{"$ref":"#/components/parameters/SearchQuery"}],"responses":{"200":{"$ref":"#/components/responses/GenericSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"List curated animation sets."}},"/v1/animation-options":{"get":{"tags":["Animation"],"operationId":"listAnimationOptions","summary":"Search supported animation clips","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ListLimit"},{"$ref":"#/components/parameters/ListCursor"},{"$ref":"#/components/parameters/SearchQuery"},{"name":"category","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/GenericSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"Search supported animation clips."}},"/v1/animations/{targetType}/{targetId}":{"get":{"tags":["Animation"],"operationId":"getAnimationResource","summary":"Get an animation batch or clip","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/AnimationTargetType"},{"$ref":"#/components/parameters/AnimationTargetId"}],"responses":{"200":{"$ref":"#/components/responses/GenericSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"Get an animation batch or clip."}},"/v1/animations/{targetType}/{targetId}/artifacts":{"get":{"tags":["Animation"],"operationId":"listAnimationArtifacts","summary":"List animation files","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/AnimationTargetType"},{"$ref":"#/components/parameters/AnimationTargetId"}],"responses":{"200":{"$ref":"#/components/responses/GenericSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"List animation files."}},"/v1/animations/{targetType}/{targetId}/artifact-manifest":{"get":{"tags":["Animation"],"operationId":"getAnimationArtifactManifest","summary":"Get an animation file manifest","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/AnimationTargetType"},{"$ref":"#/components/parameters/AnimationTargetId"}],"responses":{"200":{"$ref":"#/components/responses/GenericSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"Get an animation file manifest."}},"/v1/animations/{targetType}/{targetId}/artifacts/{artifactId}":{"get":{"tags":["Animation"],"operationId":"getAnimationArtifact","summary":"Get an animation-file download URL","security":[{"bearerApiKey":[]}],"parameters":[{"$ref":"#/components/parameters/AnimationTargetType"},{"$ref":"#/components/parameters/AnimationTargetId"},{"name":"artifactId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/GenericSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"description":"Get an animation-file download URL."}}},"components":{"headers":{"RequestId":{"schema":{"type":"string","format":"uuid"},"description":"Mint request identifier to include when reporting a problem to support."},"RateLimitLimit":{"schema":{"type":"integer","minimum":1},"description":"Maximum requests allowed by the active rate-limit bucket."},"RateLimitRemaining":{"schema":{"type":"integer","minimum":0},"description":"Whole requests remaining in the active rate-limit bucket."},"RateLimitReset":{"schema":{"type":"integer","format":"int64"},"description":"Unix timestamp in seconds when the continuously refilling bucket is expected to be full."}},"securitySchemes":{"bearerApiKey":{"type":"http","scheme":"bearer","description":"Mint API key sent as a Bearer token."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":255},"description":"Optional stable key for safely retrying an uncertain mutating request. Mint creates an internal key when this header is omitted. Reusing a supplied key with different parameters returns 409."},"ListLimit":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum number of resources to return."},"ListCursor":{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor returned from the previous page's pagination.nextCursor."},"AssetTypeFilter":{"name":"type","in":"query","required":false,"schema":{"enum":["world","model","asset_pack","material","material_pack","image","audio","reference_image"]},"description":"Limit the account catalog to one asset type."},"ArtifactAssetType":{"name":"assetType","in":"path","required":true,"schema":{"enum":["world","model","asset_pack","material","material_pack","image","audio"]},"description":"Mint asset type whose artifact manifest should be resolved."},"ArtifactAssetId":{"name":"assetId","in":"path","required":true,"schema":{"type":"string"},"description":"Mint asset ID owned by the authenticated account."},"AnimationTargetType":{"name":"targetType","in":"path","required":true,"schema":{"enum":["model_animation_batch","asset_pack_animation_batch","model_animation_clip"]},"description":"Animation resource type."},"AnimationTargetId":{"name":"targetId","in":"path","required":true,"schema":{"type":"string"},"description":"Animation resource ID."},"SearchQuery":{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"Optional text search applied to the requested catalog."}},"responses":{"BadRequest":{"description":"Request validation failed.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"PaymentRequired":{"description":"The account needs credits or an active plan for this operation.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"Unauthorized":{"description":"Missing, malformed, inactive, or revoked API key.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"Conflict":{"description":"Idempotency key conflict or already-running request.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"TooManyRequests":{"description":"An account or traffic-class token bucket was exhausted. Authenticated traffic allows 600 requests per minute; paid work and conversions each allow 30 starts per minute. Limits refill continuously and are shared across an account's API keys.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"NotFound":{"description":"The requested API resource was not found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"ServiceUnavailable":{"description":"Mint could not reach the backend service.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"ContentPolicyBlocked":{"description":"The safety check completed and blocked the content.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"ContentSafetyUnavailable":{"description":"Mint could not complete the safety check. The request was not processed and may be retried.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"Retry-After":{"schema":{"type":"string","example":"5"},"description":"Seconds to wait before retrying."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"ServerError":{"description":"The operation failed to start or transition.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"GenericSuccess":{"description":"Requested Mint resource.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}}},"schemas":{"Problem":{"type":"object","description":"RFC 9457-style API error response.","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri-reference","enum":["https://api.mint.gg/problems/animation-actions-not-in-set","https://api.mint.gg/problems/animation-not-found","https://api.mint.gg/problems/animation-resource-unavailable","https://api.mint.gg/problems/animation-service-unavailable","https://api.mint.gg/problems/animation-set-not-found","https://api.mint.gg/problems/animation-start-failed","https://api.mint.gg/problems/artifact-not-found","https://api.mint.gg/problems/artifact-not-ready","https://api.mint.gg/problems/artifact-service-unavailable","https://api.mint.gg/problems/artifact-unavailable","https://api.mint.gg/problems/asset-deletion-unavailable","https://api.mint.gg/problems/asset-has-active-work","https://api.mint.gg/problems/asset-lookup-unavailable","https://api.mint.gg/problems/asset-not-found","https://api.mint.gg/problems/billing-required","https://api.mint.gg/problems/conversion-start-failed","https://api.mint.gg/problems/content-policy-blocked","https://api.mint.gg/problems/content-safety-unavailable","https://api.mint.gg/problems/developer-api-key-400","https://api.mint.gg/problems/developer-api-key-401","https://api.mint.gg/problems/developer-api-key-403","https://api.mint.gg/problems/developer-api-key-404","https://api.mint.gg/problems/developer-api-key-409","https://api.mint.gg/problems/downloads-disabled","https://api.mint.gg/problems/empty-reference-image","https://api.mint.gg/problems/generation-not-failed","https://api.mint.gg/problems/generation-not-retryable","https://api.mint.gg/problems/generation-start-failed","https://api.mint.gg/problems/idempotency-conflict","https://api.mint.gg/problems/idempotency-in-progress","https://api.mint.gg/problems/image-not-ready","https://api.mint.gg/problems/internal-server-error","https://api.mint.gg/problems/invalid-animation-id","https://api.mint.gg/problems/invalid-animation-target","https://api.mint.gg/problems/invalid-api-key","https://api.mint.gg/problems/invalid-artifact-action","https://api.mint.gg/problems/invalid-asset-id","https://api.mint.gg/problems/invalid-asset-type","https://api.mint.gg/problems/invalid-conversion-source","https://api.mint.gg/problems/invalid-idempotency-key","https://api.mint.gg/problems/invalid-item-count","https://api.mint.gg/problems/invalid-model-optimization-state","https://api.mint.gg/problems/invalid-operation-mode","https://api.mint.gg/problems/invalid-operation-stage","https://api.mint.gg/problems/invalid-pagination","https://api.mint.gg/problems/invalid-reference-image-data","https://api.mint.gg/problems/invalid-request","https://api.mint.gg/problems/invalid-source-image","https://api.mint.gg/problems/lifecycle-transition-failed","https://api.mint.gg/problems/manual-action-required","https://api.mint.gg/problems/method-not-allowed","https://api.mint.gg/problems/missing-generation-resource","https://api.mint.gg/problems/missing-item-ids","https://api.mint.gg/problems/model-already-optimized","https://api.mint.gg/problems/model-list-unavailable","https://api.mint.gg/problems/model-lookup-unavailable","https://api.mint.gg/problems/model-not-found","https://api.mint.gg/problems/model-optimization-in-progress","https://api.mint.gg/problems/model-optimization-start-failed","https://api.mint.gg/problems/operation-lookup-unavailable","https://api.mint.gg/problems/operation-not-found","https://api.mint.gg/problems/operation-reservation-failed","https://api.mint.gg/problems/operation-transition-failed","https://api.mint.gg/problems/prompt-revision-required","https://api.mint.gg/problems/pricing-estimate-unavailable","https://api.mint.gg/problems/rate-limited","https://api.mint.gg/problems/reference-image-fetch-failed","https://api.mint.gg/problems/reference-image-too-large","https://api.mint.gg/problems/reference-image-tracking-failed","https://api.mint.gg/problems/reference-image-upload-failed","https://api.mint.gg/problems/regeneration-start-failed","https://api.mint.gg/problems/retopology-start-failed","https://api.mint.gg/problems/retry-start-failed","https://api.mint.gg/problems/route-not-found","https://api.mint.gg/problems/unsupported-reference-image-type","https://api.mint.gg/problems/usage-unavailable","https://api.mint.gg/problems/world-list-unavailable","https://api.mint.gg/problems/world-lookup-unavailable","https://api.mint.gg/problems/world-not-found"],"description":"Stable URI identifying the error category."},"title":{"type":"string","description":"Short error category title."},"status":{"type":"integer","description":"HTTP status code for this error."},"detail":{"type":"string","description":"Developer-readable explanation of this occurrence."},"instance":{"type":"string","format":"uri-reference","description":"Request path or identifier for this occurrence."},"errors":{"type":"array","maxItems":5,"description":"Machine-readable field issues included for request validation failures.","items":{"$ref":"#/components/schemas/ValidationIssue"}},"operationId":{"type":"string","description":"Blocked operation that can be polled and resumed after billing is resolved."},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}}}},"ValidationIssue":{"type":"object","additionalProperties":false,"description":"One invalid request field reported by Mint.","required":["path","code","message"],"properties":{"path":{"type":"string","description":"Field path rooted at body, such as body.prompt or body.sourceImages[0]."},"code":{"type":"string","enum":["custom","invalid_element","invalid_format","invalid_key","invalid_type","invalid_union","invalid_value","not_multiple_of","too_big","too_small","unrecognized_keys"],"description":"Stable validation category supplied by the request schema."},"message":{"type":"string","description":"Developer-readable explanation for this field."}}},"PricingEstimateRequest":{"oneOf":[{"type":"object","additionalProperties":false,"required":["operation"],"properties":{"operation":{"type":"string","const":"world_generation"},"generationPreset":{"type":"string","enum":["fast","standard","production"],"default":"standard","description":"Public generation quality and speed preset."},"generationMode":{"type":"string","enum":["auto","review"],"default":"auto","description":"In review mode, Mint pauses before the conditional final stage."}}},{"type":"object","additionalProperties":false,"required":["operation"],"properties":{"operation":{"type":"string","const":"model_generation"},"generationPreset":{"type":"string","enum":["fast","standard","production"],"default":"standard","description":"Public generation quality and speed preset."},"generationMode":{"type":"string","enum":["auto","review"],"default":"auto","description":"In review mode, Mint pauses before the conditional final stage."}}},{"type":"object","additionalProperties":false,"required":["operation"],"properties":{"operation":{"type":"string","const":"asset_pack_generation"},"generationPreset":{"type":"string","enum":["fast","standard","production"],"default":"standard","description":"Public generation quality and speed preset."},"generationMode":{"type":"string","enum":["auto","review"],"default":"auto","description":"In review mode, Mint pauses before the conditional final stage."},"itemCount":{"type":"integer","minimum":2,"maximum":25,"default":8}}},{"type":"object","additionalProperties":false,"required":["operation"],"properties":{"operation":{"type":"string","const":"material_generation"},"materialMode":{"type":"string","enum":["generate","image_to_maps","extract"],"default":"generate"}}},{"type":"object","additionalProperties":false,"required":["operation"],"properties":{"operation":{"type":"string","const":"material_pack_generation"},"materialMode":{"type":"string","enum":["generate","image_to_maps","extract"],"default":"generate"},"itemCount":{"type":"integer","minimum":2,"maximum":25,"default":5}}},{"type":"object","additionalProperties":false,"required":["operation"],"properties":{"operation":{"type":"string","const":"image_generation"}}},{"type":"object","additionalProperties":false,"required":["operation","imageId"],"properties":{"operation":{"type":"string","const":"image_edit"},"imageId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."}}},{"type":"object","additionalProperties":false,"required":["operation","audioKind"],"properties":{"operation":{"type":"string","const":"audio_generation"},"audioKind":{"type":"string","enum":["sound_effect","general_audio"]},"durationSeconds":{"type":"number","exclusiveMinimum":0,"maximum":300,"description":"Requested duration. Mint returns its normalized billable duration in pricingFactors."}}},{"type":"object","additionalProperties":false,"required":["operation","worldId"],"properties":{"operation":{"type":"string","const":"world_approval"},"worldId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."}}},{"type":"object","additionalProperties":false,"required":["operation","worldId"],"properties":{"operation":{"type":"string","const":"world_revision"},"worldId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"generationMode":{"type":"string","enum":["auto","review"],"default":"auto","description":"In review mode, Mint pauses before the conditional final stage."}}},{"type":"object","additionalProperties":false,"required":["operation","modelId"],"properties":{"operation":{"type":"string","const":"model_approval"},"modelId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."}}},{"type":"object","additionalProperties":false,"required":["operation","modelId"],"properties":{"operation":{"type":"string","const":"model_revision"},"modelId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"generationMode":{"type":"string","enum":["auto","review"],"default":"auto","description":"In review mode, Mint pauses before the conditional final stage."}}},{"type":"object","additionalProperties":false,"required":["operation","assetPackId"],"properties":{"operation":{"type":"string","const":"asset_pack_approval"},"assetPackId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"itemIds":{"type":"array","minItems":1,"maxItems":25,"uniqueItems":true,"items":{"type":"string","minLength":1},"description":"Optional owned Asset Pack item selection."}}},{"type":"object","additionalProperties":false,"required":["operation","assetPackId"],"properties":{"operation":{"type":"string","const":"asset_pack_revision"},"assetPackId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"itemIds":{"type":"array","minItems":1,"maxItems":25,"uniqueItems":true,"items":{"type":"string","minLength":1},"description":"Optional owned Asset Pack item selection."},"generationMode":{"type":"string","enum":["auto","review"],"default":"auto","description":"In review mode, Mint pauses before the conditional final stage."}}},{"type":"object","additionalProperties":false,"required":["operation","worldId"],"properties":{"operation":{"type":"string","const":"world_retry"},"worldId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"default":"standard","description":"Public generation quality and speed preset."},"generationMode":{"type":"string","enum":["auto","review"],"default":"auto","description":"In review mode, Mint pauses before the conditional final stage."}}},{"type":"object","additionalProperties":false,"required":["operation","modelId"],"properties":{"operation":{"type":"string","const":"model_retry"},"modelId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"default":"standard","description":"Public generation quality and speed preset."},"generationMode":{"type":"string","enum":["auto","review"],"default":"auto","description":"In review mode, Mint pauses before the conditional final stage."}}},{"type":"object","additionalProperties":false,"required":["operation","assetPackId"],"properties":{"operation":{"type":"string","const":"asset_pack_retry"},"assetPackId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"itemIds":{"type":"array","minItems":1,"maxItems":25,"uniqueItems":true,"items":{"type":"string","minLength":1},"description":"Optional owned Asset Pack item selection."}}},{"type":"object","additionalProperties":false,"required":["operation","assetPackId"],"properties":{"operation":{"type":"string","const":"asset_pack_regeneration"},"assetPackId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"itemIds":{"type":"array","minItems":1,"maxItems":25,"uniqueItems":true,"items":{"type":"string","minLength":1},"description":"Optional owned Asset Pack item selection."}}},{"type":"object","additionalProperties":false,"required":["operation","modelId"],"properties":{"operation":{"type":"string","const":"model_optimization"},"modelId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"optimizationLevel":{"type":"string","enum":["light","moderate","aggressive"],"default":"moderate"}}},{"type":"object","additionalProperties":false,"required":["operation","modelId"],"properties":{"operation":{"type":"string","const":"model_retopology"},"modelId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"polygonType":{"type":"string","enum":["triangle","quadrilateral"],"default":"quadrilateral"},"faceLevel":{"type":"string","enum":["low","medium","high"],"default":"medium"}}},{"type":"object","additionalProperties":false,"required":["operation","modelId","animationActionCount"],"properties":{"operation":{"type":"string","const":"model_animation"},"modelId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"animationActionCount":{"type":"integer","minimum":1,"maximum":10}}},{"type":"object","additionalProperties":false,"required":["operation","assetPackId","animationActionCount"],"properties":{"operation":{"type":"string","const":"asset_pack_animation"},"assetPackId":{"type":"string","minLength":1,"description":"Owned Mint resource ID used to resolve stored pricing factors."},"itemIds":{"type":"array","minItems":1,"maxItems":25,"uniqueItems":true,"items":{"type":"string","minLength":1},"description":"Optional owned Asset Pack item selection."},"animationActionCount":{"type":"integer","minimum":1,"maximum":10}}}],"discriminator":{"propertyName":"operation"},"description":"Strict operation-discriminated pricing input. Each operation accepts only factors that can affect its planned Credit reservations."},"PricingEstimate":{"type":"object","additionalProperties":false,"description":"Advisory conservative Credit reservations for one normalized public API request.","required":["object","operation","credits","stages","pricingFactors"],"properties":{"object":{"type":"string","const":"pricing_estimate","description":"Stable object discriminator."},"operation":{"type":"string","description":"Public operation discriminator copied from the request."},"credits":{"type":"object","additionalProperties":false,"description":"Credits needed to start and the conservative planned total.","required":["requiredToStart","estimatedTotal"],"properties":{"requiredToStart":{"type":"number","minimum":0,"description":"Credits planned for the first non-conditional stage."},"estimatedTotal":{"type":"number","minimum":0,"description":"Conservative sum of all planned stages, including conditional stages."}}},"stages":{"type":"array","minItems":1,"description":"Planned reservation stages in execution order.","items":{"type":"object","additionalProperties":false,"required":["stage","credits","conditional"],"properties":{"stage":{"type":"string","enum":["preview","final","operation"]},"credits":{"type":"number","minimum":0},"conditional":{"type":"boolean","description":"Whether starting this stage requires a later lifecycle decision."}}}},"pricingFactors":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"number"}]},"description":"Normalized public inputs used by pricing, including defaults and resolved resource configuration."}},"example":{"object":"pricing_estimate","operation":"model_generation","credits":{"requiredToStart":173,"estimatedTotal":798},"stages":[{"stage":"preview","credits":173,"conditional":false},{"stage":"final","credits":625,"conditional":false}],"pricingFactors":{"generationPreset":"standard","generationMode":"auto"}}},"WorldGenerationRequest":{"type":"object","description":"Instructions for creating one World.","required":["prompt"],"additionalProperties":false,"not":{"required":["imageUrl","sourceImages"],"properties":{"imageUrl":{},"sourceImages":{}}},"properties":{"prompt":{"type":"string","minLength":1,"maxLength":8000,"description":"Describe the World Mint should create."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional World title shown in Mint; Mint derives one from the prompt when omitted."},"generationMode":{"enum":["auto","review"],"default":"auto","description":"Workflow behavior. auto is the default and continues to the final asset; review pauses at Preview for approval or revision. See [Preview-based generation](https://docs.mint.gg/developers/api-overview#preview-based-generation)."},"generationPreset":{"enum":["fast","standard","production"],"default":"standard","description":"Quality, speed, and cost tier; Mint selects the underlying generation model."},"imageUrl":{"type":"string","format":"uri","description":"One public HTTPS reference image for visual guidance; do not combine with sourceImages."},"sourceImages":{"type":"array","minItems":2,"maxItems":8,"items":{"type":"string","format":"uri"},"description":"Two to eight public HTTPS reference images used together for visual guidance; do not combine with imageUrl."}}},"ModelGenerationRequest":{"type":"object","description":"Instructions for creating one 3D Model.","required":["prompt"],"additionalProperties":false,"not":{"required":["imageUrl","sourceImages"],"properties":{"imageUrl":{},"sourceImages":{}}},"properties":{"prompt":{"type":"string","minLength":1,"maxLength":8000,"description":"Describe the 3D Model Mint should create."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional 3D Model title shown in Mint; Mint derives one from the prompt when omitted."},"generationMode":{"enum":["auto","review"],"default":"auto","description":"Workflow behavior. auto is the default and continues to the final asset; review pauses at Preview for approval or revision. See [Preview-based generation](https://docs.mint.gg/developers/api-overview#preview-based-generation)."},"generationPreset":{"enum":["fast","standard","production"],"default":"standard","description":"Quality, speed, and cost tier; Mint selects the underlying generation model."},"imageUrl":{"type":"string","format":"uri","description":"One public HTTPS reference image for visual guidance; do not combine with sourceImages."},"sourceImages":{"type":"array","minItems":2,"maxItems":8,"items":{"type":"string","format":"uri"},"description":"Two to eight public HTTPS reference images, such as alternate views of one object; do not combine with imageUrl."},"riggingPose":{"enum":["t_pose","a_pose"],"description":"Prepare a humanoid character Preview in the selected neutral pose with a front-facing full-body view and empty hands. This does not rig or animate the model."}}},"AssetPackGenerationRequest":{"type":"object","description":"A natural-language request for a coordinated Asset Pack. Mint plans the individual assets and shared visual direction.","required":["prompt"],"additionalProperties":false,"not":{"required":["imageUrl","sourceImages"],"properties":{"imageUrl":{},"sourceImages":{}}},"properties":{"prompt":{"type":"string","minLength":1,"maxLength":8000,"description":"Describe the pack in natural language, including its purpose, desired assets, count, or style when relevant. Example: Create 4 assets for a sci-fi game pack."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional Asset Pack title shown in Mint; Mint derives one from the prompt when omitted."},"generationMode":{"enum":["auto","review"],"default":"auto","description":"Workflow behavior. auto is the default and continues to final assets; review pauses at Preview for approval or revision. See [Preview-based generation](https://docs.mint.gg/developers/api-overview#preview-based-generation)."},"generationPreset":{"enum":["fast","standard","production"],"default":"standard","description":"Quality, speed, and cost tier applied across the pack."},"imageUrl":{"type":"string","format":"uri","description":"One public HTTPS reference image shared by the pack; do not combine with sourceImages."},"sourceImages":{"type":"array","minItems":2,"maxItems":8,"items":{"type":"string","format":"uri"},"description":"Two to eight public HTTPS reference images available to pack items; do not combine with imageUrl."},"assetPackType":{"enum":["game_asset_pack","city_asset_pack","character_asset_pack","car_asset_pack","furniture_asset_pack","vegetation_asset_pack","food_asset_pack","animal_asset_pack","aircraft_asset_pack","electronics_asset_pack","industrial_asset_pack","interior_asset_pack","clothing_asset_pack","general_asset_pack"],"description":"Optional category override. Mint otherwise infers the best category from the prompt and falls back to general_asset_pack when no specialized category fits."},"itemCount":{"type":"integer","minimum":2,"maximum":25,"description":"Optional exact number of assets to create. If omitted, Mint follows a count in the prompt; if the prompt has no count, Mint creates 8 assets."},"styleGuide":{"type":"string","minLength":1,"maxLength":4000,"example":"Low-poly sci-fi props with cool gray metal, cyan accents, and soft studio lighting","description":"Optional visual-direction override shared by every asset. Mint infers this from the prompt when omitted."},"riggingPose":{"enum":["t_pose","a_pose"],"description":"Prepare humanoid character items in the selected neutral pose for later rigging; this does not rig or animate them."}}},"MaterialGenerationRequest":{"type":"object","description":"Instructions for creating one Material.","required":["prompt"],"additionalProperties":false,"properties":{"prompt":{"type":"string","minLength":1,"maxLength":8000,"description":"Describe the surface and texture maps Mint should create."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional Material title shown in Mint; Mint derives one from the prompt when omitted."},"generationPreset":{"enum":["fast","standard","production"],"default":"standard","description":"Quality, speed, and cost tier for Material generation."},"imageUrl":{"type":"string","format":"uri","description":"Optional public HTTPS image used as the Material source."},"mode":{"enum":["generate","image_to_maps","extract"],"default":"generate","description":"How Mint should create or derive the Material maps."}}},"MaterialPackGenerationRequest":{"type":"object","description":"Instructions for creating a coordinated Material Pack.","required":["prompt","items"],"additionalProperties":false,"properties":{"prompt":{"type":"string","minLength":1,"maxLength":8000,"description":"Describe the shared purpose of the Material Pack."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional Material Pack title shown in Mint; Mint derives one when omitted."},"generationPreset":{"enum":["fast","standard","production"],"default":"standard","description":"Quality, speed, and cost tier applied across the pack."},"imageUrl":{"type":"string","format":"uri","description":"Optional public HTTPS image shared as source context."},"mode":{"enum":["generate","image_to_maps","extract"],"default":"generate","description":"How Mint should create or derive the Material maps."},"itemCount":{"type":"integer","minimum":2,"maximum":25,"description":"Number of requested Materials; when supplied, it must equal the items array length."},"styleGuide":{"type":"string","minLength":1,"maxLength":4000,"description":"Optional visual rules shared by every Material in the pack."},"items":{"type":"array","minItems":2,"maxItems":25,"description":"The individual Materials Mint should create.","items":{"type":"object","required":["label","prompt"],"additionalProperties":false,"properties":{"label":{"type":"string","minLength":1,"maxLength":80,"description":"Short human-readable label for this Material."},"prompt":{"type":"string","minLength":1,"maxLength":2000,"description":"Material-specific generation instructions."}}}}}},"ImageGenerationRequest":{"type":"object","description":"Instructions for creating one Image.","required":["prompt"],"additionalProperties":false,"properties":{"prompt":{"type":"string","minLength":1,"maxLength":8000,"description":"Describe the Image Mint should create."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional Image title shown in Mint; Mint derives one from the prompt when omitted."},"generationPreset":{"enum":["fast","standard","production"],"default":"standard","description":"Quality, speed, and cost tier for Image generation."}}},"AudioGenerationRequest":{"type":"object","description":"Instructions for creating one Audio asset.","required":["prompt","audioKind"],"additionalProperties":false,"properties":{"prompt":{"type":"string","minLength":1,"maxLength":8000,"description":"Describe the sound, ambience, or music Mint should create."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional Audio title shown in Mint; Mint derives one from the prompt when omitted."},"generationPreset":{"enum":["fast","standard","production"],"default":"standard","description":"Quality, speed, and cost tier for Audio generation."},"audioKind":{"enum":["sound_effect","general_audio"],"description":"Whether to create a short sound effect or general Audio."},"durationSeconds":{"type":"number","exclusiveMinimum":0,"maximum":300,"description":"Requested Audio duration in seconds, up to five minutes."}}},"ImageEditRequest":{"type":"object","description":"Instructions for creating a non-destructive Image edit.","required":["editInstruction"],"additionalProperties":false,"properties":{"editInstruction":{"type":"string","minLength":1,"maxLength":8000,"description":"Describe the change Mint should apply to the source Image."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional title for the new edited Image."},"generationPreset":{"enum":["fast","standard","production"],"default":"standard","description":"Quality, speed, and cost tier for the Image edit."}}},"ReferenceImageUploadRequest":{"type":"object","description":"Import one reusable reference image from a public URL or base64 data.","additionalProperties":false,"properties":{"sourceUrl":{"type":"string","format":"uri","description":"Public HTTPS URL to the image; do not combine with base64Data."},"base64Data":{"type":"string","description":"Base64-encoded image bytes; requires fileName and contentType."},"fileName":{"type":"string","minLength":1,"maxLength":160,"description":"Original file name for a base64 upload."},"contentType":{"type":"string","minLength":1,"maxLength":100,"description":"Image MIME type for a base64 upload."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional reference image title shown in Mint."}}},"AssetPackApproveRequest":{"type":"object","description":"Optionally select Asset Pack Preview items to approve; omit the body to approve all eligible items.","additionalProperties":false,"properties":{"itemIds":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"string"},"description":"Asset Pack item IDs to approve; omit to approve every eligible item."}}},"WorldReviseRequest":{"type":"object","description":"Instructions for revising a World Preview.","required":["feedback"],"additionalProperties":false,"properties":{"feedback":{"type":"string","minLength":1,"maxLength":8000,"description":"Describe the changes Mint should make to the Preview."},"generationMode":{"enum":["auto","review"],"default":"auto","description":"auto continues after the revised Preview; review pauses again for another decision. See [Preview-based generation](https://docs.mint.gg/developers/api-overview#preview-based-generation)."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional replacement title for the World."},"revisionEditStrength":{"enum":["surgical","style","structural"],"description":"How broadly Mint may change the existing Preview."}}},"ModelReviseRequest":{"type":"object","description":"Instructions for revising a 3D Model Preview.","required":["feedback"],"additionalProperties":false,"properties":{"feedback":{"type":"string","minLength":1,"maxLength":8000,"description":"Describe the changes Mint should make to the Preview."},"generationMode":{"enum":["auto","review"],"default":"auto","description":"auto continues after the revised Preview; review pauses again for another decision. See [Preview-based generation](https://docs.mint.gg/developers/api-overview#preview-based-generation)."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional replacement title for the 3D Model."},"revisionEditStrength":{"enum":["surgical","style","structural"],"description":"How broadly Mint may change the existing Preview."},"riggingPose":{"enum":["t_pose","a_pose"],"description":"Prepare the revised humanoid Preview in the selected neutral pose for later rigging."}}},"AssetPackReviseRequest":{"type":"object","description":"Instructions for revising all or selected Asset Pack Previews.","required":["feedback"],"additionalProperties":false,"properties":{"feedback":{"type":"string","minLength":1,"maxLength":8000,"description":"Describe the changes Mint should make to the selected Previews."},"generationMode":{"enum":["auto","review"],"default":"auto","description":"auto continues after revised Previews; review pauses again for another decision. See [Preview-based generation](https://docs.mint.gg/developers/api-overview#preview-based-generation)."},"scope":{"enum":["all_items","items"],"default":"all_items","description":"Whether the revision applies to every item or selected item IDs."},"itemIds":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"string"},"description":"Required when scope is items; ignored for all_items."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional replacement title for the Asset Pack."},"revisionEditStrength":{"enum":["surgical","style","structural"],"description":"How broadly Mint may change the selected Previews."},"riggingPose":{"enum":["t_pose","a_pose"],"description":"Prepare revised humanoid character items in the selected neutral pose for later rigging."}}},"GenerationRetryRequest":{"type":"object","description":"Optional overrides when retrying a failed World or 3D Model generation.","additionalProperties":false,"properties":{"prompt":{"type":"string","minLength":1,"maxLength":8000,"description":"Replacement prompt; required when the prior failure requires prompt changes."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional title for the new retried asset."},"generationMode":{"enum":["auto","review"],"default":"auto","description":"Workflow behavior for the retried generation. auto is the default; review pauses at Preview. See [Preview-based generation](https://docs.mint.gg/developers/api-overview#preview-based-generation)."},"generationPreset":{"enum":["fast","standard","production"],"default":"standard","description":"Quality, speed, and cost tier for the retry."}}},"AssetPackRetryRequest":{"type":"object","description":"Optionally select failed Asset Pack Preview items to retry.","additionalProperties":false,"properties":{"itemIds":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"string"},"description":"Failed item IDs to retry; omit to retry every eligible item."}}},"ModelRetopologyRequest":{"type":"object","description":"Optional settings for creating a retopologized copy of a Mint 3D Model.","additionalProperties":false,"properties":{"polygonType":{"enum":["quadrilateral"],"default":"quadrilateral","description":"Mesh topology to create; quadrilateral topology is currently supported."},"faceLevel":{"enum":["low","medium","high"],"default":"medium","description":"Target mesh detail level for the retopologized copy."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional title for the retopologized 3D Model shown in Mint."}}},"ModelAnimationRequest":{"type":"object","description":"Animation selection and optional sizing for one eligible Mint 3D Model.","additionalProperties":false,"anyOf":[{"required":["animationSetId"]},{"required":["motionPrompt"]}],"properties":{"animationSetId":{"type":"string","description":"Stable curated set ID from GET /v1/animation-sets. Include animationActionIds to select a subset of that set."},"motionPrompt":{"type":"string","minLength":1,"maxLength":2000,"description":"Describe the motion Mint should select; do not combine with animationSetId."},"animationActionIds":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"integer","minimum":0,"maximum":696},"description":"Optional subset of curated action IDs from the selected animationSetId."},"heightMeters":{"type":"number","minimum":0.5,"maximum":3,"description":"Character height in meters used to scale the animation result."}}},"AssetPackAnimationRequest":{"type":"object","description":"Animation selection and optional item targeting for eligible 3D Models in a Mint Asset Pack.","additionalProperties":false,"anyOf":[{"required":["animationSetId"]},{"required":["motionPrompt"]}],"properties":{"animationSetId":{"type":"string","description":"Stable curated set ID from GET /v1/animation-sets. Include animationActionIds to select a subset of that set."},"motionPrompt":{"type":"string","minLength":1,"maxLength":2000,"description":"Describe the motion Mint should select; do not combine with animationSetId."},"animationActionIds":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"integer","minimum":0,"maximum":696},"description":"Optional subset of curated action IDs from the selected animationSetId."},"heightMeters":{"type":"number","minimum":0.5,"maximum":3,"description":"Character height in meters used to scale the animation result."},"scope":{"enum":["all_items","items"],"default":"all_items","description":"Animate all eligible Asset Pack items or only the IDs in itemIds."},"itemIds":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"string"},"description":"Asset Pack item IDs to animate when scope is items."}}},"ArtifactManifestBatchRequest":{"type":"object","description":"Assets whose downloadable artifact manifests should be returned together.","required":["assets"],"additionalProperties":false,"properties":{"assets":{"type":"array","minItems":1,"maxItems":25,"description":"One to 25 Mint-owned assets to resolve.","items":{"type":"object","required":["type","id"],"additionalProperties":false,"properties":{"type":{"enum":["world","model","asset_pack","material","image","audio"],"description":"Mint asset type."},"id":{"type":"string","minLength":1,"maxLength":128,"description":"Mint asset ID owned by the authenticated account."}}}}}},"OperationReviseRequest":{"type":"object","description":"Feedback for revising the Preview associated with this operation.","required":["feedback"],"additionalProperties":false,"properties":{"feedback":{"type":"string","minLength":1,"maxLength":2000,"description":"Describe the changes Mint should make to the current Preview."}}},"ModelOptimizationRequest":{"type":"object","description":"Optional settings for creating an optimized copy of a Mint 3D Model.","additionalProperties":false,"properties":{"optimizationLevel":{"enum":["light","moderate","aggressive"],"default":"moderate","description":"Optimization intensity. light preserves more detail, moderate is the default balance, and aggressive reduces file size most."}}},"ModelConversionRequest":{"type":"object","description":"Choose the downloadable formats Mint should create from this 3D Model.","required":["targetFormats"],"additionalProperties":false,"properties":{"targetFormats":{"type":"array","minItems":1,"maxItems":5,"items":{"enum":["glb","obj","stl","usdz","fbx"]},"description":"Output formats to create. Duplicate values are ignored."},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Optional title used for the conversion output and exported files."}}},"WorldGenerationOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint world.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"world_generation","generationMode":"auto","status":"running","resource":{"type":"world","id":"world_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["world_generation"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"description":"Public generation preset selected for this operation."},"assets":{"$ref":"#/components/schemas/WorldAssets","description":"Generated world files when available."},"resource":{"description":"The Mint asset created by this operation, or null before the asset exists.","oneOf":[{"type":"object","additionalProperties":false,"description":"The Mint world affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"world","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},{"type":"null"}]},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"ModelGenerationOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint model.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"model_generation","generationMode":"auto","status":"running","resource":{"type":"model","id":"model_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["model_generation"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"description":"Public generation preset selected for this operation."},"assets":{"$ref":"#/components/schemas/ModelAssets","description":"Generated model files when available."},"resource":{"description":"The Mint asset created by this operation, or null before the asset exists.","oneOf":[{"type":"object","additionalProperties":false,"description":"The Mint model affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"model","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},{"type":"null"}]},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"AssetPackGenerationOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint asset_pack.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"asset_pack_generation","generationMode":"auto","status":"running","resource":{"type":"asset_pack","id":"asset_pack_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["asset_pack_generation"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"description":"Public generation preset selected for this operation."},"resource":{"description":"The Mint asset created by this operation, or null before the asset exists.","oneOf":[{"type":"object","additionalProperties":false,"description":"The Mint asset_pack affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"asset_pack","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},{"type":"null"}]},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"MaterialGenerationOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint material.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"material_generation","generationMode":"auto","status":"running","resource":{"type":"material","id":"material_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["material_generation"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"description":"Public generation preset selected for this operation."},"resource":{"description":"The Mint asset created by this operation, or null before the asset exists.","oneOf":[{"type":"object","additionalProperties":false,"description":"The Mint material affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"material","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},{"type":"null"}]},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"MaterialPackGenerationOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint material_pack.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"material_pack_generation","generationMode":"auto","status":"running","resource":{"type":"material_pack","id":"material_pack_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["material_pack_generation"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"description":"Public generation preset selected for this operation."},"resource":{"description":"The Mint asset created by this operation, or null before the asset exists.","oneOf":[{"type":"object","additionalProperties":false,"description":"The Mint material_pack affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"material_pack","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},{"type":"null"}]},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"ImageGenerationOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint image.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"image_generation","generationMode":"auto","status":"running","resource":{"type":"image","id":"image_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["image_generation"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"description":"Public generation preset selected for this operation."},"resource":{"description":"The Mint asset created by this operation, or null before the asset exists.","oneOf":[{"type":"object","additionalProperties":false,"description":"The Mint image affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"image","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},{"type":"null"}]},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"AudioGenerationOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint audio.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"audio_generation","generationMode":"auto","status":"running","resource":{"type":"audio","id":"audio_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["audio_generation"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"description":"Public generation preset selected for this operation."},"resource":{"description":"The Mint asset created by this operation, or null before the asset exists.","oneOf":[{"type":"object","additionalProperties":false,"description":"The Mint audio affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"audio","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},{"type":"null"}]},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"WorldTransitionOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint world.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"generation_transition","generationMode":"review","status":"running","resource":{"type":"world","id":"world_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["generation_transition"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint world affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"world","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"WorldRetryOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint world.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"generation_retry","generationMode":"auto","status":"running","resource":{"type":"world","id":"world_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["generation_retry"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"description":"Public generation preset selected for this operation."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint world affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"world","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"ModelTransitionOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint model.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"generation_transition","generationMode":"review","status":"running","resource":{"type":"model","id":"model_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["generation_transition"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint model affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"model","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"ModelRetryOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint model.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"generation_retry","generationMode":"auto","status":"running","resource":{"type":"model","id":"model_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["generation_retry"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"description":"Public generation preset selected for this operation."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint model affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"model","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"ModelRetopologyOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint model.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"model_retopology","generationMode":"auto","status":"running","resource":{"type":"model","id":"model_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["model_retopology"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"optimizationLevel":{"type":"string","enum":["light","moderate","aggressive"],"description":"Requested topology reduction strength."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint model affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"model","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"ModelOptimizationOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint model.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"model_optimization","generationMode":"auto","status":"running","resource":{"type":"model","id":"model_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["model_optimization"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"optimizationLevel":{"type":"string","enum":["light","moderate","aggressive"],"description":"Requested topology reduction strength."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint model affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"model","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"ModelConversionOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint model.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"model_conversion","generationMode":"auto","status":"running","resource":{"type":"model","id":"model_01JEXAMPLE"},"conversion":{"id":"conversion_01JEXAMPLE","assets":null},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["model_conversion"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"conversion":{"$ref":"#/components/schemas/OperationConversion","description":"Conversion job and its downloadable outputs."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint model affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"model","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"AssetPackTransitionOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint asset_pack.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"generation_transition","generationMode":"review","status":"running","resource":{"type":"asset_pack","id":"asset_pack_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["generation_transition"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Developer-supplied generation brief or revision feedback."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint asset_pack affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"asset_pack","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"AssetPackRetryOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint asset_pack.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"generation_retry","generationMode":"auto","status":"running","resource":{"type":"asset_pack","id":"asset_pack_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["generation_retry","asset_pack_regeneration"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint asset_pack affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"asset_pack","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"ImageLifecycleOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint image.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"image_edit","generationMode":"auto","status":"running","resource":{"type":"image","id":"image_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["image_edit"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint image affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","const":"image","description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"ModelAnimationOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint animation.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"model_animation","generationMode":"auto","status":"running","resource":{"type":"animation","id":"animation_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["model_animation"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint animation affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","enum":["animation","model"],"description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"AssetPackAnimationOperation":{"type":"object","additionalProperties":false,"description":"A long-running operation acting on one Mint animation.","example":{"object":"operation","id":"op_01JEXAMPLE","type":"model_animation","generationMode":"auto","status":"running","resource":{"type":"animation","id":"animation_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint operation ID used for polling."},"type":{"type":"string","enum":["model_animation"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Workflow mode for this operation."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"resource":{"type":"object","additionalProperties":false,"description":"The Mint animation affected by this operation.","required":["type","id"],"properties":{"type":{"type":"string","enum":["animation","asset_pack"],"description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"Operation":{"type":"object","additionalProperties":false,"example":{"object":"operation","id":"op_01JEXAMPLE","type":"world_generation","generationMode":"auto","status":"running","resource":{"type":"world","id":"world_01JEXAMPLE"},"createdAt":"2026-07-21T20:00:00.000Z","updatedAt":"2026-07-21T20:00:01.000Z"},"required":["object","id","type","generationMode","status","resource","createdAt","updatedAt"],"properties":{"object":{"type":"string","const":"operation","description":"Stable object discriminator for an asynchronous operation."},"id":{"type":"string","description":"Mint operation ID used for polling and lifecycle calls."},"type":{"type":"string","enum":["world_generation","model_generation","asset_pack_generation","material_generation","material_pack_generation","image_generation","image_edit","audio_generation","reference_image_upload","generation_retry","generation_transition","model_optimization","model_retopology","model_animation","asset_pack_regeneration","model_conversion"],"description":"The work this operation performs."},"generationMode":{"type":"string","enum":["auto","review"],"description":"Generation workflow mode. auto continues to the asset; review pauses at preview_ready. See [Preview-based generation](https://docs.mint.gg/developers/api-overview#preview-based-generation)."},"status":{"type":"string","enum":["queued","running","preview_ready","billing_required","succeeded","partially_succeeded","failed","canceled"],"description":"Current operation lifecycle status."},"prompt":{"type":"string","description":"Original developer-visible prompt or revision feedback, when this operation has one."},"generationPreset":{"type":"string","enum":["fast","standard","production"],"description":"Mint generation tier selected for this operation, when applicable."},"optimizationLevel":{"type":"string","enum":["light","moderate","aggressive"],"description":"Optimization intensity for model_optimization operations."},"resource":{"description":"The Mint asset created or changed by this operation, or null before an asset exists.","oneOf":[{"type":"object","additionalProperties":false,"required":["type","id"],"properties":{"type":{"type":"string","enum":["world","model","asset_pack","material","material_pack","image","audio","reference_image","animation"],"description":"Mint resource type."},"id":{"type":"string","description":"Mint resource ID."}}},{"type":"null"}]},"assets":{"$ref":"#/components/schemas/GenerationAssets","description":"Generation asset URLs when available."},"billing":{"type":"object","additionalProperties":false,"description":"The billing action required before this operation can continue.","required":["reason","resource","stage","requiredCredits","actionUrl"],"properties":{"reason":{"type":"string","enum":["subscription_required","past_due","quota_exhausted_upgrade_available","quota_exhausted_top_tier","insufficient_credits","insufficient_completion_credits"]},"resource":{"type":"string","enum":["preview","world","model","asset_pack","material","material_pack","image","audio"]},"stage":{"type":"string","enum":["preview","final"]},"requiredCredits":{"type":"number","minimum":0},"availableCredits":{"type":"number","minimum":0},"committedCredits":{"type":"number","minimum":0},"stageCredits":{"type":"number","minimum":0},"completionCredits":{"type":"number","minimum":0},"ctaKind":{"type":"string","enum":["view_plans","upgrade_plan","buy_top_up_credits"]},"actionUrl":{"type":"string","format":"uri","description":"Platform billing URL where the developer can add Credits or subscribe."}}},"credits":{"type":"object","additionalProperties":false,"description":"Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.","required":["estimated","reserved","finalized","availableAfterReservation"],"properties":{"estimated":{"type":["number","null"],"minimum":0,"description":"Current best estimate for all requested stages of this operation."},"reserved":{"type":"number","minimum":0,"description":"Credits currently reserved for unfinished work."},"finalized":{"type":"number","minimum":0,"description":"Credits finalized for completed provider work."},"availableAfterReservation":{"type":["number","null"],"minimum":0,"description":"Account Credits remaining after the latest reservation or settlement update."}}},"conversion":{"description":"Model conversion result when this is a model_conversion operation.","$ref":"#/components/schemas/OperationConversion"},"error":{"type":"object","additionalProperties":false,"description":"Terminal failure details when the operation failed.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code."},"message":{"type":"string","description":"Developer-readable failure explanation."}}},"createdAt":{"type":"string","format":"date-time","description":"When the operation was created."},"updatedAt":{"type":"string","format":"date-time","description":"When the operation last changed."},"completedAt":{"type":"string","format":"date-time","description":"When the operation completed."},"canceledAt":{"type":"string","format":"date-time","description":"When the operation was canceled."}}},"OperationConversion":{"type":"object","description":"Conversion job and its downloadable outputs.","required":["id","assets"],"properties":{"id":{"type":["string","null"],"description":"Internal conversion result ID, or null until conversion begins."},"assets":{"description":"Converted model URLs and artifact metadata, or null until available.","oneOf":[{"$ref":"#/components/schemas/ConvertedModelAssets"},{"type":"null"}]}}},"ConvertedModelAssets":{"type":"object","description":"Download URLs produced by a model conversion.","properties":{"glbUrl":{"type":["string","null"],"format":"uri","description":"Converted GLB URL when GLB conversion output is available."},"objUrl":{"type":["string","null"],"format":"uri","description":"Converted OBJ download URL when requested and available."},"stlUrl":{"type":["string","null"],"format":"uri","description":"Converted STL download URL when requested and available."},"usdzUrl":{"type":["string","null"],"format":"uri","description":"Converted USDZ download URL when requested and available."},"fbxUrl":{"type":["string","null"],"format":"uri","description":"Converted FBX download URL when requested and available."},"artifacts":{"description":"Detailed metadata for each converted artifact.","oneOf":[{"$ref":"#/components/schemas/ConvertedModelArtifacts"},{"type":"null"}]}}},"ConvertedModelArtifacts":{"type":"object","description":"Converted artifact metadata keyed by file format.","properties":{"glb":{"$ref":"#/components/schemas/ConvertedModelArtifact","description":"GLB artifact metadata when requested."},"obj":{"$ref":"#/components/schemas/ConvertedModelArtifact","description":"OBJ artifact metadata when requested."},"stl":{"$ref":"#/components/schemas/ConvertedModelArtifact","description":"STL artifact metadata when requested."},"usdz":{"$ref":"#/components/schemas/ConvertedModelArtifact","description":"USDZ artifact metadata when requested."},"fbx":{"$ref":"#/components/schemas/ConvertedModelArtifact","description":"FBX artifact metadata when requested."}}},"ConvertedModelArtifact":{"type":"object","description":"One downloadable converted model artifact.","required":["format","url","filename","contentType","extension","byteSize","packaging","artifactVersion","primaryPath"],"properties":{"format":{"enum":["glb","obj","stl","usdz","fbx"],"description":"Requested model format."},"url":{"type":"string","format":"uri","description":"Download URL for this artifact."},"filename":{"type":"string","description":"Suggested download filename."},"contentType":{"type":"string","description":"Artifact MIME type."},"extension":{"type":"string","description":"Filename extension without a leading dot."},"byteSize":{"type":"integer","minimum":0,"description":"Artifact size in bytes."},"packaging":{"enum":["single_file","zip"],"description":"Whether the URL downloads one file or a ZIP package."},"artifactVersion":{"type":"integer","minimum":1,"description":"Version of Mint's artifact packaging contract."},"primaryPath":{"type":"string","description":"Primary model path inside the download or ZIP package."}}},"WorldAssets":{"type":"object","description":"Downloadable files and previews for a World.","required":["caption","colliderMeshUrl","panoUrl","previewImageUrl","radUrl","spzUrls","thumbnailUrl"],"properties":{"caption":{"type":["string","null"],"description":"Generated World caption, when available."},"colliderMeshUrl":{"type":["string","null"],"format":"uri","description":"Collider mesh download URL, when available."},"panoUrl":{"type":["string","null"],"format":"uri","description":"Panorama image URL, when available."},"previewImageUrl":{"type":["string","null"],"format":"uri","description":"World Preview image URL, when available."},"radUrl":{"type":["string","null"],"format":"uri","description":"RAD splat download URL, when available."},"spzUrls":{"type":["object","null"],"additionalProperties":{"type":"string","format":"uri"},"description":"SPZ splat URLs keyed by quality or variant, when available."},"thumbnailUrl":{"type":["string","null"],"format":"uri","description":"World thumbnail URL, when available."}}},"ModelAssets":{"type":"object","description":"Downloadable files and previews for a 3D Model.","required":["fbxUrl","glbUrl","glbSizeBytes","objUrl","optimizedGlbUrl","optimizedGlbSizeBytes","previewImageUrl","stlUrl","thumbnailUrl","usdzUrl"],"properties":{"fbxUrl":{"type":["string","null"],"format":"uri","description":"FBX download URL, when available."},"glbUrl":{"type":["string","null"],"format":"uri","description":"Canonical GLB URL for the generated model. For new generations this is Y-up and +Z-forward; it may be a Mint-normalized CDN copy when provider output required orientation correction."},"glbSizeBytes":{"type":["integer","null"],"minimum":0,"description":"GLB size in bytes, when known."},"objUrl":{"type":["string","null"],"format":"uri","description":"OBJ download URL, when available."},"optimizedGlbUrl":{"type":["string","null"],"format":"uri","description":"Optimized GLB download URL, when available."},"optimizedGlbSizeBytes":{"type":["integer","null"],"minimum":0,"description":"Optimized GLB size in bytes, when known."},"previewImageUrl":{"type":["string","null"],"format":"uri","description":"3D Model Preview image URL, when available."},"stlUrl":{"type":["string","null"],"format":"uri","description":"STL download URL, when available."},"thumbnailUrl":{"type":["string","null"],"format":"uri","description":"3D Model thumbnail URL, when available."},"usdzUrl":{"type":["string","null"],"format":"uri","description":"USDZ download URL, when available."}}},"GenerationAssets":{"oneOf":[{"$ref":"#/components/schemas/WorldAssets"},{"$ref":"#/components/schemas/ModelAssets"}]},"Pagination":{"type":"object","description":"Cursor pagination state for a list response.","required":["nextCursor","hasMore"],"properties":{"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, or null at the end."},"hasMore":{"type":"boolean","description":"Whether another page is available."}}},"PublicResourceOperation":{"type":"object","description":"Current workflow information for this asset.","properties":{"workflowStage":{"type":["string","null"],"description":"Current asset workflow stage, when known."},"lastError":{"type":["string","null"],"description":"Most recent workflow error, or null."}}},"World":{"type":"object","description":"An account-owned Mint World.","required":["object","id","name","status","assetStage","operation","mintUrl","assets"],"properties":{"object":{"const":"world","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint World ID."},"name":{"type":["string","null"],"description":"World title shown in Mint."},"status":{"type":["string","null"],"description":"Current World processing status."},"assetStage":{"enum":["preview","final",null],"description":"Whether the available asset is a Preview or final World."},"operation":{"$ref":"#/components/schemas/PublicResourceOperation","description":"Current workflow information for this World."},"mintUrl":{"type":"string","format":"uri","description":"Human-facing link to open this World in Mint."},"assets":{"description":"World download URLs, or null before files are available.","oneOf":[{"$ref":"#/components/schemas/WorldAssets"},{"type":"null"}]},"createdAt":{"type":["string","null"],"format":"date-time","description":"When the World was created."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"When the World last changed."}}},"WorldList":{"type":"object","description":"A page of account-owned Mint Worlds.","required":["data","pagination"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/World"},"description":"Worlds in this page."},"pagination":{"$ref":"#/components/schemas/Pagination","description":"Pagination state for this page."}}},"Model":{"type":"object","description":"An account-owned Mint 3D Model.","required":["object","id","name","status","assetStage","operation","mintUrl","assets"],"properties":{"object":{"const":"model","description":"Stable object discriminator."},"id":{"type":"string","description":"Mint 3D Model ID."},"name":{"type":["string","null"],"description":"3D Model title shown in Mint."},"status":{"type":["string","null"],"description":"Current 3D Model processing status."},"assetStage":{"enum":["preview","final",null],"description":"Whether the available asset is a Preview or final 3D Model."},"operation":{"$ref":"#/components/schemas/PublicResourceOperation","description":"Current workflow information for this 3D Model."},"mintUrl":{"type":"string","format":"uri","description":"Human-facing link to open this 3D Model in Mint."},"assets":{"description":"3D Model download URLs, or null before files are available.","oneOf":[{"$ref":"#/components/schemas/ModelAssets"},{"type":"null"}]},"createdAt":{"type":["string","null"],"format":"date-time","description":"When the 3D Model was created."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"When the 3D Model last changed."}}},"ModelList":{"type":"object","description":"A page of account-owned Mint 3D Models.","required":["data","pagination"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Model"},"description":"3D Models in this page."},"pagination":{"$ref":"#/components/schemas/Pagination","description":"Pagination state for this page."}}},"LibraryAsset":{"type":"object","description":"One account-owned asset from the Mint library.","required":["object","type","id"],"properties":{"object":{"const":"asset","description":"Stable object discriminator."},"type":{"enum":["world","model","asset_pack","material","material_pack","image","audio","reference_image"],"description":"Mint asset type."},"id":{"type":"string","description":"Mint asset ID."},"name":{"type":["string","null"],"description":"Asset title shown in Mint."},"status":{"type":["string","null"],"description":"Current asset status, when available."},"thumbnailUrl":{"type":["string","null"],"format":"uri","description":"Asset thumbnail URL, when available."},"createdAt":{"type":["string","null"],"format":"date-time","description":"When the asset was created."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"When the asset last changed."},"items":{"type":"array","items":{"$ref":"#/components/schemas/PackItem"},"description":"Asset Pack or Material Pack items, when applicable."}},"additionalProperties":true},"PackItem":{"type":"object","description":"One publicly addressable item in an Asset Pack or Material Pack.","required":["id"],"properties":{"id":{"type":"string","description":"Stable public pack item ID."},"index":{"type":["integer","null"],"description":"Zero-based item position."},"displayName":{"type":["string","null"],"description":"Item title shown in Mint."},"itemPrompt":{"type":["string","null"],"description":"Prompt used for this item."},"status":{"type":["string","null"],"description":"Current item status."},"previewImageUrl":{"type":["string","null"],"format":"uri","description":"Item Preview image URL, when available."},"modelId":{"type":["string","null"],"description":"Generated 3D Model ID, when applicable."},"materialId":{"type":["string","null"],"description":"Generated Material ID, when applicable."},"errorMessage":{"type":["string","null"],"description":"Safe item failure summary, when applicable."}},"additionalProperties":true},"LibraryAssetList":{"type":"object","description":"A page of account-owned Mint assets.","required":["data","pagination"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/LibraryAsset"},"description":"Assets in this page."},"pagination":{"$ref":"#/components/schemas/Pagination","description":"Pagination state for this page."}}},"DeveloperAccount":{"type":"object","description":"Authenticated Mint developer account and API key identity.","required":["apiKey","owner"],"properties":{"apiKey":{"type":"object","description":"API key used for this request.","required":["id","name","environment","publicPrefix"],"properties":{"id":{"type":"string","description":"Mint API key ID."},"name":{"type":"string","description":"Developer-assigned API key name."},"environment":{"enum":["live","test"],"description":"Whether this is a live or test API key."},"publicPrefix":{"type":"string","description":"Non-secret prefix useful for identifying the key."}}},"owner":{"type":"object","description":"Mint account that owns the API key and created assets.","required":["userId","email"],"properties":{"userId":{"type":"string","description":"Public identifier for the Mint account."},"email":{"type":["string","null"],"format":"email","description":"Mint account email, when available."}}}}},"CreditSummary":{"type":"object","description":"Available, used, and pending Credits for the Mint account.","required":["totalAvailable","monthlyRemaining","monthlyAllowance","monthlyUsed","topUpBalance","totalReserved","monthlyReserved","topUpReserved"],"properties":{"totalAvailable":{"type":"number","description":"Credits currently available to start new work."},"monthlyRemaining":{"type":"number","description":"Unused Credits in the current monthly allowance."},"monthlyAllowance":{"type":"number","description":"Total Credits granted for the current monthly period."},"monthlyUsed":{"type":"number","description":"Monthly allowance Credits consumed in the current period."},"topUpBalance":{"type":"number","description":"Purchased top-up Credits currently available."},"totalReserved":{"type":"number","description":"Credits currently reserved by in-progress work."},"monthlyReserved":{"type":"number","description":"Reserved Credits allocated from the current monthly allowance."},"topUpReserved":{"type":"number","description":"Reserved Credits allocated from the top-up balance."}}},"ApiUsage":{"type":"object","description":"Aggregate API operation counts and Credits used by this account.","required":["requestCount","succeededCount","failedCount","previewReadyCount","creditsUsed"],"properties":{"requestCount":{"type":"number","description":"Total admitted API operations, including operations blocked by billing."},"succeededCount":{"type":"number","description":"API operations that succeeded."},"failedCount":{"type":"number","description":"Terminal operations with status failed. Validation errors and billing_required operations are excluded."},"previewReadyCount":{"type":"number","description":"API operations currently waiting for a review decision."},"creditsUsed":{"type":"number","description":"Finalized Credits consumed by API operations."}}},"Usage":{"type":"object","description":"Mint account Credits, subscription, and API usage summary.","required":["object","credits","subscription","apiUsage"],"properties":{"object":{"const":"usage","description":"Stable object discriminator."},"credits":{"$ref":"#/components/schemas/CreditSummary","description":"Account Credit balances and pending reservations."},"subscription":{"description":"Current Mint subscription, or null when no subscription is active.","oneOf":[{"type":"object","required":["tier","status","currentPeriodEnd"],"properties":{"tier":{"type":["string","null"],"description":"Mint subscription tier."},"status":{"type":["string","null"],"description":"Current subscription billing status."},"currentPeriodEnd":{"type":["string","null"],"format":"date-time","description":"End of the current subscription period, when available."}}},{"type":"null"}]},"apiUsage":{"$ref":"#/components/schemas/ApiUsage","description":"Aggregate API usage for this account."}}}}}}