API do Mage · Modelo de imagem
API do Z-Image
O modelo de imagem mais rápido do Mage
POST https://api.mage.space/v1/z_image/generateResumo rápido
A API do Z-Image executa o Z-Image pelo Mage em POST https://api.mage.space/v1/z_image/generate. Uma requisição com as configurações padrão custa 10 Gems (cerca de US$ 0,01), sem assinatura. O Z-Image não aceita menções com @handle.
- ImagemSaída
- 1Variante
- 10Gems por imagem, padrão
- $0.01Aproximadamente, em USD
Visão geral
O que a API do Z-Image faz
Ultrarrápido e econômico em Gems. Texto para imagem fotorrealista com boa anatomia e letras nítidas, até 2K; sem imagens de referência.
O modelo de imagem mais rápido do Mage: texto para imagem fotorrealista com boa anatomia e letras nítidas, em 1K ou 2K.
Ele gera apenas a partir do prompt.
Início rápido
Chame a API do Z-Image
Defina MAGE_API_KEY, envie para /z_image/generate e consulte a status_url até a requisição ser concluída.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/z_image/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "z-image-turbo"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"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('z_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'z-image-turbo',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("z_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "z-image-turbo",
})
print(request["result"]["url"])Modelos
Valores de model_id do Z-Image
Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.
| model_id | Nome | Padrão |
|---|---|---|
| z-image-turbo | Z-Image | Sim |
Opções
Parâmetros do Z-Image
Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.
| Campo | Valores |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1k, 2k |
Mais modelos de imagem
Outras APIs de geração de imagens no Mage
API do Anima
Feito sob medida para anime
API do Chroma
Pesos abertos, baseado no Flux
API do Flux 2
Prompts longos e edições com várias referências
API do GPT Image 2
Prompts precisos e texto legível
API do Grok Image
Grok Imagine, em dois níveis
API do Guava
Fotorrealismo que parece uma fotografia de verdade
Perguntas frequentes
Perguntas frequentes
Quanto custa a API do Z-Image?
Qual é o endpoint da API do Z-Image?
Quais modelos do Z-Image posso chamar?
O Z-Image aceita imagens de referência ou personagens?
Posso usar o Z-Image no Claude ou no ChatGPT?
Por quanto tempo os resultados do Z-Image ficam guardados?
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.