API do Mage · SDKs
SDKs oficiais da API do Mage
Clientes tipados para TypeScript e Python, e nodes do Mage para ComfyUI. Todos os modelos de imagem, vídeo e áudio em poucas linhas de código.
Resumo rápido
O Mage publica SDKs de código aberto para sua API: @mage-space/sdk no npm para TypeScript e JavaScript, mage-space no PyPI para Python e o pacote de nós comfyui-mage para o ComfyUI. Cada um encapsula a API REST com configurações tipadas para todos os 37 modelos, polling automático, novas tentativas idempotentes e uploads.
- 3SDKs e integrações
- 37Modelos tipados
- MITCódigo aberto
- $0Para instalar
Escolha o seu
SDKs e integrações
npm install @mage-space/sdkSDK para TypeScript
Gere imagens, vídeos e áudios no Node.js com configurações tipadas para cada modelo do Mage. Uma só chamada envia, aguarda e retorna o resultado.
pip install mage-spaceSDK para Python
Gere imagens, vídeos e áudios em Python com clientes síncronos e asyncio e configurações tipadas para cada modelo do Mage.
comfy node install comfyui-mageMage para ComfyUI
Mango, Cherry, Seed Audio e todos os outros modelos do Mage como nós do ComfyUI. Sem GPU, sem baixar modelos.
Início rápido
Sua primeira geração com um SDK
Instale o pacote, exporte MAGE_API_KEY e execute um 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"])Já incluído
O que todo SDK faz por você
Uma chamada, mídia pronta
O run envia a geração, faz polling com o backoff recomendado pela API e retorna a requisição concluída com result.url.
Novas tentativas sem cobrar duas vezes
Todo envio leva uma chave de idempotência. Erros de rede e de servidor são repetidos com backoff, e um envio repetido nunca é cobrado de novo.
Uploads em uma chamada
Arquivos grandes demais para uma data URL passam por um upload assinado, com ticket, PUT e verificação de tamanho tratados para você.
Erros claros
As recusas da API trazem o status HTTP, o código de erro e o ID da requisição; gerações com falha ou canceladas e timeouts têm tipos de erro próprios.
Pacotes
Onde encontrá-los
| SDK | Pacote | Instalação | Código-fonte |
|---|---|---|---|
| SDK para TypeScript | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| SDK para Python | mage-space | pip install mage-space | GitHub |
| Mage para ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
Perguntas frequentes
Perguntas frequentes
Os SDKs do Mage são gratuitos e de código aberto?
Os novos modelos do Mage funcionam com um SDK mais antigo?
Como os SDKs evitam cobrar duas vezes por uma requisição repetida?
Os SDKs são estáveis?
Quanto custa a API do Mage?
Preciso ser membro do Mage para usar a API?
Posso usar os resultados da API para fins comerciais?
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.