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

# Получение результата

> Запрос результата задачи — запрос статуса и результата задачи генерации видео по ID задачи



## OpenAPI

````yaml openapi/ru/happyhorse.json GET /happyhorse/api/v1/tasks/{task_id}
openapi: 3.1.0
info:
  title: Видео API HappyHorse
  version: 1.0.0
  description: >-
    видео API HappyHorse предоставляет эффективные возможности генерации и
    редактирования видео, помогая разработчикам быстро интегрировать
    интеллектуальные видеофункции.
servers:
  - url: https://api.ttapi.io
security: []
paths:
  /happyhorse/api/v1/tasks/{task_id}:
    get:
      description: >-
        Запрос результата задачи — запрос статуса и результата задачи генерации
        видео по ID задачи
      parameters:
        - name: task_id
          in: path
          required: true
          description: ID-задачи. Срок действия 24 часа.
          schema:
            type: string
      responses:
        '200':
          description: Запрос результата задачи успешен
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                    description: >-
                      Уникальный идентификатор запроса. Может использоваться для
                      трассировки запросов и устранения неполадок.
                    example: c11018a8-3f83-9591-a636-xxxxxx
                  output:
                    type: object
                    description: Информация о выводе задачи
                    properties:
                      task_id:
                        type: string
                        description: ID-задачи. Срок действия 24 часа.
                        example: 051c7b40-b2c5-4341-aee4-xxxxxx
                      task_status:
                        type: string
                        description: Статус задачи
                        enum:
                          - PENDING
                          - RUNNING
                          - SUCCEEDED
                          - FAILED
                          - CANCELED
                          - UNKNOWN
                        example: SUCCEEDED
                      code:
                        type: string
                        description: >-
                          Код ошибки. Возвращается только когда task_status
                          равен FAILED.
                        example: InvalidParameter
                      message:
                        type: string
                        description: >-
                          Сообщение об ошибке. Возвращается только когда
                          task_status равен FAILED.
                        example: The resolution is not valid
                      submit_time:
                        type: string
                        description: >-
                          Время отправки задачи. Часовой пояс UTC+8, формат:
                          ГГГГ-ММ-ДД ЧЧ:мм:сс.ССС. Возвращается только при
                          успешном выполнении задачи.
                        example: '2026-04-26 14:13:14.373'
                      scheduled_time:
                        type: string
                        description: >-
                          Время выполнения задачи. Часовой пояс UTC+8, формат:
                          ГГГГ-ММ-ДД ЧЧ:мм:сс.ССС. Возвращается только при
                          успешном выполнении задачи.
                        example: '2026-04-26 14:13:14.419'
                      end_time:
                        type: string
                        description: >-
                          Время завершения задачи. Часовой пояс UTC+8, формат:
                          ГГГГ-ММ-ДД ЧЧ:мм:сс.ССС. Возвращается только при
                          успешном выполнении задачи.
                        example: '2026-04-26 14:14:13.679'
                      orig_prompt:
                        type: string
                        description: >-
                          Исходный входной промпт, соответствует параметру
                          запроса промпт. Возвращается только при успешном
                          выполнении задачи.
                        example: >-
                          Пусть персонаж с головой лошади в видео наденет
                          полосатый свитер с изображения
                      video_url:
                        type: string
                        description: >-
                          URL видео. Возвращается только когда task_status равен
                          SUCCEEDED. Срок действия ссылки 24 часа, вы можете
                          скачать видео по этому URL. Формат видео MP4
                          (кодирование H.264).
                        example: >-
                          https://dashscope-result.oss-cn-beijing.aliyuncs.com/xxxx.mp4
                    required:
                      - task_id
                      - task_status
                    example:
                      task_id: 1469cfc3-3004-4d9e-ab10-xxxxxx
                      task_status: SUCCEEDED
                      submit_time: '2026-04-25 15:03:25.848'
                      scheduled_time: '2026-04-25 15:03:25.884'
                      end_time: '2026-04-25 15:04:05.882'
                      orig_prompt: >-
                        Женщина в красном ципао character1, камера сначала
                        запечатлевает облегающий крой и S-образную кривую со
                        среднего бокового ракурса, затем переключается на нижний
                        угол, чтобы запечатлеть серьги с кисточками character3,
                        покачивающиеся, когда она изящно открывает веер
                        character2, наконец приближается к крупному плану лица,
                        застывая ее тонкое очарование, когда ее кончики пальцев
                        слегка касаются костяшек веера с глазами, полными
                        эмоций, демонстрируя восточную элегантность с разных
                        ракурсов.
                      video_url: >-
                        https://dashscope-result.oss-cn-beijing.aliyuncs.com/xxxx.mp4
                  usage:
                    type: object
                    description: >-
                      Статистика информации о выводе. Учитывается только для
                      успешных результатов.
                    properties:
                      duration:
                        type: number
                        description: >-
                          Общая продолжительность видео генерируемого видео,
                          используется для выставления счетов.
                        example: 5
                      input_video_duration:
                        type: number
                        description: Продолжительность входного видео в секундах.
                        example: 0
                      output_video_duration:
                        type: number
                        description: Продолжительность выходного видео в секундах.
                        example: 5
                      video_count:
                        type: integer
                        description: Количество генерируемых видео. Фиксировано 1.
                        example: 1
                      SR:
                        type: integer
                        description: Уровень разрешения генерируемого видео.
                        example: 720
                      ratio:
                        type: string
                        description: Соотношение сторон генерируемого видео.
                        example: '16:9'
                required:
                  - request_id
                  - output
                example:
                  request_id: 35137489-2862-96cb-b6f2-xxxxxx
                  output:
                    task_id: 1469cfc3-3004-4d9e-ab10-xxxxxx
                    task_status: SUCCEEDED
                    submit_time: '2026-04-25 15:03:25.848'
                    scheduled_time: '2026-04-25 15:03:25.884'
                    end_time: '2026-04-25 15:04:05.882'
                    orig_prompt: >-
                      Женщина в красном ципао character1, камера сначала
                      запечатлевает облегающий крой и S-образную кривую со
                      среднего бокового ракурса, затем переключается на нижний
                      угол, чтобы запечатлеть серьги с кисточками character3,
                      покачивающиеся, когда она изящно открывает веер
                      character2, наконец приближается к крупному плану лица,
                      застывая ее тонкое очарование, когда ее кончики пальцев
                      слегка касаются костяшек веера с глазами, полными эмоций,
                      демонстрируя восточную элегантность с разных ракурсов.
                    video_url: >-
                      https://dashscope-result.oss-cn-beijing.aliyuncs.com/xxxx.mp4
                  usage:
                    duration: 5
                    input_video_duration: 0
                    output_video_duration: 5
                    video_count: 1
                    SR: 720
                    ratio: '16:9'
      security:
        - CustomApiKey: []
components:
  securitySchemes:
    CustomApiKey:
      type: apiKey
      in: header
      name: TT-API-KEY
      description: >-
        Пожалуйста, перейдите на <a href='https://dashboard.ttapi.io'
        target='_blank'>консоль TTAPI</a>, чтобы получить ключ API.

````