Une fois l'opération terminée, `metadata.content_url` fournit l'adresse d'accès direct à la vidéo ; elle peut également être téléchargée via l'interface de contenu ci-dessous.

Réponse (échec)

{

"id": "task_12345",

"object": "video",

"status": "failed",

"error": { "message": "Raison de l'échec" }
}

3. Télécharger le contenu vidéo

curl -L "$KOZEAI_BASE_URL/v1/videos/task_12345/content" \

-H "Authorization: Bearer $KOZEAI_API_KEY" \

-o result.mp4


Renvoie une erreur 409 (Conflit) si la tâche n'est pas terminée (Toujours en file d'attente/en cours de génération).

Prend en charge le téléchargement segmenté et la lecture par glisser-déposer grâce à l'en-tête de requête .

Renvoie . 


Exemple complet

JavaScript (fetch + polling)

const BASE = process.env.KOZEAI_BASE_URL;

const KEY = process.env.KOZEAI_API_KEY;

const headers = { Authorization: `Bearer ${KEY}` };

// 1. Soumettre la tâche

const submit = await fetch(`${BASE}/v1/videos/generations`, {

method: POST,

headers: { ...headers, Content-Type: application/json },

body: JSON.stringify({

model: video-ds-2.0,

prompt: Une vidéo commerciale fluide d'un flacon de parfum sur verre,

seconds: 15,

aspect_ratio: 9:16,

}),

});

const task = await submit.json();

const taskId = task.id;

// 2. Interroger jusqu'à la fin

async function poll() {

while (true) {

const res = await fetch(`${BASE}/v1/videos/${taskId}`, { headers });

const data = await res.json();

if (data.status === "completed") return data;

if (data.status === "failed") throw new Error(data.error?.message || "failed");

await new Promise((r) => setTimeout(r, 5000));

}
} const done = await poll();

// 3. Récupérer l'adresse de la vidéo

console.log('Adresse de la vidéo :', done.metadata?.content_url

|| `${BASE}/v1/videos/${taskId}/content`);


Python (requêtes + interrogation)

import os, time, requests

BASE = os.environ["KOZEAI_BASE_URL"]

KEY = os.environ["KOZEAI_API_KEY"]

headers = {"Authorization": f"Bearer {KEY}"}

# 1. Soumettre la tâche

resp = requests.post(

f{BASE}/v1/videos/generations",

headers=headers,

json={

model": video-ds-2.0",

prompt": Une vidéo cinématographique de 9 min 16 s montrant un chat courant dans un environnement chaud lumière_du_soleil,

secondes : 15,

rapport_aspect : 9:16,

},

)
id_tâche = resp.json()[id]

# 2. Interrogation
while True :

data = requests.get(f{BASE}/v1/videos/{task_id}, headers=headers).json()

if data["status"] == "completed":

break

if data["status"] == "failed":

raise RuntimeError(data.get("error", {}).get("message", &34;échec&34;))

time.sleep(5)

# 3. Téléchargement
mp4 = requests.get(f&34;{BASE}/v1/videos/{task_id}/content&34;, headers=headers)
with open(&34;result.mp4&34;, &34;wb&34;) as f: f.write(mp4.content)

 id="-">Appelé dans l'interface de saisie semi-automatique du chat (utilisation compatible)

Le modèle vidéo peut également être appelé via /v1/chat/completions, facilitant ainsi la réutilisation des clients de chat.
 Lors d'une requête, il suffit de passer le nom du modèle vidéo dans `model`, et le système le convertira automatiquement en une tâche vidéo :

curl $KOZEAI_BASE_URL/v1/chat/completions
 \
-H Authorization: Bearer $KOZEAI_API_KEY \
-H Content-Type: application/json \
-d {
Model: } `
renvoie "video-ds-2.0
,

&34;messages: [{&34;role: "user, "content: "a cat running in the sunshine, cinematic, 9:16}]

}

Renvoie la fin de la conversation
 Le format est `message.content`, qui contient l'état de la tâche et un lien `/v1/videos/{task_id}`. Ce lien lancera la vidéo une fois la conversation terminée. La page du salon de discussion utilise cette méthode.



Les deux points d'entrée (/v1/videos/generations et /v1/chat/completions) partagent le même système de tâches et ne sont pas en conflit. Pour une intégration directe, il est recommandé d'utiliser la méthode standard. Interface `/v1/videos/*`.






Code d'erreur







Code d'état

Signification








401

Jeton manquant, expiré ou invalide




403

Solde insuffisant ou le groupe actuel ne dispose pas des autorisations nécessaires pour ce modèle




404

L'ID de tâche n'existe pas ou n'appartient pas à l'utilisateur actuel ; ou le modèle n'est pas disponible. Configuré.




409

Le contenu vidéo n'est pas prêt (la tâche est toujours en cours de mise en file d'attente/génération)


429

Déclenchement de la limite de débit


502

Le fournisseur en amont a échoué ou a renvoyé un résultat invalide