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)
此系列支援OpenAI影片生成格式(詳見連結 影片生成Sora相容格式)。
Vidu 官方影片生成介面,公開路徑遵循 Vidu 官方協議。
viduq3-turbo、viduq2、vidu2.0 依各自能力支援文字生成、圖片生成、首尾影格或參考生成影片,也可透過 /v1/videos Sora 相容格式接入。
Vidu Q4:vidu-q4 固定為 720p,vidu-q4-540p 固定為 540p,支援生成 3~16 秒影片。至少需要 1 張圖片,最多支援 15 張參考圖;參考生成可附帶最多 3 段 MP3 音訊,每段 3~12 秒、最大 50MB。不支援純文字生成、指定首尾影格或參考影片。多張圖片用於共同參考,不代表首尾位置。可透過 POST /v1/videos、POST /api/v3/contents/generations/tasks,或 Vidu 格式 POST /ent/v2/img2video、POST /ent/v2/reference2video 建立任務。建議統一入口使用 mode=reference_images;附帶音訊時使用 mode=reference_material。參考音訊可使用 audio_urls,Seedance 格式也可使用標準 content 的 audio_url 項;audio 布林欄位表示生成音訊開關,與參考音訊 URL 清單分別使用。解析度須與模型名稱一致。
補充 Vidu 官方影片生成格式的公開請求骨架、任務查詢結構和推薦驗證模板,公開路徑保持 Vidu 官方端點格式。
支援模型: viduq3-turbo, viduq2, vidu2.0
統一請求欄位:
model(string, 必填): Vidu 對外模型名稱。Vidu Q4 僅支援含圖片的圖片生成與參考生成影片;Q3/Q2/V2 沿用各自能力。prompt(string, 可選): 影片生成提示詞;文生影片必填,圖生/首尾幀/參考生影片按業務需要傳。images(array[string], 可選): 圖片輸入。單圖圖片生成 1 張;Vidu Q4 參考生成 1~15 張,且圖片用於共同參考。舊模型首尾影格與參考數量依各自能力使用。videos(array[string], 可選): 僅依舊模型能力提供影片主體輸入;Vidu Q4 不支援參考影片。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, 可選): 是否開啟音影片直出。audio_urls(array[string], 可選): Vidu Q4 參考音訊,最多 3 段 MP3,每段 3~12 秒、最大 50MB;與 audio 布林開關分開。off_peak(boolean, 可選): 是否使用錯峰生成。watermark(boolean, 可選): 是否新增浮水印。
常見模型/模式差異:
Vidu 文生视频: 支援模型 viduq3-turbo, viduq2, vidu2.0;官方格式的文字生成影片。Vidu 图生视频: 支援模型 viduq3-turbo, viduq2, vidu2.0;官方格式的單圖圖片生成影片。Vidu 首尾帧生视频: 支援模型 viduq3-turbo, viduq2, vidu2.0;官方格式的首尾影格雙圖生成影片。Vidu 参考生视频: 支援模型 viduq3-turbo, viduq2, vidu2.0;官方格式的多參考圖片生成影片。
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。
回應
查詢成功
任務 ID。
任務狀態,常見值 created、queueing、processing、success、failed。
created, queueing, processing, success, failed 建立任務時返回的任務 ID,用於查詢任務。
