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

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aiid.edu.kg/api/v1/tasks/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aiid.edu.kg/api/v1/tasks/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aiid.edu.kg/api/v1/tasks/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aiid.edu.kg/api/v1/tasks/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "output": {
    "task_id": "<string>",
    "task_status": "PENDING",
    "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 video HappyHorse và Wan

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

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 và giao diện tạo video Wan; đường dẫn công khai tuân theo giao thức chính thức của DashScope.

HappyHorse hỗ trợ happyhorse-1.0, happyhorse-1.0-i2v, happyhorse-1.0-t2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit; Wan hỗ trợ wan-3.0, wan-3.0-480p, wan-3.0-1080p. Trong đó happyhorse-1.0 là mô hình tổng hợp, cần phân biệt t2v, i2v, r2v, video_edit thông qua mode. Ba mô hình của Wan lần lượt cố định ở 720P, 480P, 1080P, hỗ trợ thời lượng 2～30 giây và tối đa 10 ảnh, 5 video, 5 audio tham chiếu.

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 xác thực đề xuất cho định dạng tạo video HappyHorse và Wan; đường dẫn công khai giữ nguyên định dạng endpoint chính thức của DashScope.

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, wan-3.0, wan-3.0-480p, wan-3.0-1080p

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

model (string, bắt buộc): Tên mô hình công khai của HappyHorse hoặc Wan. Wan hỗ trợ wan-3.0, wan-3.0-480p, wan-3.0-1080p; mô hình tổng hợp HappyHorse 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): Đầu vào đa phương tiện. Hỗ trợ first_frame, last_frame, reference_image, reference_video, reference_audio; Wan hỗ trợ tối đa 10 ảnh, 5 video, 5 audio.
parameters.duration (integer, tùy chọn): Thời gian tạo, tính bằng giây.
parameters.resolution (string, tùy chọn): Độ phân giải đầu ra. Ba mô hình của Wan lần lượt cố định ở 720P, 480P, 1080P; các giá trị phổ biến của HappyHorse là 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.
Wan 3.0 720P: Hỗ trợ mô hình wan-3.0; tạo video tham chiếu đa phương thức theo định dạng chính thức của Wan 3.0.
Wan 3.0 480P: Hỗ trợ mô hình wan-3.0-480p; lời gọi theo định dạng chính thức của Wan 3.0 với 480P cố định.
Wan 3.0 1080P: Hỗ trợ mô hình wan-3.0-1080p; lời gọi theo định dạng chính thức của Wan 3.0 với 1080P cố định.

GET

api

tasks

{task_id}

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

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aiid.edu.kg/api/v1/tasks/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aiid.edu.kg/api/v1/tasks/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aiid.edu.kg/api/v1/tasks/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aiid.edu.kg/api/v1/tasks/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "output": {
    "task_id": "<string>",
    "task_status": "PENDING",
    "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 gian tạo, tính bằng giây.

usage.SR

integer

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

usage.video_count

integer

request_id

string

Tổng quan

Lấy danh sách mô hình

Tạo hình ảnhOpenAI định dạng DALL-E

Tạo video HappyHorse và Wan

Tạo video Seedance

Tạo video Vidu

Định dạng Gemini cho tạo ảnh

Định dạng OpenAI (Chat)

Định dạng OpenAI (Responses)

Định dạng Video Generation Omni và Veo

Định dạng tác vụ tạo nhạc

Định dạng tương thích Sora cho tạo video

Định dạngKling tạo video

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

Ủy quyền

Tham số đường dẫn

Phản hồi