Interroger une tâche (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>"
}

Génération vidéo Seedance

Interroger une tâche (Seedance)

Cette série prend en charge le format de génération vidéo OpenAI (voir le lien Formats compatibles pour la génération vidéo Sora).

Utilisé pour créer des tâches de génération vidéo et interroger leur statut et leurs résultats via l’ID de tâche.

Champs principaux pour la création de tâche :

model : Obligatoire, nom du modèle.
prompt : Obligatoire, description principale pour la génération vidéo.
content : facultatif, tableau content de Volcano Ark, pour mélanger du texte, des images, des vidéos et des fichiers audio.
function_mode : Optionnel, couramment utilisé pour les modes avancés tels que la référence omnipotente.

Paramètres d’entrée compatibles :

Les champs suivants sont principalement utilisés pour la compatibilité avec les anciens clients et les anciens protocoles. Pour une nouvelle intégration, utilisez autant que possible le format standard de l’« exemple de requête » de cette page : le texte et les éléments de référence utilisent le tableau content, et la configuration de génération utilise les champs de niveau supérieur duration, ratio, resolution, fps, etc.

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

Détails d’appel :

Pour mode=reference_material ou function_mode=omni_reference, il est recommandé de transmettre le texte et les éléments de référence via content.
Les éléments texte de content s’écrivent sous la forme { "type": "text", "text": "测试文字" }.
Les éléments d’images, de vidéos et d’audio de content utilisent respectivement les écritures d’objet image_url, video_url et audio_url, par exemple { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }.
role peut identifier l’usage du média, et name peut être référencé par son nom dans le prompt.
ratio, duration, resolution et fps affectent la configuration de génération finale.

Appel Gemini Omni :

gemini-omni peut aussi être appelé via cette interface de tâche Seedance.
mode=t2v est utilisé pour la génération de vidéo à partir de texte, mode=r2v pour la génération à partir d’images/de médias de référence, et mode=edit pour l’édition vidéo.
Le texte peut être placé dans l’élément text de prompt ou content ; les images peuvent être placées dans image_url / image_urls / reference_images / input_reference / content ; les vidéos peuvent être placées dans video_urls / content.
Le champ de durée peut utiliser duration ou seconds ; il sera automatiquement aligné sur les paliers de 4 / 6 / 8 / 10 secondes.

Appel MiniMax / Hailuo :

minimax-h3 peut être appelé via cette interface de tâche et prend en charge la génération vidéo à partir de texte, les références d’image et les références audio ; le texte peut être placé dans les éléments de texte prompt ou content, et les ressources peuvent être placées dans les champs content, image_urls, audio_urls, etc.
hailuo-2.3 peut être appelé via cette interface de tâche et nécessite une image de première image ; il est recommandé de transmettre l’élément image_url de role=first_frame dans content.
minimax-h3 utilise généralement duration=5~15 et resolution=1440p ; hailuo-2.3 utilise généralement duration=6 ou 10 et resolution=768p.

Champs importants des résultats de requête :

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

Interroger une tâche (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>"
}

Autorisations

Authorization

string

header

requis

Utilisez l'authentification Bearer Token. Format : Authorization: Bearer sk-xxxxxx

Paramètres de chemin

task_id

string

requis

Task ID

Réponse

200 - application/json

Requête réussie

string

ID de la tâche.

model

string

status

enum<string>

État de la tâche.

Options disponibles:

queued,

running,

succeeded,

failed

error

object | null

Hide child attributes

error.code

string

error.message

string

created_at

integer

Date de création (secondes 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

Aperçu

Format Gemini pour la génération d’images

Format Omni de génération vidéo et Veo

Format OpenAI(Responses)

Format de génération vidéo Kling

Format de tâche de génération musicale

Formats compatibles avec la génération de vidéosSora

Génération d’imagesOpenAI au format DALL-E

Génération vidéo Seedance

Génération vidéo Vidu

Génération vidéoHappyHorse avec Wan

Obtenir la liste des modèles

OpenAIFormat (Chat)

Interroger une tâche (Seedance)

Autorisations

Paramètres de chemin

Réponse