{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/craftstory-com/json-schema/craftstory-com-mini-max-h3-avatar-create-schema.json",
  "title": "MiniMaxH3AvatarCreate",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/craftstory-com-openapi.yml#/components/schemas/MiniMaxH3AvatarCreate",
  "required": [
    "avatar_id",
    "speech_text"
  ],
  "type": "object",
  "properties": {
    "id": {
      "title": "Id",
      "type": "string",
      "format": "uuid",
      "readOnly": true
    },
    "name": {
      "title": "Name",
      "type": [
        "string",
        "null"
      ],
      "maxLength": 512
    },
    "avatar_id": {
      "title": "Avatar id",
      "description": "A custom avatar id from GET /api/v1/image2video/avatars/ (models includes minimax-h3).",
      "type": "string",
      "format": "uuid"
    },
    "scene_id": {
      "title": "Scene id",
      "description": "One of the avatar's scenes (GET /image2video/avatars/{id}/scenes/); default: the first one.",
      "type": "string",
      "format": "uuid"
    },
    "speech_text": {
      "title": "Speech text",
      "description": "What the avatar says, verbatim (about 15 characters per second).",
      "type": "string",
      "maxLength": 2000,
      "minLength": 1
    },
    "user_prompt": {
      "title": "User prompt",
      "description": "Scene and manner, e.g. 'Selfie video, shows the product'.",
      "type": "string",
      "default": "Talking to the camera."
    },
    "requested_duration_s": {
      "title": "Requested duration s",
      "description": "5-14 s; default: derived from speech_text.",
      "type": "integer",
      "maximum": 14,
      "minimum": 5
    },
    "aspect_ratio": {
      "title": "Aspect ratio",
      "description": "Output shape: auto (nearest native ratio to the photo), 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, or 4:5 (rendered as 3:4 and center-cropped).",
      "type": "string",
      "enum": [
        "auto",
        1269,
        969,
        243,
        61,
        184,
        556,
        561,
        245
      ],
      "default": "auto"
    },
    "credits": {
      "title": "Credits",
      "type": "integer",
      "readOnly": true
    }
  }
}