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

# AI Talking Avatar v2

> AI Talking Avatar v2. **How it works** — one portrait image plus one audio track: the person in the image speaks the audio, lip-synced. Same request fields and the same price as `ai-talking-avatar`; v2 gives livelier facial expressions and head movement, and separates the voice from any background music and lip-syncs to the voice only. The original audio, music included, is kept in the output.

**Output length** — by default the video is as long as your audio. Before any tokens are deducted, GoEnhance transfers `audio_url` to its own storage and measures the real duration — that measurement is what you are billed for, and it is also what enforces the 3-60s limit. Because the file is measured and then sent onward from GoEnhance's storage, swapping the URL afterwards has no effect.

To make a shorter video, set the optional `duration` (whole seconds, 3-60): only the first `duration` seconds of the audio are used, and you are billed for `duration` seconds. It cannot exceed the audio length. With `duration` set, the audio itself may be longer than 60 seconds.

**Audio requirements** — 3-60 seconds (or at least `duration` seconds when `duration` is set), up to 50MB. Background music is allowed — the voice is separated out for lip sync — but clear speech still gives the best result. Only one person should be speaking.

**Portrait requirements** — up to 10MB. The face must be clearly visible, unobstructed and roughly front-facing.

**Output size** — the aspect ratio follows your portrait: the closest of a fixed set of sizes is picked. For a 16:9 landscape portrait that is 832×480 at `540p` and 1248×736 at `720p`; for a 9:16 portrait, 480×832 and 736×1248. `720p` takes roughly three times as long to generate as `540p`.

**Pricing** — per second of output (the audio length, or `duration` when set), in tokens (USD at $0.02/token):

| resolution | tokens/s | USD/s |
|---|---|---|
| 540p | 0.5 | $0.01 |
| 720p | 1 | $0.02 |

A 30-second clip therefore costs 15 tokens at 540p (= $0.30).
At 720p the same clip costs 30 tokens (= $0.60).

Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use `custom_callback_url`) to get the generated video.



## OpenAPI

````yaml api-reference/video-generations/openapi-ai-talking-avatar-v2.json POST /api/v1/videos/generations
openapi: 3.1.0
info:
  title: GoEnhance API - AI Talking Avatar v2
  description: >-
    Turn a portrait image and an audio track into a lip-synced talking video,
    with livelier expressions and head movement.
  version: 1.0.0
servers:
  - url: https://api.goenhance.ai
