curl --request POST \
  --url https://api.aiid.edu.kg/api/v1/services/aigc/video-generation/video-synthesis \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "happyhorse-1.0",
  "mode": "t2v",
  "input": {
    "prompt": "A white horse running through a neon city street, cinematic"
  },
  "parameters": {
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5
  }
}
'

{
  "id": "task_xxx",
  "output": {
    "task_id": "<string>",
    "task_status": "<string>",
    "video_url": "<string>"
  },
  "usage": {
    "duration": "<string>",
    "SR": "<string>"
  }
}

Tạo videoHappyHorseAlibaba

Tạo video(HappyHorse)

Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết Định dạng tương thích với Sora tạo video).

HappyHorse giao diện tạo video của Alibaba; đường dẫn công khai tuân theo giao thức chính thức của DashScope.

Hỗ trợ 5 mô hình đối ngoại: happyhorse-1.0、happyhorse-1.0-i2v、happyhorse-1.0-t2v、happyhorse-1.0-r2v、happyhorse-1.0-video-edit. Trong đó happyhorse-1.0 là mô hình tổng hợp, cần dùng mode để phân biệt t2v、i2v、r2v、video_edit.

Giao diện công khai giữ nguyên định dạng endpoint chính thức; tiền tố riêng cho từng kênh chỉ được ghép nội bộ khi gateway gửi yêu cầu tới kênh upstream cụ thể. Client không cần truyền rõ X-DashScope-Async; gateway hoặc lớp thích ứng kênh chính thức sẽ xử lý.

Bổ sung khung yêu cầu công khai, cấu trúc truy vấn tác vụ và mẫu kiểm tra khuyến nghị cho định dạng tạo video chính thức của Alibaba HappyHorse; đường dẫn công khai giữ nguyên định dạng endpoint chính thức.

Mô hình hỗ trợ: happyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit

Các trường yêu cầu thống nhất:

model (string, bắt buộc): Tên mô hình đối ngoại của HappyHorse. Mô hình tổng hợp happyhorse-1.0 cần dùng cùng mode.
mode (string, tùy chọn): Chế độ mô hình tổng hợp, các giá trị thường dùng là t2v、i2v、r2v、video_edit. Với mô hình con cố định có thể không truyền.
input.prompt (string, bắt buộc): Prompt tạo hoặc chỉnh sửa video.
input.media (array[object], tùy chọn): Dữ liệu đầu vào đa phương tiện. Tạo video từ ảnh dùng first_frame, tạo video từ tham chiếu dùng reference_image, chỉnh sửa video dùng video và tùy chọn reference_image.
parameters.duration (integer, tùy chọn): Thời lượng tạo, tính phí theo giây.
parameters.resolution (string, tùy chọn): Độ phân giải đầu ra, giá trị thường dùng 720P、1080P.
parameters.ratio (string, tùy chọn): Tỷ lệ khung hình đầu ra, thường dùng cho tạo video từ văn bản và từ tham chiếu.
parameters.watermark (boolean, tùy chọn): Có thêm watermark hay không.
parameters.seed (integer, tùy chọn): Seed ngẫu nhiên.

Khác biệt thường gặp giữa mô hình/chế độ:

HappyHorse 聚合模型: Hỗ trợ mô hình happyhorse-1.0; mô hình tổng hợp phân biệt mô hình cuối cùng qua mode.
HappyHorse 文生视频: Hỗ trợ mô hình happyhorse-1.0-t2v; định dạng chính thức tạo video từ văn bản.
HappyHorse 首帧图生视频: Hỗ trợ mô hình happyhorse-1.0-i2v; định dạng chính thức tạo video từ ảnh khung đầu.
HappyHorse 参考生视频: Hỗ trợ mô hình happyhorse-1.0-r2v; định dạng chính thức tạo video từ nhiều ảnh tham chiếu.
HappyHorse 视频编辑: Hỗ trợ mô hình happyhorse-1.0-video-edit; định dạng chính thức chỉnh sửa video.

POST

api

services

aigc

video-generation

video-synthesis

curl --request POST \
  --url https://api.aiid.edu.kg/api/v1/services/aigc/video-generation/video-synthesis \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "happyhorse-1.0",
  "mode": "t2v",
  "input": {
    "prompt": "A white horse running through a neon city street, cinematic"
  },
  "parameters": {
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5
  }
}
'

{
  "id": "task_xxx",
  "output": {
    "task_id": "<string>",
    "task_status": "<string>",
    "video_url": "<string>"
  },
  "usage": {
    "duration": "<string>",
    "SR": "<string>"
  }
}

Ủy quyền

Authorization

string

header

bắt buộc

Sử dụng xác thực Bearer Token. Định dạng: Authorization: Bearer sk-xxxxxx

Nội dung

application/json

model

enum<string>

bắt buộc

Tên mô hình hiển thị ra bên ngoài của HappyHorse. Mô hình tổng hợp happyhorse-1.0 cần được sử dụng cùng với mode.

Tùy chọn có sẵn:

happyhorse-1.0,

happyhorse-1.0-t2v,

happyhorse-1.0-i2v,

happyhorse-1.0-r2v,

happyhorse-1.0-video-edit

Ví dụ:

"happyhorse-1.0-t2v"

input

object

bắt buộc

Hide child attributes

input.prompt

string

bắt buộc

Lời nhắc tạo hoặc chỉnh sửa video.

Ví dụ:

"A white horse running through a neon city street, cinematic"

input.media

object[]

Đầu vào đa phương tiện. Tạo video từ hình ảnh sử dụng first_frame, tạo video tham chiếu sử dụng reference_image, chỉnh sửa video sử dụng video và tùy chọn reference_image.

Hide child attributes

input.media.type

enum<string>

bắt buộc

Tùy chọn có sẵn:

first_frame,

reference_image,

video

input.media.url

string<uri>

bắt buộc

mode

enum<string>

Chế độ mô hình tổng hợp, các giá trị thường gặp là t2v, i2v, r2v, video_edit. Có thể không truyền mô hình con cố định.

Tùy chọn có sẵn:

t2v,

i2v,

r2v,

video_edit

parameters

object

Hide child attributes

parameters.resolution

enum<string>

Độ phân giải đầu ra, các giá trị thường gặp 720P、1080P.

Tùy chọn có sẵn:

720P,

1080P

Ví dụ:

"720P"

parameters.ratio

string

Tỷ lệ khung hình đầu ra, thường dùng cho tạo video từ văn bản và tạo video từ video tham chiếu.

Ví dụ:

"16:9"

parameters.duration

integer

Thời lượng tạo, tính phí theo giây.

Ví dụ:

5

parameters.watermark

boolean

Có thêm hình mờ hay không.

parameters.seed

integer

Hạt giống ngẫu nhiên.

Phản hồi

200 - application/json

Tạo nhiệm vụ thành công

string

bắt buộc

Ví dụ:

"task_xxx"

output

object

Hide child attributes

output.task_id

string

ID tác vụ được trả về khi tạo tác vụ, dùng để truy vấn tác vụ.

output.task_status

string

Trạng thái tác vụ, các giá trị thường gặp PENDING, RUNNING, SUCCEEDED, FAILED.

output.video_url

string

URL video được tạo sau khi tác vụ thành công.

usage

object

Hide child attributes

usage.duration

string

Thời lượng tính phí, đơn vị giây.

usage.SR

string

Mức độ phân giải đầu ra.

Tạo video từ văn bản(Vidu)Truy vấn tác vụ(HappyHorse)