# "API tác vụ truy vấn tạo video doubao-2.0"

Nguồn: https://docs.openaihub.net/api-45209050/

> API origin: `https://api.openaihub.net`. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn.


## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v3/contents/generations/tasks/{id}:
    get:
      summary: API tác vụ truy vấn tạo video doubao-2.0
      deprecated: false
      description: >-
        Vui lòng dán nội dung tài liệu vào đây. Tôi không thể truy cập trực tiếp
        nội dung từ URL đã cung cấp, nhưng tôi có thể dịch sang tiếng Việt đồng
        thời giữ nguyên Markdown, mã, định danh, URL, đường dẫn, phần giữ chỗ,
        cấu trúc JSON và định dạng.
      operationId: volc_apiV3_getGenerationsTask
      tags:
        - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Doubao
        - Seedance 2.0 · api/v3
      parameters:
        - name: id
          in: path
          description: ID tài nguyên / tác vụ trong đường dẫn
          required: true
          example: ''
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                required:
                  - content
                  - created_at
                  - draft
                  - duration
                  - execution_expires_after
                  - framespersecond
                  - generate_audio
                  - id
                  - model
                  - ratio
                  - resolution
                  - seed
                  - service_tier
                  - status
                  - updated_at
                  - usage
                properties:
                  content:
                    type: object
                    required:
                      - video_url
                    properties:
                      video_url:
                        type: string
                        description: URL video
                    description: Nội dung tin nhắn hoặc yêu cầu
                    x-apifox-orders:
                      - video_url
                    x-apidog-orders:
                      - video_url
                  created_at:
                    type: integer
                    description: Thời gian tạo
                  draft:
                    type: boolean
                    description: Liệu đó có phải là bản nháp / dữ liệu bản nháp hay không
                  duration:
                    type: integer
                    description: Thời lượng (giây hoặc đơn vị do nền tảng quy định)
                  execution_expires_after:
                    type: integer
                    description: Thời gian hết hạn thực thi
                  framespersecond:
                    type: integer
                    description: Tốc độ khung hình (FPS)
                  generate_audio:
                    type: boolean
                    description: Có tạo âm thanh hay không
                  id:
                    type: string
                    description: ID tài nguyên hoặc tác vụ
                  model:
                    type: string
                    description: Tên mô hình / mã định danh mô hình
                  ratio:
                    type: string
                    description: Tỷ lệ khung hình hoặc tỷ lệ độ phân giải
                  resolution:
                    type: string
                    description: 'Độ phân giải, ví dụ: 720p, 1080p'
                  seed:
                    type: integer
                    description: >-
                      Hạt giống ngẫu nhiên; cùng một hạt giống sẽ tạo ra kết quả
                      có thể tái lập
                  service_tier:
                    type: string
                    description: Cấp dịch vụ / mức ưu tiên
                  status:
                    type: string
                    description: Trạng thái
                  updated_at:
                    type: integer
                    description: Thời gian cập nhật
                  usage:
                    type: object
                    required:
                      - completion_tokens
                      - total_tokens
                    properties:
                      completion_tokens:
                        type: integer
                        description: Số lượng token hoàn thành
                      total_tokens:
                        type: integer
                        description: Tổng số token
                    description: Thống kê mức sử dụng token
                    x-apifox-orders:
                      - completion_tokens
                      - total_tokens
                    x-apidog-orders:
                      - completion_tokens
                      - total_tokens
                refName: GetApiV3ContentsGenerationsTasksIdResponse
                x-apifox-orders:
                  - content
                  - created_at
                  - draft
                  - duration
                  - execution_expires_after
                  - framespersecond
                  - generate_audio
                  - id
                  - model
                  - ratio
                  - resolution
                  - seed
                  - service_tier
                  - status
                  - updated_at
                  - usage
                x-apidog-orders:
                  - content
                  - created_at
                  - draft
                  - duration
                  - execution_expires_after
                  - framespersecond
                  - generate_audio
                  - id
                  - model
                  - ratio
                  - resolution
                  - seed
                  - service_tier
                  - status
                  - updated_at
                  - usage
              examples:
                example:
                  summary: example
                  value:
                    content:
                      video_url: >-
                        https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/02177831701906400000000000000000000ffffac1778adc6a32f.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260509%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260509T090109Z&X-Tos-Expires=86400&X-Tos-Signature=699d4a345c3573c9b86f2f145db21c00bfd32d7f8d1fe0bbe499ce54d92a0af5&X-Tos-SignedHeaders=host
                    created_at: 1778317019
                    draft: false
                    duration: 10
                    execution_expires_after: 172800
                    framespersecond: 24
                    generate_audio: true
                    id: cgt-20260509165650-6rxbv
                    model: doubao-seedance-2-0-260128
                    ratio: '1:1'
                    resolution: 720p
                    seed: 70882
                    service_tier: mặc định
                    status: succeeded
                    updated_at: 1778317294
                    usage:
                      completion_tokens: 216900
                      total_tokens: 216900
          headers: {}
          x-apidog-name: ''
        '401':
          description: Khóa API bị thiếu hoặc không hợp lệ
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - message
                      - type
                    properties:
                      message:
                        type: string
                        description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
                      type:
                        type: string
                        description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
                        examples:
                          - new_api_error
                    x-apifox-orders:
                      - message
                      - type
                    x-apidog-orders:
                      - message
                      - type
                refName: NewApiError
                x-apifox-orders:
                  - error
                x-apidog-orders:
                  - error
              examples:
                example:
                  summary: example
                  value:
                    error:
                      message: >-
                        Mã thông báo không hợp lệ (request id:
                        20260805120000123456789AbCdEfGh)
                      type: new_api_error
          headers: {}
          x-apidog-name: Khóa API bị thiếu hoặc không hợp lệ
      security: []
      x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Doubao
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209050-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```
