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

# Character Image Sheet

> Generates a multi-pose character sheet from one prompt or reference image

## Request body

`multipart/form-data`

* `character_image` (`file`, optional): Character image input, max `15MB`
* `character_prompt` (`string`, optional): Text prompt to define the character
* `webhook_url` (`string`, optional): Must be a valid URL
* `resolution` (`"2K" | "4K"`, optional): Defaults to `"2K"`

## Validation rules

* You must provide at least one of:
  * `character_image`
  * `character_prompt`
* If both are missing, validation fails with:
  * `"Must provide character_image or character_prompt."`


## OpenAPI

````yaml POST /v2/image-utils/character-image-sheet
openapi: 3.1.0
info:
  title: TokenKit
  description: >-
    Building image agents and tools, with APIs for businesses that want to put
    them to work.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.tokenkit.co
security:
  - bearerAuth: []
paths:
  /v2/image-utils/character-image-sheet:
    post:
      description: Create a character image sheet from an uploaded image or prompt.
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/CreateCharacterImageSheetRequest'
      responses:
        '202':
          description: Job accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobAccepted'
        '400':
          description: Validation error
        '429':
          description: Queue saturated
components:
  schemas:
    CreateCharacterImageSheetRequest:
      type: object
      properties:
        character_image:
          $ref: '#/components/schemas/FileOrUrl'
        character_prompt:
          type: string
        webhook_url:
          type: string
          format: uri
          description: Must be a valid URL
        resolution:
          $ref: '#/components/schemas/ImageResolution'
      anyOf:
        - required:
            - character_image
        - required:
            - character_prompt
    JobAccepted:
      type: object
      properties:
        data:
          type: object
          properties:
            job_id:
              type: string
              example: job_123
            links:
              $ref: '#/components/schemas/JobLinks'
          required:
            - job_id
            - links
        errors:
          nullable: true
      required:
        - data
    FileOrUrl:
      oneOf:
        - type: string
          format: binary
        - type: string
          format: uri
    ImageResolution:
      type: string
      enum:
        - 2K
        - 4K
      default: 2K
    JobLinks:
      type: object
      properties:
        self:
          type: string
          example: /v1/jobs/job_123
        stream:
          type: string
          example: /v1/jobs/job_123/stream
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````