Genjutsu Light 1.0 Object Swap API
Sustituye objetos en un video de origen con imágenes de referencia
- 720p
- NanoAPI 0,234 $ / segundo
- 1080p
- NanoAPI 0,468 $ / segundo
Comparar precios
Compara los precios públicos de los proveedores para la misma especificación de salida
Notas de precios
Se cobra según el proveedor que realmente ejecuta la tarea. El failover puede cambiar de proveedor, lo que puede modificar el costo y el tiempo.
Usar la API
Deja el código a un agente de programación, genera en el chat con MCP o la Skill, o intégralo tú mismo con el SDK o la API compatible con OpenAI.
Deja que un agente de programación lo integre
Copia el prompt de integración o ábrelo directamente en Codex o Claude. El agente lee esta página y el contrato del modelo, y luego escribe en tu proyecto el envío, la espera y el manejo de resultados.
Añade el servidor MCP de Yir
Conéctalo a ChatGPT, Claude o Cursor, menciona @Yir y pide Genjutsu Light 1.0 Object Swap por su nombre. Primero te da el precio y solo genera cuando confirmas.
https://gateway.yir.ai/mcpUn comando para Claude Code
Crea una API key en la consola, guárdala como YIR_API_KEY y ejecuta:
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Instala la Skill de Yir
Define YIR_API_KEY donde se ejecuta tu agente, añade la Skill a Claude Code, Codex u otro agente de programación y di “usa Genjutsu Light 1.0 Object Swap en Yir para crear…”.
npx skills add yir-ai/skillsInstala el SDK oficial con tu gestor de paquetes o copia el fragmento de código de abajo para empezar
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // Lee YIR_API_KEY del entorno por defecto: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. Envía una tarea de generación de video |
| const job = await client.submitVideo({ |
| model: "higgsfield/genjutsu-light-1.0-object-swap", |
| input: { |
| type: "reference", |
| prompt: "Una tortuga marina nada despacio sobre un arrecife de coral. La cámara la sigue suavemente de lado mientras la luz del sol atraviesa el agua clara y proyecta reflejos en movimiento sobre su caparazón", |
| references: [], |
| }, |
| parameters: { |
| duration: 5, |
| resolution: "720p", |
| aspect_ratio: "auto", |
| generate_audio: false, |
| n: 1, |
| }, |
| }); |
| // 2. Espera a que la tarea termine y entregue el resultado |
| const result = await client.waitForJob(job.id); |
| console.log("Archivos entregados:", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
Los proyectos que ya usan el protocolo de OpenAI, o gateways como new-api, solo necesitan una nueva Base URL y una nueva clave. Guía de compatibilidad con OpenAI
- base_url del SDK de OpenAI
https://gateway.yir.ai/openai/v1- Base URL del canal en new-api
https://gateway.yir.ai/openai- Clave
- API Key de Yir
- ID del modelo
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": "Una tortuga marina nada despacio sobre un arrecife de coral. La cámara la sigue suavemente de lado mientras la luz del sol atraviesa el agua clara y proyecta reflejos en movimiento sobre su caparazón",
"resolution": "720p",
"aspect_ratio": "auto",
"seconds": "5"
}'Resumen de parámetros
Parámetros comunes; los límites dependen del modelo actual y del proveedor seleccionado
- Resolución resolution
- 720p
- 1080p
Nivel de resolución de salida. Las resoluciones más altas dan mayor nitidez y el precio aumenta en consecuencia
- Relación de aspecto aspect_ratio
- auto
Proporción geométrica. Elígela según el medio de destino (vertical, banner o cuadrado)
- Modo de entrada input_mode
- Entrada de referencias
Los límites y formatos de las referencias dependen del modelo y del proveedor seleccionado
- Duración duration
- 4–30 segundos
Nivel de duración del video de salida, cobrado por segundo o por tramos
- Referencias references
- reference_image ≤ 10
- reference_video ≤ 1
Los límites por modo dependen del proveedor elegido. Las cantidades de la tabla son ejemplos de precio, no límites ni cuotas gratuitas.





