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

# Render a gendered realistic avatar

> Deterministically select a realistic portrait from the requested gender in the current catalog without storing the seed. Catalog changes may remap existing seeds.



## OpenAPI

````yaml /openapi.yaml get /v1/avatars/realistic/{gender}/{seed}.{format}
openapi: 3.1.0
info:
  title: Pictum API
  version: 1.0.0
  description: Render public assets
  license:
    name: MIT
    identifier: MIT
servers:
  - url: https://pictum.dev
    description: Production API
security: []
tags:
  - name: Icons
    description: Browse and render the icon catalog.
  - name: Avatars
    description: Render generated avatars or select seeded realistic portraits.
  - name: QR codes
    description: Render Base64-encoded text as deterministic QR code images.
  - name: Placeholders
    description: Render exact-size placeholder images with optional text and colors.
paths:
  /v1/avatars/realistic/{gender}/{seed}.{format}:
    get:
      tags:
        - Avatars
      summary: Render a gendered realistic avatar
      description: >-
        Deterministically select a realistic portrait from the requested gender
        in the current catalog without storing the seed. Catalog changes may
        remap existing seeds.
      operationId: renderGenderedRealisticAvatar
      parameters:
        - $ref: '#/components/parameters/RealisticAvatarGender'
        - $ref: '#/components/parameters/RealisticAvatarSeed'
        - $ref: '#/components/parameters/RealisticAvatarFormat'
      responses:
        '200':
          $ref: '#/components/responses/RealisticAvatarImage'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    RealisticAvatarGender:
      name: gender
      in: path
      required: true
      description: Gender used to constrain portrait selection.
      schema:
        type: string
        enum:
          - male
          - female
      example: female
    RealisticAvatarSeed:
      name: seed
      in: path
      required: true
      description: URL-safe seed that retains its assigned realistic portrait.
      schema:
        type: string
        minLength: 1
        maxLength: 128
        pattern: ^[A-Za-z0-9](?:[A-Za-z0-9._~@+-]{0,126}[A-Za-z0-9])?$
      example: ada-lovelace
    RealisticAvatarFormat:
      name: format
      in: path
      required: true
      description: Output raster image file extension.
      schema:
        type: string
        enum:
          - jpg
          - png
          - webp
      example: webp
  responses:
    RealisticAvatarImage:
      description: Seeded realistic avatar image.
      headers:
        ETag:
          $ref: '#/components/headers/ETag'
        Cache-Control:
          $ref: '#/components/headers/CacheControl'
      content:
        image/jpeg:
          schema:
            type: string
            format: binary
        image/png:
          schema:
            type: string
            format: binary
        image/webp:
          schema:
            type: string
            format: binary
    NotFound:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  headers:
    ETag:
      description: Identifier for conditional requests.
      schema:
        type: string
    CacheControl:
      description: Public browser and shared-cache directives.
      schema:
        type: string
        example: public, max-age=86400, s-maxage=604800, stale-while-revalidate=86400
  schemas:
    Error:
      type: object
      required:
        - message
      properties:
        message:
          type: string

````