> ## 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. 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 /v3/contents/generations/tasks/{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:
  /v3/contents/generations/tasks/{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.
        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
                    error: null
                    created_at: 1782980006
                    updated_at: 1782980484
                    content:
                      video_url: >-
                        https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/example/video.mp4
                      last_frame_url: https://assets.aitoearn.ai/example/last-frame.png
                    seed: 9190
                    resolution: 720p
                    ratio: '16:9'
                    duration: 8
                    framespersecond: 24
                    generate_audio: true
                    tools:
                      - type: web_search
                    safety_identifier: user:01JQ8W2M4Y6N7P8R9S0T1U2V3W
                    priority: 0
                    execution_expires_after: 172800
                    usage:
                      completion_tokens: 411300
                      total_tokens: 411300
                      tool_usage:
                        web_search: 1
      security:
        - apikey-header-Authorization: []
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
        generate_audio:
          type: boolean
          description: Whether synchronized audio is included.
        tools:
          type: array
          description: Tools actually used by the model for this request.
          items:
            type: object
            properties:
              type:
                type: string
                description: Actual tool type used.
            required:
              - type
            additionalProperties: false
        safety_identifier:
          type: string
          description: End-user identifier, echoed as provided.
        priority:
          type: number
          description: Task execution priority.
        execution_expires_after:
          type: number
          description: Task timeout threshold in seconds.
      required:
        - id
        - model
        - status
        - created_at
        - updated_at
      additionalProperties: false
  securitySchemes:
    apikey-header-Authorization:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Pass the API Key obtained from AiToEarn. Go to the ["API Key
        Tutorial"](/en/use/api-key). Example: Bearer xxx.

````