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

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

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

fetch('https://api.aiid.edu.kg/ent/v2/tasks/{task_id}/creations', 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/ent/v2/tasks/{task_id}/creations",
  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/ent/v2/tasks/{task_id}/creations"

	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/ent/v2/tasks/{task_id}/creations")

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

{
  "id": "<string>",
  "state": "created",
  "err_code": "<string>",
  "payload": "<string>",
  "creations": [
    {
      "id": "<string>",
      "url": "<string>",
      "cover_url": "<string>",
      "watermarked_url": "<string>"
    }
  ],
  "task_id": "<string>"
}

Tạo video Vidu

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

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).

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

Mô hình công khai hiện tại: viduq3-turbo. Hỗ trợ text-to-video, image-to-video, video từ khung đầu-cuối, và reference-to-video. Cùng một mô hình cũng hỗ trợ tích hợp thông qua định dạng tương thích Sora của /v1/videos, các mode thường dùng là t2v, i2v, i2v_first_last, reference_images.

Bổ sung skeleton request công khai, cấu trúc truy vấn tác vụ và mẫu xác minh được khuyến nghị cho định dạng tạo video chính thức của Vidu, đường dẫn công khai giữ nguyên định dạng endpoint chính thức của Vidu.

Mô hình hỗ trợ: viduq3-turbo

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 Vidu, hiện công khai viduq3-turbo.
prompt (string, tùy chọn): prompt tạo video; bắt buộc với text-to-video, còn image-to-video/khung đầu-cuối/reference-to-video thì truyền theo nhu cầu nghiệp vụ.
images (array[string], tùy chọn): đầu vào hình ảnh. image-to-video dùng 1 ảnh, khung đầu-cuối dùng 2 ảnh, reference-to-video dùng 1~7 ảnh.
videos (array[string], tùy chọn): đầu vào đối tượng video tùy chọn cho reference-to-video, sử dụng theo năng lực mô hình chính thức của Vidu.
subjects (array[object], tùy chọn): đầu vào theo định dạng thư viện chủ thể của reference-to-video, có thể bao gồm các trường như tên chủ thể, ảnh, video hoặc giọng.
duration (integer, tùy chọn): độ dài video, tính bằng giây. viduq3-turbo thường dùng 5 giây, có thể đặt theo phạm vi chính thức.
resolution (string, tùy chọn): độ phân giải đầu ra, giá trị phổ biến 540p, 720p, 1080p.
aspect_ratio (string, tùy chọn): tỷ lệ khung hình đầu ra, thường dùng cho text-to-video/reference-to-video, như 16:9, 9:16, 1:1.
seed (integer, tùy chọn): Seed ngẫu nhiên.
movement_amplitude (string, tùy chọn): mức độ chuyển động, các giá trị phổ biến auto, small, medium, large.
audio (boolean, tùy chọn): có bật xuất trực tiếp âm thanh và video hay không.
off_peak (boolean, tùy chọn): có sử dụng tạo lệch giờ hay không.
watermark (boolean, tùy chọn): Có thêm watermark hay không.

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

Vidu 文生视频: hỗ trợ mô hình viduq3-turbo; text-to-video theo định dạng chính thức.
Vidu 图生视频: hỗ trợ mô hình viduq3-turbo; image-to-video một ảnh theo định dạng chính thức.
Vidu 首尾帧生视频: hỗ trợ mô hình viduq3-turbo; video từ hai ảnh khung đầu-cuối theo định dạng chính thức.
Vidu 参考生视频: hỗ trợ mô hình viduq3-turbo; reference-to-video với nhiều ảnh tham chiếu theo định dạng chính thức.

GET

ent

tasks

{task_id}

creations

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

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

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

fetch('https://api.aiid.edu.kg/ent/v2/tasks/{task_id}/creations', 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/ent/v2/tasks/{task_id}/creations",
  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/ent/v2/tasks/{task_id}/creations"

	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/ent/v2/tasks/{task_id}/creations")

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

{
  "id": "<string>",
  "state": "created",
  "err_code": "<string>",
  "payload": "<string>",
  "creations": [
    {
      "id": "<string>",
      "url": "<string>",
      "cover_url": "<string>",
      "watermarked_url": "<string>"
    }
  ],
  "task_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ừ task_id được trả về khi tạo tác vụ.

Phản hồi

200 - application/json

Truy vấn thành công

string

ID của tác vụ.

state

enum<string>

Trạng thái tác vụ, các giá trị thường gặp created、queueing、processing、success、failed.

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

created,

queueing,

processing,

success,

failed

err_code

string

payload

string

creations

object[]

Hide child attributes

creations.id

string

creations.url

string<uri>

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

creations.cover_url

string<uri>

URL bìa sau khi tác vụ thành công.

creations.watermarked_url

string<uri>

URL video có watermark.

task_id

string

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

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ụ(Vidu)

Ủy quyền

Tham số đường dẫn

Phản hồi