查询任务(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,用于查询任务。
