Truy vấn tác vụ（Seedance）

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

import requests

url = "https://api.aiid.edu.kg/api/v3/contents/generations/tasks/{task_id}"

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/api/v3/contents/generations/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/v3/contents/generations/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/v3/contents/generations/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/v3/contents/generations/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

{
  "id": "<string>",
  "model": "<string>",
  "status": "queued",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "created_at": 123,
  "updated_at": 123,
  "content": {
    "video_url": "<string>",
    "last_frame_url": "<string>"
  },
  "usage": {
    "completion_tokens": 123,
    "total_tokens": 123
  },
  "items": "<string>"
}

Tạo video Seedance

Truy vấn tác vụ（Seedance）

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

Được dùng để tạo tác vụ tạo video và truy vấn trạng thái cũng như kết quả thông qua ID tác vụ.

Các trường cốt lõi để tạo tác vụ:

model: Bắt buộc, tên mô hình.
prompt: Bắt buộc, mô tả chính để tạo video.
content: tùy chọn, mảng content của Volcano Ark, trộn văn bản, hình ảnh, video và âm thanh.
function_mode: Tùy chọn, thường dùng cho các chế độ nâng cao như tham chiếu toàn năng.

Các tham số đầu vào tương thích:

Các trường sau chủ yếu dùng để tương thích với client cũ và giao thức cũ. Với tích hợp mới, vui lòng ưu tiên dùng định dạng chuẩn trong “Ví dụ yêu cầu” trên trang này: văn bản và tài liệu tham chiếu sử dụng mảng content, còn cấu hình sinh sử dụng các trường cấp cao nhất duration, ratio, resolution, fps, v.v.

mode：t2v / i2v / i2v_first_last / reference_images / reference_material
image_url / image_urls / input_reference
end_image_url / last_image_url
video_urls / audio_urls
seconds / duration
aspect_ratio / ratio / size
quality / resolution
fps
generate_audio / watermark

Chi tiết gọi API:

Khi là mode=reference_material hoặc function_mode=omni_reference, nên truyền văn bản và tài liệu tham chiếu thông qua content.
content mục văn bản được viết theo dạng { "type": "text", "text": "测试文字" }.
content các mục tài nguyên hình ảnh, video, âm thanh lần lượt dùng cú pháp đối tượng image_url, video_url, audio_url, ví dụ { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }.
role có thể dùng để xác định mục đích của tài nguyên, name có thể được tham chiếu theo tên trong prompt.
ratio, duration, resolution, fps sẽ ảnh hưởng đến cấu hình tạo cuối cùng.

Gọi Gemini Omni:

gemini-omni cũng có thể được gọi thông qua giao diện tác vụ Seedance này.
mode=t2v dùng cho tạo video từ văn bản, mode=r2v dùng cho tạo bằng ảnh tham chiếu/tài nguyên tham chiếu, mode=edit dùng cho chỉnh sửa video.
Văn bản có thể đặt trong mục text của prompt hoặc content; hình ảnh có thể đặt trong image_url / image_urls / reference_images / input_reference / content; video có thể đặt trong video_urls / content.
Trường thời lượng có thể dùng duration hoặc seconds, hệ thống sẽ tự động khớp với các mức 4 / 6 / 8 / 10 giây.

MiniMax / Hailuo gọi:

minimax-h3 có thể được gọi thông qua API tác vụ này, hỗ trợ tạo video từ văn bản, tham chiếu ảnh và tham chiếu âm thanh; văn bản có thể đặt trong mục văn bản prompt hoặc content, dữ liệu có thể đặt trong các trường như content, image_urls, audio_urls.
hailuo-2.3 có thể được gọi thông qua API tác vụ này, cần ảnh khung hình đầu tiên; khuyến nghị truyền mục image_url của role=first_frame trong content.
minimax-h3 thường dùng duration=5~15, resolution=1440p; hailuo-2.3 thường dùng duration=6 hoặc 10, resolution=768p.

Các trường cần lưu ý trong kết quả truy vấn:

items[].status
items[].content.video_url hoặc items[].video_url
items[].error
items[].progress

Error fields: error.code, error.message.

{
  "error": {
    "code": "invalid_request_error",
    "message": "requires at least one image in `images`"
  }
}

GET

api

contents

generations

tasks

{task_id}

Truy vấn tác vụ（Seedance）

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

import requests

url = "https://api.aiid.edu.kg/api/v3/contents/generations/tasks/{task_id}"

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/api/v3/contents/generations/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/v3/contents/generations/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/v3/contents/generations/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/v3/contents/generations/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

{
  "id": "<string>",
  "model": "<string>",
  "status": "queued",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "created_at": 123,
  "updated_at": 123,
  "content": {
    "video_url": "<string>",
    "last_frame_url": "<string>"
  },
  "usage": {
    "completion_tokens": 123,
    "total_tokens": 123
  },
  "items": "<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

Task ID

Phản hồi

200 - application/json

Truy vấn thành công

string

ID của tác vụ.

model

string

status

enum<string>

Trạng thái nhiệm vụ.

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

queued,

running,

succeeded,

failed

error

object | null

Hide child attributes

error.code

string

error.message

string

created_at

integer

Thời gian tạo (giây Unix).

updated_at

integer

content

object

Hide child attributes

content.video_url

string

content.last_frame_url

string

usage

object

Hide child attributes

usage.completion_tokens

integer

usage.total_tokens

integer

items

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ụ（Seedance）

Ủy quyền

Tham số đường dẫn

Phản hồi