> ## 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.

# Convert model format

> Convert a generated model into a target format and return the download URL. This operation consumes 10 points.



## OpenAPI

````yaml /openapi.old.json post /api/convertToFormat
openapi: 3.0.3
info:
  title: Neural4D Management API
  description: Management endpoints for Neural4D, including request and response examples.
  version: 1.5.4
servers:
  - url: https://alb.neural4d.com:3000
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: text-to-3d
    description: Create 3D models from text prompts.
    x-group: Text to 3D
  - name: image-to-3d
    description: Create 3D models from uploaded images.
    x-group: Image to 3D
  - name: model-management
    description: Retrieve finished models, track jobs, and convert model formats.
    x-group: Model management
  - name: media-generation
    description: Generate pictures and videos and query their results.
    x-group: Picture and video generation
  - name: account-and-validation
    description: Check portrait inputs and query remaining points.
    x-group: Account and validation
paths:
  /api/convertToFormat:
    post:
      tags:
        - model-management
      summary: Convert model format
      description: >-
        Convert a generated model into a target format and return the download
        URL. This operation consumes 10 points.
      operationId: convertToFormat
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConvertToFormatRequest'
            examples:
              default:
                value:
                  uuid: 2dee04d4-f6e5-4fdf-b626-0f814e24db84
                  modelType: fbx
                  modelSize: 2
      responses:
        '200':
          description: Format conversion result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConvertToFormatResponse'
              examples:
                converting:
                  value:
                    statusType: 1
                    modelSize: 2
                    message: >-
                      The specified model format does not exist, converting
                      now...
                completed:
                  value:
                    statusType: 0
                    modelUrl: >-
                      https://s3.neural4d.com/fbx_54078587-7fdd-49c5-9fe6-317d22f27098.zip?sig=example
                    scaleNumber: 4
                    message: >-
                      Format conversion has been completed and is ready for
                      download.
                missingUuid:
                  value:
                    statusType: -1
                    message: >-
                      Model not found for this UUID
                      (0efc2b3-57e1-4813-90c6-419de96e785e). Please check if the
                      UUID is correct.
components:
  schemas:
    ConvertToFormatRequest:
      type: object
      required:
        - uuid
      properties:
        uuid:
          type: string
          description: UUID of the generated model to convert.
        modelType:
          type: string
          enum:
            - fbx
            - glb
            - obj
            - stl
            - blend
            - usdz
          default: glb
          description: Target model format.
        modelSize:
          type: integer
          minimum: 2
          default: 2
          description: Target model size in millimeters. The value must be greater than 1.
    ConvertToFormatResponse:
      type: object
      required:
        - statusType
        - message
      properties:
        statusType:
          type: integer
          enum:
            - -1
            - 0
            - 1
          description: >-
            Conversion status. `0` means completed, `1` means still converting,
            and `-1` means the request is invalid or the conversion failed.
        modelUrl:
          type: string
          format: uri
          nullable: true
          description: Download URL for the converted model when available.
        scaleNumber:
          type: integer
          nullable: true
          description: Returned scale number when the conversion finishes.
        modelSize:
          type: integer
          nullable: true
          description: Echoed model size from the request or intermediate response.
        message:
          type: string
          description: Conversion status message.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use the bearer token provided through the Neural4D website.
      x-default: YOUR_TOKEN

````