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

# Query Volcengine-format video task

> Interface description: Query the status of a Volcengine-format video generation task. The response keeps the Volcengine task query format. It is intended for customers who have already integrated the Volcengine video generation API; replace the request URL with the AiToEarn URL and change authentication to `X-Api-Key`. See the official Volcengine documentation: [Query video generation task](https://www.volcengine.com/docs/82379/1521309?lang=zh).



## OpenAPI

````yaml /openapi/en/aitoearn.openapi.json get /api/ai/volcengine/video/{taskId}
openapi: 3.0.1
info:
  title: AiToEarn Open Platform API
  description: >-
    AiToEarn Open Platform API. You can switch between the China and
    international sites for testing. Business success is determined by whether
    the response body has code === 0.
  version: 1.0.0
  contact: {}
servers:
  - url: https://aitoearn.cn
    description: China site
  - url: https://aitoearn.ai
    description: International site
security: []
tags:
  - name: AI Services
  - name: AI Services/Video Generation
  - name: AI Services/Image Generation
  - name: Channel Management
  - name: Channel Management/Accounts
  - name: Channel Management/Publishing
  - name: Channel Management/Platforms
  - name: Channel Management/Works
  - name: Channel Management/Account Groups
  - name: Channel Management/Authorization
  - name: Asset Management
  - name: AI Services/Large Language Models
paths:
  /api/ai/volcengine/video/{taskId}:
    get:
      tags:
        - AI Services/Video Generation
      summary: Query Volcengine-format video task
      description: >-
        Interface description: Query the status of a Volcengine-format video
        generation task. The response keeps the Volcengine task query format. It
        is intended for customers who have already integrated the Volcengine
        video generation API; replace the request URL with the AiToEarn URL and
        change authentication to `X-Api-Key`. See the official Volcengine
        documentation: [Query video generation
        task](https://www.volcengine.com/docs/82379/1521309?lang=zh).
      operationId: VolcengineVideoController_videoTaskStatus
      parameters:
        - name: taskId
          in: path
          required: true
          description: >-
            Task ID returned by the Volcengine-format create video generation
            task endpoint.
          schema:
            type: string
      responses:
        '200':
          description: >-
            Native Volcengine-format response, not wrapped in the AiToEarn
            common response envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VolcengineTaskStatusResponseVo'
              examples:
                success:
                  summary: Success
                  value:
                    id: 6a461da66fe8a12d33daabdd
                    model: doubao-seedance-2-0-260128
                    status: succeeded
                    created_at: 1782980006
                    updated_at: 1782980484
                    content:
                      video_url: https://assets.aitoearn.ai/example/video.mp4
                    seed: 9190
                    resolution: 720p
                    ratio: '16:9'
                    duration: 8
                    framespersecond: 24
                    generate_audio: true
                    priority: 0
                    execution_expires_after: 172800
                    usage:
                      completion_tokens: 411300
                      total_tokens: 411300
      security:
        - apikey-header-X-Api-Key: []
components:
  schemas:
    VolcengineTaskStatusResponseVo:
      type: object
      properties:
        id:
          description: Task ID
          type: string
        model:
          type: string
          description: Model name
        status:
          type: string
          description: Task status
        error:
          description: error message
          type: object
          properties:
            message:
              type: string
            code:
              type: string
          required:
            - message
            - code
          additionalProperties: false
          nullable: true
        created_at:
          type: number
          description: creation time
        updated_at:
          type: number
          description: Update time
        content:
          description: video content
          type: object
          properties:
            video_url:
              type: string
            last_frame_url:
              type: string
          additionalProperties: false
        seed:
          description: seed value
          type: number
        resolution:
          description: resolution
          type: string
        ratio:
          description: aspect ratio
          type: string
        duration:
          description: duration
          type: number
        framespersecond:
          description: Frame rate
          type: number
        usage:
          description: Usage statistics
          type: object
          properties:
            completion_tokens:
              type: number
            total_tokens:
              type: number
            tool_usage:
              type: object
              properties:
                web_search:
                  type: number
              additionalProperties: false
          additionalProperties: false
      required:
        - id
        - model
        - status
        - created_at
        - updated_at
      additionalProperties: false
  securitySchemes:
    apikey-header-X-Api-Key:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >-
        Need to get API Key from AiToEarn. Click to go to ["API Key Obtaining
        Tutorial"](/en/use/api-key).

````