Truy vấn tác vụ(HappyHorse)

curl --request GET \
  --url https://api.aiid.edu.kg/api/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

{
  "output": {
    "task_id": "<string>",
    "submit_time": "<string>",
    "scheduled_time": "<string>",
    "end_time": "<string>",
    "video_url": "<string>",
    "code": "<string>",
    "message": "<string>"
  },
  "usage": {
    "duration": 123,
    "SR": 123,
    "video_count": 123
  },
  "request_id": "<string>"
}

Tạo videoHappyHorseAlibaba

Truy vấn tác vụ(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.

GET

api

tasks

{task_id}

Truy vấn tác vụ(HappyHorse)

curl --request GET \
  --url https://api.aiid.edu.kg/api/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

{
  "output": {
    "task_id": "<string>",
    "submit_time": "<string>",
    "scheduled_time": "<string>",
    "end_time": "<string>",
    "video_url": "<string>",
    "code": "<string>",
    "message": "<string>"
  },
  "usage": {
    "duration": 123,
    "SR": 123,
    "video_count": 123
  },
  "request_id": "<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

Tham số đường dẫn

task_id

string

bắt buộc

ID tác vụ, lấy từ id được trả về khi tạo tác vụ.

Phản hồi

200 - application/json

Truy vấn thành công

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

enum<string>

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

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

PENDING,

RUNNING,

SUCCEEDED,

FAILED,

UNKNOWN

output.submit_time

string

output.scheduled_time

string

output.end_time

string

output.video_url

string<uri>

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

output.code

string

output.message

string

usage

object

Hide child attributes

usage.duration

integer

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

usage.SR

integer

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

usage.video_count

integer

request_id

string

Tạo video(HappyHorse)Hình ảnh Gemini (Nano Banana)