> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sia.vision/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```json theme={null}
{
  "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.

```json theme={null}
{
  "$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](https://docs.sia.vision/mcp-reference.md) · [Permissions](https://docs.sia.vision/authentication.md) · [Media and recovery](https://docs.sia.vision/media-and-recovery.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.