security: []
paths:
  /api/v1/videos/generations:
    post:
      tags:
        - VideoGenerations
      summary: AI Talking Avatar v2
      description: >-
        AI Talking Avatar v2. **How it works** — one portrait image plus one
        audio track: the person in the image speaks the audio, lip-synced. Same
        request fields and the same price as `ai-talking-avatar`; v2 gives
        livelier facial expressions and head movement, and separates the voice
        from any background music and lip-syncs to the voice only. The original
        audio, music included, is kept in the output.


        **Output length** — by default the video is as long as your audio.
        Before any tokens are deducted, GoEnhance transfers `audio_url` to its
        own storage and measures the real duration — that measurement is what
        you are billed for, and it is also what enforces the 3-60s limit.
        Because the file is measured and then sent onward from GoEnhance's
        storage, swapping the URL afterwards has no effect.


        To make a shorter video, set the optional `duration` (whole seconds,
        3-60): only the first `duration` seconds of the audio are used, and you
        are billed for `duration` seconds. It cannot exceed the audio length.
        With `duration` set, the audio itself may be longer than 60 seconds.


        **Audio requirements** — 3-60 seconds (or at least `duration` seconds
        when `duration` is set), up to 50MB. Background music is allowed — the
        voice is separated out for lip sync — but clear speech still gives the
        best result. Only one person should be speaking.


        **Portrait requirements** — up to 10MB. The face must be clearly
        visible, unobstructed and roughly front-facing.


        **Output size** — the aspect ratio follows your portrait: the closest of
        a fixed set of sizes is picked. For a 16:9 landscape portrait that is
        832×480 at `540p` and 1248×736 at `720p`; for a 9:16 portrait, 480×832
        and 736×1248. `720p` takes roughly three times as long to generate as
        `540p`.


        **Pricing** — per second of output (the audio length, or `duration` when
        set), in tokens (USD at $0.02/token):


        | resolution | tokens/s | USD/s |

        |---|---|---|

        | 540p | 0.5 | $0.01 |

        | 720p | 1 | $0.02 |


        A 30-second clip therefore costs 15 tokens at 540p (= $0.30).

        At 720p the same clip costs 30 tokens (= $0.60).


        Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use
        `custom_callback_url`) to get the generated video.
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: false
          example: '{{Authorization}}'
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  enum:
                    - ai-talking-avatar-v2
                  description: Model name. Must be `ai-talking-avatar-v2`.
                image_url:
                  type: string
                  format: uri
                  description: >-
                    Portrait image of the speaker (up to 10MB). Required. The
                    face must be clearly visible, unobstructed and roughly
                    front-facing.
                audio_url:
                  type: string
                  format: uri
                  description: >-
                    Speech audio to lip-sync to (background music is fine) (up
                    to 50MB). Required. 3-60 seconds, unless `duration` is set —
                    then the audio only needs to be at least `duration` seconds
                    long. Its measured duration sets the output length and the
                    price when `duration` is not set.
                prompt:
                  type: string
                  default: person talking
                  description: >-
                    Optional description of the desired performance, e.g. `a
                    woman speaking calmly to the camera`.
                resolution:
                  type: string
                  enum:
                    - 540p
                    - 720p
                  default: 540p
                  description: >-
                    Output resolution. 720p costs twice as much per second as
                    540p. The `540p` tier renders at 480p-class sizes (e.g.
                    832×480); see Output size above.
                duration:
                  type: integer
                  minimum: 3
                  maximum: 60
                  description: >-
                    Optional. Output length in whole seconds (3-60). Only the
                    first `duration` seconds of the audio are used, and you are
                    billed for `duration` seconds. Must not exceed the audio
                    length. Omit it to use the full audio.
                  example: 15
                custom_callback_url:
                  type: string
                  format: uri
                  description: >-
                    Optional. A publicly accessible HTTPS URL. When the task
                    status changes (processing / success / failed), GoEnhance
                    sends a POST request to this URL. The request body is
                    identical to the response of GET /api/v1/jobs/detail. If
                    your server does not respond with HTTP 200, the notification
                    is retried up to 3 times, with a 3-second timeout per
                    attempt.
                  example: https://your-server.com/goenhance/callback
              required:
                - model
                - image_url
                - audio_url
            example:
              model: ai-talking-avatar-v2
              image_url: https://example.com/portrait.png
              audio_url: https://example.com/speech.mp3
              prompt: a woman speaking calmly to the camera
              resolution: 720p
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    type: object
                    properties:
                      img_uuid:
                        type: string
                      cost:
                        type: number
                        description: >-
                          Tokens deducted for this request. This is the amount
                          actually charged, so it already reflects any discount
                          active on your account and can be lower than the
                          listed price. Tokens are deducted when the task is
                          accepted, and refunded automatically if the generation
                          ends in failure.
                        example: 5.82
                    required:
                      - img_uuid
                      - cost
                required:
                  - code
                  - msg
                  - data
              examples:
                '1':
                  summary: Success
                  value:
                    code: 0
                    msg: Success
                    data:
                      img_uuid: c12b656c-747a-44fd-9c80-add79b0c52d5
                      cost: 5.82
                '2':
                  summary: Insufficient tokens
                  value:
                    code: 100
                    msg: tokens is not enough
                quota:
                  summary: API key quota exceeded
                  value:
                    code: 101
                    msg: 'API key quota exceeded: 4990 of 5000 tokens used (monthly)'
          headers: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                required:
                  - code
                  - msg
          headers: {}
      deprecated: false

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.