查詢任務(Vidu)
curl --request GET \
--url https://api.aiid.edu.kg/ent/v2/tasks/{task_id}/creations \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aiid.edu.kg/ent/v2/tasks/{task_id}/creations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://api.aiid.edu.kg/ent/v2/tasks/{task_id}/creations")
.header("Authorization", "Bearer <token>")
.asString();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>"
}影片生成 Vidu 格式
查詢任務(Vidu)
此系列支援OpenAI影片生成格式(詳見連結 影片生成Sora相容格式)。
Vidu 官方影片生成介面,公開路徑遵循 Vidu 官方協議。
目前公開模型:viduq3-turbo。支援文生影片、圖生影片、首尾幀生影片、參考生影片。同一模型也支援透過 /v1/videos Sora 相容格式接入,常用 mode 為 t2v、i2v、i2v_first_last、reference_images。
補充 Vidu 官方影片生成格式的公開請求骨架、任務查詢結構和推薦驗證模板,公開路徑保持 Vidu 官方端點格式。
支援模型: viduq3-turbo
統一請求欄位:
model(string, 必填): Vidu 對外模型名,目前公開viduq3-turbo。prompt(string, 可選): 影片生成提示詞;文生影片必填,圖生/首尾幀/參考生影片按業務需要傳。images(array[string], 可選): 圖片輸入。圖生影片 1 張,首尾幀 2 張,參考生影片 1~7 張。videos(array[string], 可選): 參考生影片可選影片主體輸入,按 Vidu 官方模型能力使用。subjects(array[object], 可選): 參考生影片主體庫格式輸入,可包含主體名稱、圖片、影片或音色等欄位。duration(integer, 可選): 影片時長,單位秒。viduq3-turbo常用 5 秒,可按官方範圍設定。resolution(string, 可選): 輸出解析度,常見值540p、720p、1080p。aspect_ratio(string, 可選): 輸出寬高比,文生/參考生影片常用,如16:9、9:16、1:1。seed(integer, 可選): 隨機種子。movement_amplitude(string, 可選): 運動幅度,常見值auto、small、medium、large。audio(boolean, 可選): 是否開啟音影片直出。off_peak(boolean, 可選): 是否使用錯峰生成。watermark(boolean, 可選): 是否新增浮水印。
常見模型/模式差異:
Vidu 文生视频: 支援模型 viduq3-turbo;官方格式文生影片。Vidu 图生视频: 支援模型 viduq3-turbo;官方格式單圖圖生影片。Vidu 首尾帧生视频: 支援模型 viduq3-turbo;官方格式首尾幀雙圖生影片。Vidu 参考生视频: 支援模型 viduq3-turbo;官方格式多參考圖生影片。
GET
/
ent
/
v2
/
tasks
/
{task_id}
/
creations
查詢任務(Vidu)
curl --request GET \
--url https://api.aiid.edu.kg/ent/v2/tasks/{task_id}/creations \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aiid.edu.kg/ent/v2/tasks/{task_id}/creations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://api.aiid.edu.kg/ent/v2/tasks/{task_id}/creations")
.header("Authorization", "Bearer <token>")
.asString();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>"
}授權
使用 Bearer Token 認證。
格式: Authorization: Bearer sk-xxxxxx
路徑參數
任務 ID,來自建立任務回傳的 task_id。
回應
200 - application/json
查詢成功
任務 ID。
任務狀態,常見值 created、queueing、processing、success、failed。
可用選項:
created, queueing, processing, success, failed 建立任務時返回的任務 ID,用於查詢任務。
