Upload Avatars from Chat
upload_avatar_from_chat_fileBatch upload reusable avatars/models from person photos the user attached in chat. Each photo becomes the upper_body_front identity anchor. Keep names and optional user-given age_range, build, and height_cm in avatars[], then pass top-level image_file_1, image_file_2, etc. in the same order. Traits are never guessed. No base64, no local paths. Do not use ordinary text-to-image results as an upload fallback; use generate_avatar followed by save_generated_avatar for Uwear-created avatars. Use only when the user explicitly wants a specific or consistent person.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Single recovered avatar/model name | |
| build | No | Optional concrete physical build. Never inferred. | |
| avatars | No | Avatar/model metadata in the same order as image_file_1, image_file_2, etc. No base64. | |
| age_range | No | Optional concrete age or age range. Never inferred. | |
| file_name | No | Single recovered original file name | |
| height_cm | No | Optional height in centimeters. Never inferred. | |
| image_url | No | Single resolved download URL used by automatic opaque-file recovery. | |
| mime_type | No | Single recovered MIME/content type, e.g. image/png | |
| description | No | Single recovered avatar metadata | |
| image_file_1 | No | Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID. | |
| image_file_2 | No | Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID. | |
| image_file_3 | No | Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID. | |
| image_file_4 | No | Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID. | |
| image_file_5 | No | Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID. | |
| image_file_6 | No | Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID. | |
| image_file_7 | No | Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID. | |
| image_file_8 | No | Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID. | |
| image_file_9 | No | Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID. | |
| image_file_10 | No | Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID. |