PixVerse v5
PixVerse v5 crée de courtes vidéos à partir de texte ou d’images. Utilisez un descriptif concret de l’action, une référence préparée si nécessaire et les réglages documentés de cadrage et de résolution pour développer une scène dont la fin convient au montage.
À 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.
PixVerse v5 est un modèle vidéo destiné à la génération de vidéos à partir de texte et d’images. Un descriptif écrit définit l’événement, tandis qu’une image de référence facultative fournit l’apparence et la composition initiales. Attribuez à chaque plan généré un objectif précis, comme présenter un sujet, montrer un geste ou révéler un détail visuel.
Décrivez l’action en termes observables. Une main ouvrant une boîte, une silhouette traversant une cour ou un objet entrant dans la lumière donnent chacun à la séquence un changement identifiable. Précisez quel sujet se déplace, ce qui l’entoure et comment l’événement doit se terminer. Conservez les détails qui rendent la scène reconnaissable.
Pour une création à partir d’une image, choisissez une référence qui convient déjà à la composition souhaitée. Gardez les caractéristiques distinctives visibles et prévoyez de l’espace pour le mouvement demandé. Expliquez la façon dont la scène se développe à partir de cette image. Conservez la source avec la vidéo terminée afin d’évaluer la continuité par comparaison directe.
Le catalogue documenté du modèle propose plusieurs formats d’image et choix de résolution, avec des durées de cinq et huit secondes. Sélectionnez la combinaison proposée pour le flux de travail et enregistrez les valeurs effectivement utilisées. Préparez l’action et la fin en fonction de la durée du plan choisie et du cadrage de destination.
Utilisez les indications de caméra pour guider l’attention. Un point de vue fixe peut mettre en valeur l’action d’un sujet, tandis qu’un point de vue mobile peut révéler un décor ou un détail. Expliquez la relation de la caméra avec le sujet afin que le mouvement serve la scène. Examinez la fin pour vérifier qu’elle laisse visibles les informations souhaitées.
Pour une série de plans liés, veillez à la cohérence des descriptions du sujet récurrent et du décor dans les descriptifs concernés. Conservez chaque référence et chaque modèle sélectionné avec son résultat. Assemblez les clips terminés dans l’ordre prévu et examinez les changements d’apparence, d’éclairage et de relations spatiales au fil du montage.
Examinez chaque vidéo dans son intégralité pour vérifier l’action demandée, la continuité et le rythme. Observez les mains, les visages, les silhouettes des objets et les détails des matériaux lorsqu’ils sont importants pour la scène. Vérifiez les moments où les sujets se chevauchent ou changent d’angle. Un plan exploitable reste compréhensible au-delà de sa meilleure image fixe.
Enregistrez la vidéo terminée avec le prompt, l’image source et les réglages. Lorsqu’une version doit être révisée, identifiez l’écart concret et modifiez la consigne qui s’y rapporte. Maintenez les choix réussis de composition et d’apparence afin de comparer le résultat suivant au même objectif visuel.
Ailoot Ultra · Video POST /v1/videos pixverse-v5
pixverse-v5Premiers pas
PixVerse v5 crée de courtes vidéos à partir de texte ou d’images. Utilisez un descriptif concret de l’action, une référence préparée si nécessaire et les réglages documentés de cadrage et de résolution pour développer une scène dont la fin convient au montage.
- 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
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites pixverse-v5 Conditions: Utilisez exactement ce sélecteur de routage Ailoot. | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Conditions: Décrivez la scène et les mouvements qui s’y déroulent. | Par défaut— |
Champaspect_ratio | Typestring | ExigenceFacultatif | Valeurs et limites 16:9, 4:3, 1:1, 3:4, 9:16 Conditions: Utilisez l’un des rapports largeur/hauteur indiqués pour le modèle sélectionné. | Par défaut— |
Champquality | Typestring | ExigenceFacultatif | Valeurs et limites 360p, 540p, 720p, 1080p Conditions: Utilisez la valeur de qualité indiquée pour le modèle sélectionné. | Par défaut— |
Champmotion_mode | Typestring | ExigenceFacultatif | Valeurs et limites normal, fast Conditions: Utilisez le mode de mouvement indiqué pour le modèle sélectionné. | Par défaut— |
Champduration | Typeinteger | ExigenceFacultatif | Valeurs et limites 5, 8 Conditions: Utilisez une durée indiquée ; ne supposez aucune valeur par défaut non précisée. | Par défaut— |
Champend_image | Typestring | ExigenceFacultatif | Valeurs et limites Conditions: Une image finale facultative sélectionne un mode d’image pris en charge. | Par défaut— |
Champlip_sync_tts_content | Typestring | ExigenceFacultatif | Valeurs et limites Conditions: Contenu vocal facultatif pour le modèle sélectionné. | Par défaut— |
Champlip_sync_tts_speaker_id | Typestring | ExigenceFacultatif | Valeurs et limites Conditions: Utilisez un identifiant de voix réel pris en charge par le fournisseur ; n’inventez aucun identifiant de voix. | Par défaut— |
Champimage | Typestring or array<string> | ExigenceFacultatif | Valeurs et limites Conditions: Utilisez l’URL réelle de votre image, accessible publiquement, ou une image encodée en base64 ; le modèle sélectionné accepte les images en entrée. | Par défaut— |
Champnegative_prompt | Typestring | ExigenceFacultatif | Valeurs et limites Conditions: Décrivez le contenu à éviter. | Par défaut— |
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt |
Paramètreoptional | Contrataspect_ratio, quality, motion_mode, duration, end_image, lip_sync_tts_content, lip_sync_tts_speaker_id, image, negative_prompt |
Paramètrematerial_types | Contrattext, image |
Paramètreconditions | ContratUtilisez exactement ce sélecteur de routage Ailoot., Décrivez la scène et les mouvements qui s’y déroulent., Utilisez l’un des rapports largeur/hauteur indiqués pour le modèle sélectionné., Utilisez la valeur de qualité indiquée pour le modèle sélectionné., Utilisez le mode de mouvement indiqué pour le modèle sélectionné., Utilisez une durée indiquée ; ne supposez aucune valeur par défaut non précisée., Une image finale facultative sélectionne un mode d’image pris en charge., Contenu vocal facultatif pour le modèle sélectionné., Utilisez un identifiant de voix réel pris en charge par le fournisseur ; n’inventez aucun identifiant de voix., Utilisez l’URL réelle de votre image, accessible publiquement, ou une image encodée en base64 ; le modèle sélectionné accepte les images en entrée., Décrivez le contenu à éviter. |
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 | Coût |
|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité 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ération | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.2 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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "pixverse-v5",
"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.
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}/contentGET /v1/media/assetsGET /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 les 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 tous les rôles qui y font référence.
Si la réponse d’origine doit être vérifiée
Conservez l’identifiant public id de la tâche ou de l’opération renvoyée, 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 |
|---|---|
Champid | Typestring |
Champpolling_url | Typestring |
Champprovider_task_id | Typestring |
Champtask_id | Typestring |
Champstatus | Typestring |
Champvideo_url | Typestring |
Alias
Alias du modèle
Ailoot Ultra pixverse-v5
Alias des chemins de méthode
/v1/videos/generations
ID d’appel associés
FAQ · PixVerse v5
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/videos·pixverse-v5:text,image→video- Quels champs la requête utilise-t-elle ?
POST /v1/videos·pixverse-v5:model,prompt,aspect_ratio,quality,motion_mode,duration,end_image,lip_sync_tts_content,lip_sync_tts_speaker_id,image,negative_prompt