Skip to main content
POST
/
v1
/
models
/
{modelId}
:optimize
Start a model optimization operation
curl --request POST \
  --url https://api.mint.gg/v1/models/{modelId}:optimize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "optimizationLevel": "moderate"
}
'
{
  "object": "<unknown>",
  "id": "<string>",
  "prompt": "<string>",
  "generationModel": "<string>",
  "resource": {
    "id": "<string>"
  },
  "mintUrl": "<string>",
  "assets": {
    "caption": "<string>",
    "colliderMeshUrl": "<string>",
    "panoUrl": "<string>",
    "previewImageUrl": "<string>",
    "radUrl": "<string>",
    "spzUrls": {},
    "thumbnailUrl": "<string>"
  },
  "conversion": {
    "id": "<string>",
    "assets": {
      "glbUrl": "<string>",
      "objUrl": "<string>",
      "stlUrl": "<string>",
      "usdzUrl": "<string>",
      "fbxUrl": "<string>",
      "artifacts": {
        "glb": {
          "url": "<string>",
          "filename": "<string>",
          "contentType": "<string>",
          "extension": "<string>",
          "byteSize": 1,
          "artifactVersion": 2,
          "primaryPath": "<string>"
        },
        "obj": {
          "url": "<string>",
          "filename": "<string>",
          "contentType": "<string>",
          "extension": "<string>",
          "byteSize": 1,
          "artifactVersion": 2,
          "primaryPath": "<string>"
        },
        "stl": {
          "url": "<string>",
          "filename": "<string>",
          "contentType": "<string>",
          "extension": "<string>",
          "byteSize": 1,
          "artifactVersion": 2,
          "primaryPath": "<string>"
        },
        "usdz": {
          "url": "<string>",
          "filename": "<string>",
          "contentType": "<string>",
          "extension": "<string>",
          "byteSize": 1,
          "artifactVersion": 2,
          "primaryPath": "<string>"
        },
        "fbx": {
          "url": "<string>",
          "filename": "<string>",
          "contentType": "<string>",
          "extension": "<string>",
          "byteSize": 1,
          "artifactVersion": 2,
          "primaryPath": "<string>"
        }
      }
    }
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "completedAt": "2023-11-07T05:31:56Z",
  "canceledAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Mint API key sent as a Bearer token.

Headers

​
Idempotency-Key
string
required

Unique key for safely retrying a mutating API request. Reusing a key with different parameters returns 409.

Required string length: 1 - 255

Path Parameters

​
modelId
string
required

Body

application/json
​
optimizationLevel
enum<string>
default:moderate

Optimization intensity. light preserves more detail, moderate is the default balance, and aggressive reduces file size most.

Available options:
light,
moderate,
aggressive

Response

Long-running operation accepted. Poll the Location URL for status.

​
object
any
required
​
id
string
required
​
type
enum<string>
required
Available options:
world_generation,
model_generation,
model_optimization,
model_conversion
​
generationMode
enum<string>
required
Available options:
auto,
review
​
status
enum<string>
required
Available options:
queued,
running,
preview_ready,
succeeded,
failed,
canceled
​
prompt
string | null
required

Original developer-visible prompt submitted with the generation request. Null for conversion operations.

​
generationPreset
enum<string> | null
required

Mint generation tier selected for this operation. Null for conversion operations.

Available options:
fast,
standard,
production,
null
​
generationModel
string | null
required

Resolved final generation model selected by the generationPreset. Null for conversion operations.

​
optimizationLevel
enum<string> | null
required

Optimization intensity for model_optimization operations.

Available options:
light,
moderate,
aggressive,
null
​
resource
object | null
required
​
mintUrl
string<uri> | null
required

Mint app URL for the generated world or model when the operation has a resource.

​
assets
object
required
​
conversion
object | null
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
error
object | null
​
completedAt
string<date-time> | null
​
canceledAt
string<date-time> | null