Genjutsu Light 1.0 Object Swap API
Remplacez des objets dans une vidéo source à l’aide d’images de référence
- 720p
- NanoAPI 0,234 $ / seconde
- 1080p
- NanoAPI 0,468 $ / seconde
Comparer les prix
Comparez les prix publics des fournisseurs pour la même spécification de sortie
Notes sur les prix
Facturé par le fournisseur qui exécute réellement la tâche. Un basculement peut changer de fournisseur, ce qui peut modifier le coût et la durée.
Utiliser l’API
Confiez le code à un agent, générez directement dans la conversation avec MCP ou la Skill, ou intégrez vous-même avec le SDK ou l’API compatible OpenAI.
Confiez l’intégration à un agent de code
Copiez le prompt d’intégration, ou ouvrez-le directement dans Codex ou Claude. L’agent lit cette page et le contrat du modèle, puis écrit dans votre projet l’envoi, l’attente et la gestion des résultats.
Ajouter le serveur MCP Yir
Connectez-le à ChatGPT, Claude ou Cursor, mentionnez @Yir et demandez Genjutsu Light 1.0 Object Swap par son nom. Il annonce d’abord le prix et ne génère qu’après votre confirmation.
https://gateway.yir.ai/mcpUne commande pour Claude Code
Créez une clé API dans la console, définissez-la comme YIR_API_KEY, puis lancez :
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Installer la Skill Yir
Définissez YIR_API_KEY là où tourne votre agent, ajoutez la Skill à Claude Code, Codex ou un autre agent de code, puis dites « utilise Genjutsu Light 1.0 Object Swap sur Yir pour créer… ».
npx skills add yir-ai/skillsInstallez le SDK officiel avec votre gestionnaire de paquets, ou copiez l’extrait de code ci-dessous pour commencer
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // Lit YIR_API_KEY depuis l’environnement par défaut: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. Soumettre une tâche de génération de vidéo |
| const job = await client.submitVideo({ |
| model: "higgsfield/genjutsu-light-1.0-object-swap", |
| input: { |
| type: "reference", |
| prompt: "Une tortue de mer nage lentement au-dessus d’un récif de corail. La caméra la suit en douceur de côté tandis que la lumière du soleil traverse l’eau claire et projette des reflets mouvants sur sa carapace", |
| references: [], |
| }, |
| parameters: { |
| duration: 5, |
| resolution: "720p", |
| aspect_ratio: "auto", |
| generate_audio: false, |
| n: 1, |
| }, |
| }); |
| // 2. Attendre la fin de la tâche et la livraison du résultat |
| const result = await client.waitForJob(job.id); |
| console.log("Fichiers livrés :", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
Les projets qui utilisent déjà le protocole OpenAI, ou les passerelles comme new-api, n’ont besoin que d’une nouvelle Base URL et d’une nouvelle clé. Guide de compatibilité OpenAI
- base_url du SDK OpenAI
https://gateway.yir.ai/openai/v1- Base URL du canal new-api
https://gateway.yir.ai/openai- Clé
- API Key Yir
- ID du modèle
higgsfield/genjutsu-light-1.0-object-swap
curl https://gateway.yir.ai/openai/v1/videos \
-H "Authorization: Bearer $YIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "higgsfield/genjutsu-light-1.0-object-swap",
"prompt": "Une tortue de mer nage lentement au-dessus d’un récif de corail. La caméra la suit en douceur de côté tandis que la lumière du soleil traverse l’eau claire et projette des reflets mouvants sur sa carapace",
"resolution": "720p",
"aspect_ratio": "auto",
"seconds": "5"
}'Aperçu des paramètres
Paramètres courants ; les limites dépendent du modèle actuel et du fournisseur sélectionné
- Résolution resolution
- 720p
- 1080p
Niveau de résolution de sortie. Plus la résolution est élevée, plus l’image est nette et plus le prix augmente
- Format d’image aspect_ratio
- auto
Rapport largeur/hauteur. Choisissez-le selon le support visé (portrait, bannière ou carré)
- Mode d’entrée input_mode
- Entrée de références
Les limites et formats des références dépendent du modèle et du fournisseur sélectionné
- Durée duration
- 4–30 secondes
Niveau de durée de la vidéo de sortie, facturé à la seconde ou par palier
- Références references
- reference_image ≤ 10
- reference_video ≤ 1
Les limites par mode dépendent du fournisseur choisi. Les quantités du tableau sont des exemples de prix, pas des limites ni des quotas gratuits.





