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

> ## Agent Instructions
> Send API requests to https://api.ttapi.io with the TT-API-KEY header. Midjourney account hosting uses https://hold.ttapi.io. Claude Code uses https://cc.ttapi.io.
> Most generation endpoints are asynchronous. The submit response returns a job id. Poll that product's fetch endpoint, or pass a webhook on the submit request. A fetch call does not start a new generation.
> 1 USD = 100 quota. Check the pricing page for that product before estimating cost.
> This file lists the English docs. Follow every /_llms/ link recursively for the API reference, Chinese, and Russian. Open a page's .md URL for the endpoint schema.

# Suno Video Extension API

> Extend a completed Suno video and use Fetch V2 to retrieve the full extended videos.



## OpenAPI

````yaml openapi/en/suno.json POST /suno/v1/video/extend
openapi: 3.1.0
info:
  title: TTAPI API DOCS
  version: 1.0.0
  description: Suno AI Music API
servers:
  - url: https://api.ttapi.io
security: []
paths:
  /suno/v1/video/extend:
    post:
      summary: Extend Video
      description: >-
        Submit an asynchronous extension job using a completed source video. On
        success, the job returns two complete videos, each containing the source
        video and its corresponding new segment. An API key with Suno Video
        permission is required.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SunoVideoExtendRequest'
            examples:
              basic:
                summary: Use the source video settings
                value:
                  jobId: video-9c64b7e1-f00d-456e-8c56-a0227f5128fb
                  creation_id: crt_0187b131-a1c0-7151-a92e-cd8645e4bb01
                  prompt: >-
                    Keep following the paper lanterns upward, then slowly pull
                    back to reveal more stars.
              reference:
                summary: Use a reference image and specify duration and resolution
                value:
                  jobId: video-9c64b7e1-f00d-456e-8c56-a0227f5128fb
                  creation_id: crt_0187b131-a1c0-7151-a92e-cd8645e4bb01
                  prompt: >-
                    Keep following the paper lanterns upward, then slowly pull
                    back to reveal more stars.
                  duration: 5
                  resolution: 480p
                  reference_image_urls:
                    - https://example.com/reference.jpg
                  hookUrl: https://example.com/webhooks/suno-video
      responses:
        '200':
          description: Extension job accepted. Use the new data.jobId to query this job.
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                  - data
                properties:
                  status:
                    type: string
                    enum:
                      - SUCCESS
                  message:
                    type: string
                    description: Job acceptance message.
                  data:
                    type: object
                    required:
                      - jobId
                    properties:
                      jobId:
                        type: string
                        description: ID of the new extension job for Fetch V2 queries.
                        pattern: ^video-
              example:
                status: SUCCESS
                message: success
                data:
                  jobId: video-f26fc3e4-59da-4fc4-a6e0-4c6ce579a9d8
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '403':
          description: >-
            The API key lacks the required product permission, or the request
            violates account access restrictions.
      security:
        - CustomApiKey: []
components:
  schemas:
    SunoVideoExtendRequest:
      title: Video Extension Parameters
      type: object
      additionalProperties: false
      required:
        - jobId
        - creation_id
        - prompt
      properties:
        jobId:
          type: string
          description: >-
            ID of the source video job. It can come from a generation job or an
            earlier extension job.
          maxLength: 64
        creation_id:
          type: string
          description: >-
            The selected video’s `data.videos[].creation_id` from the source job
            result.
          minLength: 1
          maxLength: 128
        prompt:
          type: string
          description: Video extension prompt.
          minLength: 1
          maxLength: 30000
        duration:
          type:
            - integer
          description: Extension duration.
          minimum: 5
          maximum: 15
        resolution:
          type:
            - string
          description: >-
            Target resolution. Omit the field or pass null to use the source
            job’s resolution.
          enum:
            - 480p
            - 720p
        reference_image_urls:
          type: array
          maxItems: 9
          items:
            type: string
            format: uri
          description: >-
            Public HTTP(S) URLs for up to 9 reference images. JPEG and PNG are
            supported, with a maximum of 10 MiB per image.
        hookUrl:
          type: string
          format: uri
          description: >-
            Optional webhook callback URL. When the job finishes, an HTTP POST
            sends the same body as the video job Fetch V2 response.
  responses:
    400Response:
      description: Parameter error
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: FAILED
              message:
                type: string
              data:
                type: object
            required:
              - status
              - message
    401Response:
      description: Authorization failed
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: FAILED
              message:
                type: string
                example: Wrong TT-API-KEY or email is not activated.
            required:
              - status
              - message
  securitySchemes:
    CustomApiKey:
      type: apiKey
      in: header
      name: TT-API-KEY
      description: >-
        You can obtain your API key from the <a
        href='https://dashboard.ttapi.io' target='_blank'>TTAPI Dashboard</a>.

````

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