Thrixel API

Edit

Apply a natural-language edit to an existing model, optionally scoped to specific parts.

Apply a natural-language edit to an existing model. Example: "make the lantern glow blue". Part-scoped edits work best on Architect results, which carry an editable part hierarchy.

Modify a model

POST /api/v1/edit/submit

Requires API key.

Request Body

NameTypeDescription
parent_submission_idstring (required)ID of the submission to modify.
modification_requeststring (required)Description of the change to apply.
project_idstringInherit or override the parent's project.
adaptive_thinkingbooleanEnable extended thinking for higher quality. Default: false.
focus_on_node_namesstring[]Part names from the parent mesh to scope the edit to. Every part outside the list is held bit-identical. Empty/omitted = whole-mesh edit. Get part names from /api/v1/{submission_id}/hierarchy.

Example Request

curl -X POST https://api.thrixel.com/api/v1/edit/submit \
  -H "Authorization: Bearer sk-thrixel-<YOUR_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "parent_submission_id": "a1b2c3d4-...",
    "modification_request": "make the lantern glow blue"
  }'

Example Response

{
  "submission_id": "c3d4e5f6-...",
  "status": "queued",
  "created_at": "2026-04-20T14:38:01Z"
}

On this page