Bỏ qua để đến nội dung

Tạo tác vụ

Xem Markdownllms.txt

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: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/volc/v1/contents/generations/tasks:
post:
summary: Tạo tác vụ
deprecated: false
description: Gửi tác vụ tạo video Seedance/Doubao.
operationId: volc_sample
tags:
- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Doubao
- Doubao Volc
parameters: []
requestBody:
content:
application/json:
schema:
type: object
required:
- model
- content
properties:
callback_url:
type: string
description: URL gọi lại được kích hoạt khi tác vụ hoàn tất
content:
type: array
items:
type: object
properties:
image_url:
type: object
properties:
url:
type: string
description: URL tài nguyên
description: URL hình ảnh
x-apifox-orders:
- url
x-apidog-orders:
- url
role:
type: string
enum:
- first_frame
- last_frame
- reference_image
description: >-
Vai trò của tin nhắn, ví dụ: system / user / assistant
/ model
text:
type: string
description: Vui lòng cung cấp nội dung văn bản cần dịch.
type:
type: string
enum:
- text
- image_url
description: Kiểu
x-apifox-orders:
- image_url
- role
- text
- type
x-apidog-orders:
- image_url
- role
- text
- type
description: Mảng nội dung văn bản/hình ảnh
model:
type: string
description: Tên mô hình
examples:
- doubao-seedance-2-0-260128
refName: VolcSampleRequest
x-apifox-orders:
- callback_url
- content
- model
x-apidog-orders:
- callback_url
- content
- model
examples:
doubao_seedance_1_5_pro_251215:
value:
content:
- text: >-
Cô gái ôm con cáo, cô gái mở mắt, dịu dàng nhìn về phía
máy quay, con cáo thân thiện ôm cô gái, máy quay từ từ
lùi ra xa, tóc cô gái lay động trong gió, có thể nghe
thấy tiếng gió.
type: text
- image_url:
url: >-
https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png
type: image_url
duration: 4
model: doubao-seedance-1-5-pro-251215
ratio: thích ứng
watermark: false
summary: doubao_seedance_1_5_pro_251215
description: seedance-1-5-pro
doubao_seedance_2_0_260128:
value:
content:
- text: Một con mèo đang chạy trên đồng cỏ.
type: text
model: doubao-seedance-2-0-260128
summary: doubao_seedance_2_0_260128
description: Video Vincent
doubao_seedance_2_0_260128_2:
value:
content:
- image_url:
url: https://example.com/frame.jpg
role: first_frame
type: image_url
- text: Máy quay tiến gần
type: text
model: doubao-seedance-2-0-260128
summary: doubao_seedance_2_0_260128_2
description: video từ ảnh
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
required:
- id
- status
properties:
id:
type: string
description: ID tài nguyên hoặc tác vụ
status:
type: string
description: Trạng thái
refName: VolcSampleResponse
x-apifox-orders:
- id
- status
x-apidog-orders:
- id
- status
examples:
'1':
summary: '1'
value:
id: cgt-20250918170228-dw9rb
status: submitted
'2':
summary: '2'
value:
id: cgt-20260108111352-gwv4p
status: submitted
headers: {}
x-apidog-name: ''
'400':
description: Yêu cầu không hợp lệ hoặc xác thực thất bại
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: >-
Yêu cầu không hợp lệ (mã yêu cầu:
20260805120000123456789AbCdEfGh)
type: new_api_error
headers: {}
x-apidog-name: Yêu cầu không hợp lệ hoặc xác thực thất bại
'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-45209046-run
components:
schemas: {}
securitySchemes: {}
servers:
- url: https://api.openaihub.net
description: Prod Env
security: []