mint:generate:start
Revise a Modeler model
revise_modeler_model
Create a new version of an owned successful Modeler model. Keep the original and continue its session. Revisions reserve their chosen tier's price and require a new request ID.
Parameters
Input schema generated from the registry. Required parameters are tagged.
- prompt
string
- reference_image_ids
array
referenceAssetId values returned by upload_reference_image (not its imageUrl). The upload needs a project_id; any owned Project works.
- quality_tier
"low" | "medium" | "high" | "max"
Low reserves 2,000 Credits, Medium 8,000, High (default) 25,000, Max 100,000. Choose the user's tier before spending.
- max_creditsrequired
integer
User-authorized Credit ceiling. Must cover the tier's price. Only the tier's price is reserved; actual usage up to that price is charged.
- request_idrequired
string
Stable unique ID for this request, such as a UUID. Reuse it with identical inputs after a timeout; use a new ID for new work.
- conversation_id
string
Existing owned Modeler session. Omit to create a session.
- model_idrequired
string
Successful owned Modeler model to revise. The original is preserved.
Example request
{
"model_id": "mn785pg330fdx30ty4achjv80985ne5z",
"prompt": "Change the shade to blue",
"quality_tier": "low",
"max_credits": 2000,
"request_id": "blue-lamp-001"
}Example response
{
"id": "modelerrevision456",
"status": "queued",
"resource": {
"type": "model",
"id": "revisedmodel456"
},
"modeler": {
"stage": "queued",
"parentModelId": "mn785pg330fdx30ty4achjv80985ne5z",
"maxCredits": 2000,
"billingState": "pending"
},
"credits": {
"reserved": 2000,
"finalized": null
},
"pollIntervalMs": 10000,
"nextSteps": [
{
"tool": "get_modeler_operation",
"input": {
"operation_id": "modelerrevision456"
}
}
]
}Use cases
- Refine a delivered Modeler object while preserving the earlier version.
Related Mint workflow
Mint Modeler →