models

viduq3-pro

Markdown · JSON

viduq3-pro

Vidu Q3 Pro crée une vidéo à partir d’un prompt et d’un aspect_ratio obligatoire. Ailoot expose des paramètres de durée, de résolution, de style, de mouvement et de son pour le plan.

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

Sélectionnez viduq3-pro avec model, prompt et aspect_ratio sur /v1/videos. La requête propose des durées d’une à seize secondes et une résolution 540p, 720p ou 1080p, avec cinq secondes et 720p par défaut. Les champs style, movement_amplitude, bgm et audio sont aussi exposés.

Décrivez le sujet, l’action, le décor et les consignes de caméra comme un plan cohérent minuté. Laissez assez de temps à une action plus longue pour atteindre la pose finale souhaitée et précisez le cadrage final. Conservez les réglages de style et de son choisis avec le brief ; examinez leur traitement réel dans la vidéo terminée. Utilisez ensemble le fichier renvoyé, le prompt et les paramètres pour évaluer une variante ultérieure.

Soumettez le plan une seule fois via /v1/videos et conservez l’identifiant de requête renvoyé. Interrogez cette même opération via /v1/videos/{request_id}, puis enregistrez toutes les vidéos terminées et la réponse complète. Comparez l’action entière et la composition finale aux documents et au brief fournis.

Ailoot Ultra · Video POST /v1/videos viduq3-pro

viduq3-pro

Autre /viduq3-pro

Premiers pas

Vidu Q3 Pro crée une vidéo à partir d’un prompt et d’un aspect_ratio obligatoire. Ailoot expose des paramètres de durée, de résolution, de style, de mouvement et de son pour le plan.

Entrées acceptées
Texte · Images
Résultats
Vidéo

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Video POST /v1/videos
Entrée
text, image
Sortie
video
ChampTypeExigenceValeurs et limitesPar défaut
ChampmodelTypestringExigenceObligatoireValeurs et limites
viduq3-pro
Conditions: Utilisez exactement ce sélecteur de routage Ailoot.
Par défaut—
ChamppromptTypestringExigenceObligatoireValeurs et limites
Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée.
Par défaut—
ChampstyleTypestringExigenceFacultatifValeurs et limites
Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée.
Par défaut—
Champaspect_ratioTypestringExigenceObligatoireValeurs et limites
Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée.
Par défaut—
ChampdurationTypeintegerExigenceFacultatifValeurs et limites
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16
Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée.
Par défaut5
ChampresolutionTypestringExigenceFacultatifValeurs et limites
540p, 720p, 1080p
Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée.
Par défaut720p
Champmovement_amplitudeTypestringExigenceFacultatifValeurs et limites
Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée.
Par défaut—
ChampbgmTypebooleanExigenceFacultatifValeurs et limites
Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée.
Par défaut—
ChampaudioTypebooleanExigenceFacultatifValeurs et limites
Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée.
Par défaut—
Paramètres et cycle de vie de la méthode
ParamètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, prompt, aspect_ratio
ParamètreoptionalContratstyle, duration, resolution, movement_amplitude, bgm, audio
Paramètrematerial_typesContrattext, image
ParamètreconditionsContratUtilisez exactement ce sélecteur de routage Ailoot., Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée., Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée., Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée., Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée., Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée., Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée., Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisée., Utilisez le champ documenté pour le modèle sélectionné et les choix indiqués ; omettez toute valeur facultative non précisé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.

ConfigurationBarème tarifaireQuantité prévisionnelleCoût
ConfigurationTarifs de base des jetonsBarème tarifaireTarif de baseQuantité prévisionnelle—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
ConfigurationCoût estimé de la générationBarème tarifaire—Quantité prévisionnelleEstimation pour une générationCoût
Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.14 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 →

Exemples de requêtes

Ailoot Ultra · Video

curl · créer une seule fois et conserver le résultat completLisez la tâche d’origineEnregistrez chaque ressource finalisée qui vous appartient
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_ASPECT_RATIO:?Set an actual customer material or documented value}"
export AILOOT_ASPECT_RATIO
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "viduq3-pro", "prompt": "A cat is walking on grass.", "aspect_ratio": "YOUR_DOCUMENTED_ASPECT_RATIO"}')
p['aspect_ratio']=os.environ['AILOOT_ASPECT_RATIO']
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
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
# Submit once. Retain the complete result, original identifiers and every response header.
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
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 · Video

  • 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 complète et ses en-têtes, les identifiants d’origine, chaque résultat réel et tous les champs de consommation et de comptabilisation. Enregistrez chaque ressource unique dont vous êtes propriétaire et conservez chaque rôle qui y renvoie.

Si la réponse d’origine doit être vérifiée

Conservez l’id public de la tâche ou de l’opération renvoyé 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
ChampType
ChampidTypestring
Champpolling_urlTypestring
Champprovider_task_idTypestring
Champtask_idTypestring
ChampstatusTypestring
Champvideo_urlTypestring
Erreurs et étapes suivantes
RéponseConditionÉtape suivante
Réponse400 · invalid_request_errorConditionUn champ obligatoire, un sélecteur de modèle, un type ou une représentation de l’entrée est invalide.Étape suivanteExaminez les détails de validation renvoyés avant de préparer une requête distincte.
RéponseConditionLa requête d’origine ou son résultat est inconnu ou nécessite une vérification.Étape suivanteConservez les identifiants et les en-têtes d’origine ; consultez uniquement les enregistrements d’état ou de bibliothèque pris en charge. Ne soumettez pas à nouveau la requête de création.

Alias

Alias du modèle

Ailoot Ultra viduq3-pro

Alias des chemins de méthode

/v1/videos/generations

ID d’appel associés

viduq3-pro

FAQ · viduq3-pro
Quelles entrées et quels résultats sont disponibles ?

POST /v1/videos · viduq3-pro: text, image → video

Quels champs la requête utilise-t-elle ?

POST /v1/videos · viduq3-pro: model, prompt, style, aspect_ratio, duration, resolution, movement_amplitude, bgm, audio

Plus de détails

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 · Voir les prix des modèles

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 · Offre officielle et contrat de licence