Source: https://ailoot.ai/models/fr/cogvideox-3/ Canonical: https://ailoot.ai/models/fr/cogvideox-3/ Language: fr # Zhipu AI: CogVideoX 3 [Markdown](https://ailoot.ai/models/fr/cogvideox-3/index.md) · [JSON](https://ailoot.ai/models/fr/cogvideox-3/facts.json) ## [Zhipu AI: CogVideoX 3](https://ailoot.ai/models/fr/cogvideox-3/) CogVideoX 3 crée une vidéo à partir de texte, d’une image ou d’une paire d’images initiale et finale dans le processus documenté par l’éditeur. Il prend en charge des séquences de cinq ou dix secondes, plusieurs dimensions de sortie jusqu’à 4K, 30 ou 60 images par seconde et des effets sonores générés en option. - [**Ailoot Ultra · Vidéo** `POST /v1/videos` `cogvideox-3`](https://ailoot.ai/models/fr/cogvideox-3/#method-0) À propos du modèle Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous. CogVideoX 3 est le modèle vidéo de Zhipu AI avec des modes documentés de génération à partir de texte, d’une image, ou d’images initiale et finale. L’éditeur met en avant la stabilité des images, le respect des instructions et les styles visuels réalistes ou tridimensionnels. Choisissez le texte lorsque la scène part d’une description écrite, une image lorsque sa base visuelle existe déjà, ou deux images d’extrémité lorsque la séquence nécessite une vue d’ouverture et une vue de fin définies. Pour une description textuelle, présentez le sujet et une action lisible. Précisez le décor, le point de vue et les relations physiques importantes pour pouvoir évaluer la scène par rapport à une intention claire. Un personnage qui ramasse un objet nécessite une séquence différente d’un mouvement de caméra qui révèle cet objet. Ne décrivez les deux que si leur relation importe pour le plan. Pour une séquence fondée sur une image, préparez la référence afin que les caractéristiques distinctives du sujet soient visibles. L’éditeur accepte des images PNG, JPEG et JPG ne dépassant pas 5 MB, fournies par une URL ou des données d’image encodées. Conservez la référence réelle avec le résultat généré pour comparer l’apparence et le cadrage à la source, plutôt qu’au souvenir que vous en avez. Le mode d’images d’extrémité de l’éditeur accepte deux images dans l’ordre : la première définit l’image d’ouverture et la seconde l’image de fin. Préparez-les comme les deux états souhaités d’un même plan. Décrivez la transition ou l’action qui les relie, puis vérifiez si le sujet reste cohérent entre ces extrémités. Deux bonnes images fixes ne prouvent pas à elles seules que le mouvement intermédiaire correspond au récit souhaité. Le prompt peut contenir jusqu’à 512 caractères. Utilisez le texte disponible pour l’action, sa direction et les détails visuels qui caractérisent un résultat réussi. Centrez la description sur ce qui doit se passer à l’écran. Lorsque les images d’entrée définissent déjà l’apparence du sujet, décrivez le mouvement et le rythme qui doivent se développer entre ces images ou à partir d’elles. L’éditeur documente une sortie de cinq ou dix secondes, avec cinq secondes par défaut, et 30 ou 60 images par seconde. Les dimensions prises en charge comprennent 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 et 3840×2160. Choisissez les dimensions et la durée en fonction de la destination, puis examinez le clip terminé pour vérifier le cadrage et le rythme de l’action réelle. Les modes de qualité et de vitesse sont documentés séparément du réglage facultatif des effets sonores par IA. Conservez ces choix avec le prompt, les images et le résultat. Les capacités visuelles et d’entrée publiées par l’éditeur décrivent le modèle ; les paramètres disponibles pour une méthode de génération particulière sont définis par le contrat de cette méthode. Préservez les paramètres réellement utilisés lorsque vous comparez des plans candidats. Conservez l’identifiant d’origine de la tâche jusqu’à la fin de la vidéo et enregistrez les séquences renvoyées pour le montage. Examinez toute la séquence, notamment l’apparence du sujet pendant les mouvements amples, les interactions avec les objets de la scène et la composition finale. Pour un travail avec des images d’extrémité, vérifiez les deux extrémités et la transition entre elles. Corrigez l’écart visuel précis en conservant les références et le découpage du plan qui fonctionnent, et comparez les vidéos terminées plutôt que leurs seules images d’aperçu. **Ailoot Ultra · Vidéo** `POST /v1/videos` `cogvideox-3` [`cogvideox-3`](https://ailoot.ai/models/fr/#m=cogvideox-3&route=Ultra&caller=cogvideox-3&fmt=videos) Zhipu AI /`cogvideox-3` ### Premiers pas CogVideoX 3 crée une vidéo à partir de texte, d’une image ou d’une paire d’images initiale et finale dans le processus documenté par l’éditeur. Il prend en charge des séquences de cinq ou dix secondes, plusieurs dimensions de sortie jusqu’à 4K, 30 ou 60 images par seconde et des effets sonores générés en option. Entrées acceptées Texte Résultats Vidéo ### Disponible dans Ailoot · entrées et méthodes **Ailoot Ultra · Vidéo** `POST /v1/videos` Types d’entrée `text` Types de sortie `video` | Champ | Type | Exigence | Valeurs et limites | Par défaut | | --- | --- | --- | --- | --- | | Champ`model` | Type`string` | ExigenceObligatoire | Valeurs et limites cogvideox-3 Conditions: Utilisez le sélecteur exact de modèle Ailoot. | Par défaut— | | Champ`prompt` | Type`string` | ExigenceObligatoire | Valeurs et limites Conditions: Décrivez la scène et le mouvement. | Par défaut— | | Champ`quality` | Type`boolean` | ExigenceFacultatif | Valeurs et limites Conditions: Indicateur facultatif de qualité ; le schéma sélectionné ne fournit aucune énumération compatible ni valeur par défaut. | Par défaut— | | Champ`with_audio` | Type`boolean` | ExigenceFacultatif | Valeurs et limites Conditions: Génère des effets sonores par IA lorsque cette option est activée. | Par défautfalse | | Champ`size` | Type`string` | ExigenceFacultatif | Valeurs et limites Conditions: Fournissez la chaîne size documentée lorsque vous sélectionnez des dimensions explicites. | Par défaut— | | Champ`fps` | Type`string` | ExigenceFacultatif | Valeurs et limites 30, 60 Conditions: La fréquence d’images est représentée par une chaîne sur cette méthode native sélectionnée. | Par défaut30 | | Champ`duration` | Type`string` | ExigenceFacultatif | Valeurs et limites 5, 10 Conditions: La durée en secondes est représentée par une chaîne sur cette méthode native sélectionnée. | Par défaut5 | Paramètres et cycle de vie de la méthode | Paramètre | Contrat | | --- | --- | | Paramètre`content_type` | Contratapplication/json | | Paramètre`required` | Contratmodel, prompt | | Paramètre`optional` | Contratquality, with\_audio, size, fps, duration | | Paramètre`material_types` | Contrattext | | Paramètre`conditions` | ContratUtilisez le sélecteur exact de modèle Ailoot., Décrivez la scène et le mouvement., Indicateur facultatif de qualité ; le schéma sélectionné ne fournit aucune énumération compatible ni valeur par défaut., Génère des effets sonores par IA lorsque cette option est activée., Fournissez la chaîne size documentée lorsque vous sélectionnez des dimensions explicites., La fréquence d’images est représentée par une chaîne sur cette méthode native sélectionnée., La durée en secondes est représentée par une chaîne sur cette méthode native sélectionnée. | Alias de méthode : `/v1/videos/generations` Cycle de vie : `submit_once_poll_original` `GET /v1/videos/{request_id}` `GET /v1/videos/generations/{request_id}` `GET /v1/videos/{request_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Tarifs ##### Calcul du coût final Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable. Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée. Mode rapide Non précisé Lorsque le mode rapide est sélectionné Mode Flex Non précisé Lorsque le mode flex est sélectionné Effort de raisonnement maximal Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default) #### Tarifs estimés à des fins de comparaison #### Prix par configuration Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives. | Configuration | Barème tarifaire | Quantité prévisionnelle | Quantité facturée | Coût | | --- | --- | --- | --- | --- | | ConfigurationTarifs de base par jeton | Barème tarifaireTarif de base | Quantité prévisionnelle— | Quantité facturée— | Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement **—** / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement **—** / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement **—** / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement **—** / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement **—** / 1K tokens | | ConfigurationPar requête | Barème tarifaire— | Quantité prévisionnelle— | Quantité facturéeune requête | Coût Entrée · Estimation à des fins de comparaison uniquement **$0.3** par requête | | ConfigurationCoût de génération estimé | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Quantité facturée— | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement **$0.3** estimation avant génération Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée. | Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. [Fonctionnement de la réservation et du débit →](https://ailoot.ai/docs/fr/billing/reserve/) ### Exemples de requêtes #### Ailoot Ultra · Vidéo curl · créer une seule fois et conserver le reçuLisez la tâche d’origineEnregistrez chaque ressource finalisée qui vous appartient ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" cat > request.json <<'JSON' { "model": "cogvideox-3", "prompt": "A cat is walking on grass." } JSON curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json # Create once; retain id, polling_url, original task identifiers and every header. ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_STATUS' import json,os,subprocess from pathlib import Path from urllib.parse import urljoin,urlsplit r=json.loads(Path("result.json").read_text()) u=urljoin("https://api.ailoot.ai",r["polling_url"]) p=urlsplit(u) if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password: raise SystemExit("Unexpected returned polling URL; preserve the response") subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True) # Read this same original polling_url again while pending. # Preserve unknown/result_pending_check; do not repeat creation. PY_STATUS ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_ASSETS' import json,os,subprocess from pathlib import Path from urllib.parse import urljoin,urlsplit r=json.loads(Path("status.json").read_text()) roles={} def visit(v,path=""): if isinstance(v,dict): for k,x in v.items(): visit(x,path+"/"+k) elif isinstance(v,list): for i,x in enumerate(v): visit(x,path+"/"+str(i)) elif isinstance(v,str): u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u) if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"): roles.setdefault(u,[]).append(path) visit(r) if not roles: raise SystemExit("No completed owned assets; retain the original status") manifest=[] for i,(u,paths) in enumerate(roles.items()): target=Path(f"asset-{i}.bin") subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True) raw=target.read_bytes() if not raw: raise SystemExit("Empty asset; retain original status and metadata") ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin" name=f"asset-{i}.{ext}" if target.name!=name: target.rename(name) manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)}) Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2)) print("Saved",len(manifest),"unique owned assets; every response role retained") PY_ASSETS ``` ### Recevoir et enregistrer les résultats #### Ailoot Ultra · Vidéo - `GET /v1/videos/{request_id}` - `GET /v1/videos/generations/{request_id}` - `GET /v1/videos/{request_id}/content` - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Conserver tous les résultats terminés Enregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée. Conservez la réponse et les en-têtes complets, les identifiants d’origine, chaque sortie réelle et tous les champs d’utilisation et de comptabilisation. Enregistrez chaque ressource unique vous appartenant et conservez chaque rôle qui y fait référence. ##### Si la réponse d’origine doit être vérifiée Conservez l’id public renvoyé pour la tâche ou l’opération ainsi que tous les en-têtes. Consultez uniquement la tâche d’origine ; unknown ou result\_pending\_check n’autorise pas une nouvelle création. Champs de la réponse | Champ | Type | | --- | --- | | Champ`id` | Typestring | | Champ`polling_url` | Typestring | | Champ`provider_task_id` | Typestring | | Champ`id` | Typestring | | Champ`task_status` | Typestring | | Champ`video_result[].url` | Typestring | ### Alias #### Alias du modèle **Ailoot Ultra** [`cogvideox-3`](https://ailoot.ai/models/fr/#m=cogvideox-3&route=Ultra&caller=cogvideox-3&fmt=videos) #### Alias des chemins de méthode `/v1/videos/generations` #### ID d’appel associés [`cogvideox-3`](https://ailoot.ai/models/fr/#m=cogvideox-3&route=Ultra&caller=cogvideox-3&fmt=videos) FAQ · Zhipu AI: CogVideoX 3 Quelles entrées et quels résultats sont disponibles ? `POST /v1/videos` · `cogvideox-3`: `text` → `video` Quels champs la requête utilise-t-elle ? `POST /v1/videos` · `cogvideox-3`: `model`, `prompt`, `quality`, `with_audio`, `size`, `fps`, `duration` Connectez Ailoot à Claude Code, OpenCode, Hermes ou à votre application. ## L’entreprise et son portefeuille de projets L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois. ## Achetez des tokens à prix réduit. Une remise d’abonnement pour le travail régulier. Des codes promo jusqu’à 50% sur l’achat de tokens. Abonnement Choisissez une offre à tarif réduit pour vos requêtes régulières. Code promo jusqu’à 50% Saisissez le code à l’achat. Le prix est recalculé selon la promotion en cours. Dépenses dans l’historique Modèle, tokens et montant sont enregistrés pour chaque requête. [Choisir un abonnement](https://ailoot.ai/docs/fr/billing/subscriptions/) · [Voir les prix des modèles](https://ailoot.ai/models/fr/) ## Connectez l’API au produit que vous vendez. SaaS, applications et bots selon l’offre officielle et le contrat de licence Ailoot. Pour la revente, demandez une licence revendeur. Application commerciale Intégrez la génération de texte, d’images, de vidéo et de son aux fonctions payantes de votre service. Licence revendeur Envoyez la description du projet et le mode d’accès. Demandez des conditions écrites d’utilisation et de revente. Documents sur le site L’offre officielle, le contrat de licence et la politique de traitement des données sont accessibles avant connexion. [Demander une licence revendeur](mailto:support@ailoot.ai) · [Offre officielle et contrat de licence](https://ailoot.ai/legal/offer?lang=fr) ## Ailoot · L’entreprise et son portefeuille de projets Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI. L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois. Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.