Runway: Aleph 2.0
Aleph 2.0 modifie des vidéos existantes à l’aide d’instructions textuelles ciblées et d’images clés de guidage. Utilisez-le pour remplacer un objet, changer un arrière-plan, une tenue, l’éclairage ou le style, en précisant les détails de la scène originale qui doivent rester intacts.
À 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.
Aleph 2.0 est le modèle de modification vidéo en contexte de Runway. Il transforme des séquences existantes, filmées ou générées, à l’aide d’une instruction écrite et, éventuellement, d’images clés de guidage. Le processus prévu modifie la partie demandée d’une scène tout en préservant la composition, l’éclairage et les détails qui l’entourent. Il convient ainsi au remplacement d’un produit, au changement de tenue, à la transformation d’un arrière-plan, au rééclairage ou au changement de style visuel, sans recréer toute la scène à partir d’un brief textuel.
Commencez par une action directe et la transformation souhaitée : ajouter, supprimer, remplacer, changer, rééclairer ou modifier le style. Pour remplacer un produit, identifiez l’objet visible et décrivez son remplacement, puis précisez les mouvements de main et de caméra ainsi que le décor environnant à conserver. Pour une scène saisonnière, décrivez la météo ou la lumière à modifier. Une instruction concise et ciblée fournit un objectif de modification plus clair qu’une demande générale d’améliorer le clip entier.
Les images clés de guidage définissent l’aspect du résultat modifié à un instant particulier. Choisissez une image qui montre clairement la cible : une vue large pour changer l’arrière-plan, ou une vue plus rapprochée pour un petit détail ou un accessoire. Dans le processus Edit Studio de Runway, la modification d’une image fixe peut être prévisualisée et affinée avant que la version choisie guide la transformation vidéo. Comparez l’image modifiée avec la source pour les détails du sujet, les contours et les objets à préserver, puis utilisez-la comme direction visuelle du clip.
L’API du producteur prend en charge des vidéos sources de 2 à 30 secondes et jusqu’à cinq images clés facultatives placées à des instants précis. Associez chaque image de guidage au point prévu dans la source et préférez un petit nombre de changements clairs à une collection d’objectifs visuels contradictoires. Aleph 2.0 est distinct de l’ancien modèle Gen-4 Aleph ; le producteur identifie séparément son modèle API. Une modification guidée par des images clés diffère aussi d’une demande faite à un modèle texte-vers-vidéo de créer un plan sans rapport.
Les règles de préparation documentées d’Edit Studio utilisent des rapports largeur/hauteur classiques, une résolution source comprise entre 480p et 1080p et 24 à 30 images par seconde, avec au maximum dix coupes ou changements de plan. Le processus recommande des sources 720p ou 1080p ; dans cette interface, les séquences à plus de 30 images par seconde sont rééchantillonnées à une fréquence inférieure et les téléchargements de plus de 30 secondes sont raccourcis. Il s’agit des règles de préparation du processus de modification du producteur. Choisissez un segment source qui montre l’événement entier à modifier et dont le sujet reste visible là où le changement doit se maintenir.
Le modèle peut propager le changement d’un arrière-plan, d’un vêtement, d’un objet, d’une lumière ou d’un style sur toute la séquence. Une instruction de mouvement supplémentaire est utile lorsque la modification nécessite une nouvelle action absente de la source et qui ne découlerait pas de l’image clé seule, par exemple un effet visuel qui se développe au fil du temps. De nombreuses modifications ne nécessitent aucun brief de mouvement supplémentaire, car le modèle anime l’ajustement de l’image clé dans la scène existante. Décrivez précisément un nouveau mouvement et distinguez-le du changement visuel déjà défini par l’image clé.
Le processus de modification du producteur applique par défaut le changement à toute la vidéo et peut le limiter à une plage sélectionnée de la chronologie. Conservez le clip original afin de comparer le résultat choisi avec la source et de l’utiliser pour une reprise ciblée. Une revue pratique va au-delà de l’image choisie : vérifiez le début, le milieu, la fin, chaque coupe et la période où la cible est brièvement masquée. Le livrable utile est un clip révisé dont la transformation demandée reste cohérente dans le temps, tandis que les éléments importants qui devaient rester inchangés conservent leur rôle.
Le MP4 est le format par défaut pour la lecture et le partage. Le processus Edit Studio de Runway pour les vidéos complètes éligibles propose aussi ProRes sous forme de fichier MOV avec du son PCM, ou un ZIP d’images PNG individuelles pour la composition. Les profils ProRes vont de 422 Proxy à 4444 XQ. Les modifications limitées à une plage de la chronologie renvoient un MP4, et le format de sortie se choisit au lancement de la génération au lieu d’être changé après l’achèvement du résultat. Sélectionnez la forme d’export du producteur adaptée au travail de montage suivant, en la distinguant de la capacité fondamentale du modèle à modifier les images.
Pour une modification finale utile, comparez le remplacement, l’éclairage ou le style souhaités avec l’image clé et examinez les détails environnants qui ne devaient pas changer. Conservez la version réussie et révisez l’instruction ou l’image de guidage précise à l’origine d’un écart. Le rôle d’Aleph 2.0 consiste à transformer des séquences sources à l’aide d’un objectif visuel clair ; produire une nouvelle bande-son, modifier le comportement d’une application ou finaliser une chaîne distincte de livraison pour la diffusion sont des tâches supplémentaires autour de la vidéo modifiée.
Ailoot Ultra · Vidéo POST /v1/videos runway/aleph-2
runway/aleph-2Pour commencer
Aleph 2.0 modifie des vidéos existantes à l’aide d’instructions textuelles ciblées et d’images clés de guidage. Utilisez-le pour remplacer un objet, changer un arrière-plan, une tenue, l’éclairage ou le style, en précisant les détails de la scène originale qui doivent rester intacts.
- Entrées acceptées
- Texte · Images · Audio · Vidéo
- Résultats
- Vidéo
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Vidéo POST /v1/videos
- Entrée
text,image,audio,video- Sortie
video
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites runway/aleph-2 | Par défaut— |
Champinput_references | Typearray | ExigenceObligatoire | Valeurs et limites Nombre minimal d’éléments: 1 Nombre maximal d’éléments: 1 | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, input_references, prompt |
Paramètrematerial_types | Contrattext, image, audio, video |
Paramètrematerial_conditions | ContratUtilisez exactement une URL réelle de contenu d’une ressource vidéo terminée appartenant à votre compte, avec sa signature retournée. Le propriétaire de la ressource, son type et la preuve de ses octets stockés doivent correspondre à la demande. |
Cycle de vie : asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id ou polling_url réellement retourné
GET /v1/videos/{request_id}/content
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. Appliquez la règle de coût minimal indiquée pour cette configuration.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Composant du coût | Unité de facturation | Conditions de facturation | Règle de coût minimal | Coût |
|---|---|---|---|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Composant du coût— | Unité de facturation— | Conditions de facturation— | Règle de coût minimal— | Coût Entrée · Jetons en entrée · Estimation à des fins de comparaison uniquement — / 1K jetons Sortie · Jetons en sortie · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K jetons |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Composant du coût— | Unité de facturationpar seconde de vidéo | Conditions de facturationCette clé de tarification ne déclare aucune condition supplémentaire. | Règle de coût minimal— | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.56 par seconde de vidéo |
| ConfigurationMinimum par génération | Barème tarifaire— | Quantité prévisionnelle— | Composant du coûtCoût minimal | Unité de facturationcoût minimal de génération | Conditions de facturationCette clé de tarification ne déclare aucune condition supplémentaire. | Règle de coût minimalOui | Coût total · Minimum par génération · Estimation à des fins de comparaison uniquement $1.12 coût minimal de génération Facturation minimale par génération; appliquez-la comme minimum, et non comme frais supplémentaires. Cela n’implique aucune durée minimale. |
| ConfigurationCoût de génération estimé | Barème tarifaire— | Quantité prévisionnelleestimation pour une génération | Composant du coût— | Unité de facturation— | Conditions de facturation— | Règle de coût minimal— | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.56 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 · Vidéo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
: "${AILOOT_PROMPT:?Set the actual documented input value}"
export AILOOT_PROMPT
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'runway/aleph-2', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'prompt': '${ACTUAL_EDIT_PROMPT}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['prompt']=os.environ['AILOOT_PROMPT']
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
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 response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
Recevoir et enregistrer les résultats
Ailoot Ultra · Vidéo
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Enregistrer toutes les ressources terminées
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
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, chaque sortie effective, les identifiants initialement renvoyés et tous les champs d’utilisation. Récupérez l’opération d’origine sans soumettre à nouveau sa création.
Si la réponse d’origine doit être vérifiée
Conservez X-Client-Request-ID, X-Ailoot-Task-Id et les valeurs id/polling_url réellement retournées. Poursuivez la tâche d’origine; ne soumettez pas de nouveau la demande de création.
Champs de la réponse
| Champ | Type |
|---|---|
Champid | Type |
Champstatus | Type |
Champdata[] | Type |
Champoutputs[] | Type |
Alias
Alias du modèle
Ailoot Ultra runway/aleph-2
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · Runway: Aleph 2.0
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/videos·runway/aleph-2:text,image,audio,video→video- Quels champs la requête utilise-t-elle ?
POST /v1/videos·runway/aleph-2:model,input_references,prompt