Render a Character Look fit reference

look_image_generate: permissions and generated input/output contracts.

look_image_generate · Gateway release 0.8.3

Generate one composite fit image through the existing Studio image workflow using one Character identity image and every selected reference for each Artifact. Preserve identity, voice and old shots. Freeze the originating Production/shot and recipe before enqueueing. Display the completed image and select it after inspection. No paid automatic retries or silent reference truncation.

Required scopes: account:read, studio:generate. Changes saved state or requests work; review the operation’s effects.

Availability depends on runtime configuration and the permissions granted to this connection. Use live MCP discovery as the authority.

​

Input

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "storyworldId": {
      "type": "string",
      "pattern": "^[a-fA-F0-9]{24}$",
      "description": "ID of an accessible saved Storyworld returned by discovery. Keep this destination fixed for the operation."
    },
    "lookId": {
      "type": "string",
      "pattern": "^[a-fA-F0-9]{24}$",
      "description": "ID of the saved Character Look recipe, distinct from its generated image or selected version."
    },
    "expectedVersion": {
      "type": "integer",
      "minimum": 1,
      "description": "Copy the current version from the latest workflow read. Refresh after a conflict; never increment or guess it."
    },
    "operationId": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9-]{16,64}$",
      "description": "Persist a client-generated UUID before this mutation. Repeat identical inputs and this same ID after interruption; a new ID is a new request."
    },
    "direction": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "aspect": {
      "enum": [
        "1:1",
        "16:9",
        "9:16"
      ]
    },
    "production": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "productionId": {
          "type": "string",
          "pattern": "^[a-fA-F0-9]{24}$",
          "description": "ID of the saved Production whose asset context must remain pinned."
        },
        "expectedVersion": {
          "type": "integer",
          "minimum": 1,
          "description": "Copy the current version from the latest workflow read. Refresh after a conflict; never increment or guess it."
        },
        "bindingId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "shotId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "description": "Exact originating shot ID; navigation must not retarget an admitted generation."
        }
      },
      "required": [
        "productionId",
        "expectedVersion"
      ],
      "description": "Optional originating Production context to freeze. Does not implicitly attach the result to a shot."
    }
  },
  "required": [
    "storyworldId",
    "lookId",
    "expectedVersion",
    "operationId"
  ]
}

​

Declared output

This is the declared success schema. Error results and binary media blocks are separate MCP protocol results.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string",
      "const": "1"
    },
    "jobId": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    },
    "status": {
      "type": "string"
    }
  },
  "required": [
    "schemaVersion",
    "jobId",
    "status"
  ],
  "additionalProperties": {}
}

All tools · Permissions · Media and recovery