API de Mage · SDK
SDK oficiales para la API de Mage
Clientes tipados para TypeScript y Python, y nodos de Mage para ComfyUI. Todos los modelos de imagen, vídeo y audio en unas pocas líneas de código.
De un vistazo
Mage publica SDK de código abierto para su API: @mage-space/sdk en npm para TypeScript y JavaScript, mage-space en PyPI para Python y el paquete de nodos comfyui-mage para ComfyUI. Cada uno envuelve la API REST con configuraciones tipadas para los 37 modelos, sondeo automático, reintentos idempotentes y subidas de archivos.
- 3SDK e integraciones
- 37Modelos tipados
- MITCódigo abierto
- $0Para instalar
Elige el tuyo
SDK e integraciones
npm install @mage-space/sdkSDK de TypeScript
Genera imágenes, vídeo y audio desde Node.js con configuraciones tipadas para cada modelo de Mage. Una sola llamada envía, espera y devuelve el resultado.
pip install mage-spaceSDK de Python
Genera imágenes, vídeo y audio desde Python con clientes síncronos y asyncio, y configuraciones tipadas para cada modelo de Mage.
comfy node install comfyui-mageMage para ComfyUI
Mango, Cherry, Seed Audio y todos los demás modelos de Mage como nodos de ComfyUI. Sin GPU ni descargas de modelos.
Inicio rápido
Tu primera generación con un SDK
Instala el paquete, exporta MAGE_API_KEY y ejecuta un modelo.
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v4',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4",
})
print(request["result"]["url"])Integrado
Lo que todos los SDK hacen por ti
Una llamada, contenido terminado
run envía la generación, consulta el estado con el backoff que recomienda la API y se resuelve con la solicitud completada y result.url.
Reintentos que nunca cobran dos veces
Cada envío lleva una clave de idempotencia. Los errores de red y de servidor se reintentan con backoff, y un envío reintentado nunca se cobra de nuevo.
Subidas en una llamada
Los archivos demasiado grandes para una URL de datos pasan por una subida firmada, y el ticket, el PUT y la comprobación de tamaño se gestionan por ti.
Errores claros
Los rechazos de la API incluyen su estado HTTP, código de error e ID de solicitud; las generaciones fallidas o canceladas y los tiempos de espera agotados tienen sus propios tipos de error.
Paquetes
Dónde conseguirlos
| SDK | Paquete | Instalación | Código fuente |
|---|---|---|---|
| SDK de TypeScript | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| SDK de Python | mage-space | pip install mage-space | GitHub |
| Mage para ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
Preguntas frecuentes
Preguntas frecuentes
¿Los SDK de Mage son gratuitos y de código abierto?
¿Los modelos nuevos de Mage funcionan con un SDK anterior?
¿Cómo evitan los SDK pagar dos veces por una solicitud reintentada?
¿Son estables los SDK?
¿Cuánto cuesta la API de Mage?
¿Necesito una membresía de Mage para usar la API?
¿Puedo usar comercialmente los resultados de la API?
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.