Hunyuan3D-2

OpenAPI Specification

openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/images/generations:
    post:
      summary: Hunyuan3D-2
      deprecated: false
      description: ''
      tags:
        - 模型接口/3D模型
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: true
          example: sk-
          schema:
            type: string
            default: sk-
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  description: 指定使用的模型。目前仅支持 Hunyuan3D-2。
                image:
                  type: string
                  description: >-
                    待转换的图片文件。格式支持 jpg, jpeg, png, bmp。推荐分辨率为 1024x1024，文件大小不能超过
                    10MB。
                prompt:
                  type: string
                seed:
                  type: integer
                  description: 随机种子。整数，用于复现生成结果。如果设置为-1，则为随机种子。
                extra_fields:
                  type: object
                  properties:
                    type:
                      type: string
                      description: |-
                        枚举值:
                        glb
                    texture:
                      type: string
                      description: |-
                        是否为生成的3D模型生成纹理。
                        默认值:
                        true
                    num_inference_steps:
                      type: string
                      description: |-
                        推理步数。取值范围 [1, 10]。数值越大，模型细节可能越丰富，但生成时间也越长。
                        默认值:
                        5
                    octree_resolution:
                      type: string
                      description: |-
                        八叉树分辨率。可选值为 [64, 128, 256]。数值越大，模型面数越多，细节越丰富，生成时间也越长。
                        默认值:
                        128
                    guidance_scale:
                      type: string
                      description: |-
                        引导系数。取值范围 [1.0, 10.0]。数值越大，生成结果与输入图片的关联性越强。
                        默认值:
                        5
                  x-apifox-orders:
                    - type
                    - texture
                    - num_inference_steps
                    - octree_resolution
                    - guidance_scale
              x-apifox-orders:
                - model
                - image
                - prompt
                - seed
                - extra_fields
              required:
                - model
                - prompt
                - image
            example:
              model: Hunyuan3D-2
              prompt: ' '
              image: https://s3.ffire.cc/files/christmas-tree.png
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                      x-apifox-orders:
                        - url
                  created:
                    type: integer
                x-apifox-orders:
                  - data
                  - created
                required:
                  - data
                  - created
              example:
                data:
                  - url: https://xxxxxxxxxxxxxx
                created: 1753872474
          headers: {}
          x-apifox-name: 成功
      security: []
      x-apifox-folder: 模型接口/3D模型
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/5503894/apis/api-332779701-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: '{{base_url}}'
    description: 测试环境
  - url: https://newapi.eronmind.com
    description: 正式环境
security: []