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

# Presign multipart parts

> Multipart upload **step 2**: presigned URL per part. Requires [`X-Idempotency-Key`](/guides/idempotency). Flow: [Material upload](/guides/app-synced/comparison).



## OpenAPI

````yaml /api-reference/app-synced.json post /openapi/v1/app/assets/material/upload/multipart/presign-parts
openapi: 3.1.0
info:
  title: VMEG Open API (App-Synced)
  description: >-
    Same protocol as the Standalone API, but every task, material, and cloned
    voice lives in your VMEG website account: jobs show up in **My tasks**, open
    in the editor, and can be re-exported. Poll `GET
    /openapi/v1/app/tasks/detail` for results (no webhooks). See [Standalone vs
    App-Synced](/guides/app-synced/comparison).


    Linked guides are written for the Standalone API. The steps are the same;
    use the `/openapi/v1/app` prefix instead of `/openapi/v1`.
  version: 1.0.0
servers:
  - url: https://api.vmeg.ai
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: Media translation
    x-group: Video & audio translate and dub
    description: >-
      Translate and dub uploaded video/audio or a YouTube link on the same
      pipeline as vmeg.ai. The first pass renders the dubbed file; the job also
      appears in **My tasks** for editing and re-export. Poll [Query job
      status](/api-reference/app-synced/tasks/get-task-detail) for results.
  - name: Voice clone
    x-group: Voice cloning
    description: >-
      Clone a voice from a short recording. The voice is saved to **My voices**
      on the website and returned as `cv_*` for translate-and-dub jobs.
  - name: Task management
    x-group: Task status and history
    description: >-
      List, inspect, or delete the video/audio translation jobs in your VMEG
      account, including jobs created on the website.
  - name: Assets - Materials
    x-group: Upload files (materials)
    description: >-
      Upload and manage the files in your website material library (**My
      assets**). Finish the upload (single-file or multipart), then pass
      `materialId` to create-async.
  - name: Assets - Voices
    x-group: Voices (presets and clones)
    description: >-
      List preset system voices (`sv_*`) and manage your cloned voices (`cv_*`,
      same as **My voices** on the website).
paths:
  /openapi/v1/app/assets/material/upload/multipart/presign-parts:
    post:
      tags:
        - Assets - Materials
      summary: Presign multipart parts
      description: >-
        Multipart upload **step 2**: presigned URL per part. Requires
        [`X-Idempotency-Key`](/guides/idempotency). Flow: [Material
        upload](/guides/app-synced/comparison).
      operationId: appMaterialMultipartPresign
      parameters:
        - $ref: '#/components/parameters/IdempotencyKeyRequired'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenApiMaterialMultipartPresignRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiMaterialMultipartPresignResponse'
components:
  parameters:
    IdempotencyKeyRequired:
      name: X-Idempotency-Key
      in: header
      required: true
      description: >-
        Required on mutating `POST` requests that create tasks or change
        persisted data (max 64 characters). See
        [Idempotency](/guides/idempotency).
      schema:
        type: string
        maxLength: 64
  schemas:
    OpenApiMaterialMultipartPresignRequest:
      type: object
      properties:
        materialId:
          type: string
          description: >-
            Material ID from multipart initiate. See
            [Materials](/guides/app-synced/comparison)
        uploadId:
          type: string
          description: Multipart upload session ID from initiate
        fileHash:
          type: string
          description: MD5 hash of the full file
        fileName:
          type: string
          description: Original file name including extension
        partNumbers:
          type: array
          items:
            type: integer
          description: Part numbers to presign (1–10000)
    OpenApiMaterialMultipartPresignResponse:
      allOf:
        - $ref: '#/components/schemas/OpenApiResponseBase'
        - type: object
          properties:
            data:
              $ref: '#/components/schemas/OpenApiMaterialMultipartPresignData'
    OpenApiResponseBase:
      type: object
      properties:
        code:
          type: integer
          example: 200
          description: Business code; 200 means success
        message:
          type: string
          example: ''
          description: Human-readable detail when `code` is not success
      required:
        - code
    OpenApiMaterialMultipartPresignData:
      type: object
      properties:
        urls:
          type: array
          items:
            $ref: '#/components/schemas/OpenApiMaterialMultipartPresignPartUrl'
          description: Presigned PUT URLs for requested parts
        expiresInSeconds:
          type: integer
          format: int64
          description: Seconds until these URLs expire
    OpenApiMaterialMultipartPresignPartUrl:
      type: object
      properties:
        partNumber:
          type: integer
          description: Part index (1-based)
        url:
          type: string
          description: Presigned PUT URL for this part
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: >-
        Send your API Key in the **`Authorization`** header (`Bearer
        <api_key>`). See [Authentication](/guides/authentication).

````