Запросить задачу（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>"
}

Генерация видео Seedance

Запросить задачу（Seedance）

Эта серия поддерживает формат генерации видео OpenAI (подробности см. по ссылке совместимые форматы видео生成Sora ).

Используется для создания задач генерации видео и получения статуса и результатов по ID задачи.

Основные поля для создания задачи:

model: Обязательно, название модели.
prompt: Обязательно, основное описание для генерации видео.
content: необязательный массив content Volcano Ark, для смешанного размещения текста, изображений, видео и аудио.
function_mode: Опционально, часто используется в расширенных режимах, таких как универсальный референс.

Совместимые входные параметры:

Следующие поля в основном предназначены для совместимости со старыми клиентами и устаревшими протоколами. Для новых интеграций по возможности используйте стандартный формат из «Примера запроса» на этой странице: для текста и reference materials используйте массив content, а для настроек генерации — верхнеуровневые поля duration, ratio, resolution, fps и т. д.

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

Детали вызова:

При использовании mode=reference_material или function_mode=omni_reference рекомендуется передавать текст и референсные материалы через content.
content: текстовый элемент задаётся в формате { "type": "text", "text": "测试文字" }.
content: элементы изображений, видео и аудио оформляются соответственно с помощью объектов image_url, video_url и audio_url, например { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }.
role может обозначать назначение материала, name можно ссылаться по имени в подсказке.
ratio, duration, resolution и fps влияют на итоговую конфигурацию генерации.

Вызов Gemini Omni:

gemini-omni также можно вызывать через этот интерфейс задачи Seedance.
mode=t2v используется для генерации видео по тексту, mode=r2v — для генерации по референсным изображениям/материалам, mode=edit — для редактирования видео.
Текст можно размещать в элементе text в prompt или content; изображения можно размещать в image_url / image_urls / reference_images / input_reference / content; видео — в video_urls / content.
Для поля длительности можно использовать duration или seconds — будет автоматически сопоставлено с вариантами 4 / 6 / 8 / 10 секунд.

Вызов MiniMax / Hailuo:

minimax-h3 можно вызвать через этот интерфейс задачи; поддерживаются генерация видео по тексту, референс по изображению и референс по аудио; текст можно указать в текстовых полях prompt или content, а материалы — в полях content, image_urls, audio_urls и т. д.
hailuo-2.3 можно вызвать через этот интерфейс задачи; требуется изображение первого кадра, рекомендуется передавать в content элемент image_url из role=first_frame.
minimax-h3 обычно используют duration=5~15 и resolution=1440p; hailuo-2.3 обычно используют duration=6 или 10 и resolution=768p.

Ключевые поля в результатах запроса:

items[].status
items[].content.video_url или 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}

Запросить задачу（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>"
}

Авторизации

Authorization

string

header

обязательно

Используйте проверку подлинности Bearer Token. Формат: Authorization: Bearer sk-xxxxxx

Параметры пути

task_id

string

обязательно

Task ID

Ответ

200 - application/json

Успешный запрос

string

ID задачи.

model

string

status

enum<string>

Статус задачи.

Доступные опции:

queued,

running,

succeeded,

failed

error

object | null

Hide child attributes

error.code

string

error.message

string

created_at

integer

Время создания (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

Обзор

Видео-генерация Omni и формат Veo

Генерация видео Seedance

Генерация видео Vidu

Генерация видеоHappyHorse и Wan

Генерация изображенийOpenAI в формате DALL-E

Получить список моделей

Совместимый формат для Sora генерации видео

Формат Gemini для генерации изображений

Формат OpenAI (Chat)

Формат OpenAI (Responses)

Формат задачи генерации музыки

ФорматKling генерации видео

Запросить задачу（Seedance）

Авторизации

Параметры пути

Ответ