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

# 图片生成 Q 版模型

> 通过上传图片和预配置的风格标签生成 Q 版 3D 角色模型。该操作消耗 30 点数。使用前需要先完成风格标签配置。



## OpenAPI

````yaml /openapi.old.zh.json post /api/createCuteModelsFromImages
openapi: 3.0.3
info:
  title: Neural4D 管理接口
  description: Neural4D 管理接口规范，中文界面下使用本规范展示中文接口说明。
  version: 1.5.4
servers:
  - url: https://alb.neural4d.com:3000
    description: 生产环境
security:
  - bearerAuth: []
tags:
  - name: text-to-3d
    description: 用于通过文本生成 3D 模型的接口。
    x-group: 文本生成 3D
  - name: image-to-3d
    description: 用于通过图片生成 3D 模型的接口。
    x-group: 图片生成 3D
  - name: model-management
    description: 用于查询模型、跟踪任务和转换格式的接口。
    x-group: 模型管理
  - name: media-generation
    description: 用于生成图片、视频以及查询结果的接口。
    x-group: 图片与视频生成
  - name: account-and-validation
    description: 用于校验输入图片和查询点数余额的接口。
    x-group: 账户与校验
paths:
  /api/createCuteModelsFromImages:
    post:
      tags:
        - image-to-3d
      summary: 图片生成 Q 版模型
      description: 通过上传图片和预配置的风格标签生成 Q 版 3D 角色模型。该操作消耗 30 点数。使用前需要先完成风格标签配置。
      operationId: createCuteModelsFromImages
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/CreateCuteModelsFromImagesRequest'
            examples:
              default:
                value:
                  images:
                    - (binary)
                  styleType: Pixel-Style
      responses:
        '200':
          description: 批量创建结果
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateCuteModelsFromImagesResponse'
              examples:
                success:
                  value:
                    success: true
                    totalFiles: 1
                    successCount: 1
                    failureCount: 0
                    results:
                      - uuids:
                          - 31f15c88-48ae
                        success: true
                        message: >-
                          Task created and model generation started, please
                          retrieve model after a moment
                    failures: []
                    message: 'Processed 1 files: 1 succeeded, 0 failed'
components:
  schemas:
    CreateCuteModelsFromImagesRequest:
      type: object
      required:
        - images
        - styleType
      properties:
        images:
          type: array
          minItems: 1
          items:
            type: string
            format: binary
          description: 用于生成 Q 版模型的输入图片文件。
        styleType:
          type: string
          description: Q 版模型流程使用的已配置提示词标签。
          example: Pixel-Style
    CreateCuteModelsFromImagesResponse:
      type: object
      required:
        - success
        - totalFiles
        - successCount
        - failureCount
        - results
        - failures
        - message
      properties:
        success:
          type: boolean
          description: 批量请求是否处理成功。
        totalFiles:
          type: integer
          description: 上传的输入文件总数。
        successCount:
          type: integer
          description: 成功进入队列的输入文件数量。
        failureCount:
          type: integer
          description: 未能进入队列的输入文件数量。
        results:
          type: array
          items:
            $ref: '#/components/schemas/CreateCuteModelResult'
          description: 每个成功处理的输入文件对应的入队结果。
        failures:
          type: array
          items:
            type: object
            additionalProperties: true
          description: 未能进入队列的输入文件对应的失败详情。
        message:
          type: string
          description: 批量操作的可读摘要信息。
    CreateCuteModelResult:
      type: object
      required:
        - uuids
        - success
        - message
      properties:
        uuids:
          type: array
          items:
            type: string
          description: 此输入文件生成的任务或模型 UUID 列表。
        success:
          type: boolean
          description: 此输入文件是否成功进入队列。
        message:
          type: string
          description: 此输入文件对应的可读处理结果。
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 使用 Neural4D 网站提供的 Bearer token。
      x-default: YOUR_TOKEN

````