API do Flux 2

Resumo rápido

A API do Flux 2 executa o Flux 2 pelo Mage em POST https://api.mage.space/v1/flux2/generate. Uma requisição nas configurações padrão custa 40 Gems (cerca de US$ 0,04), sem assinatura. O Flux 2 não aceita menções com @handle.

• Imagem

  Saída

• 1

  Variante

• 40

  Gems por imagem, padrão

• $0.04

  Aproximadamente, em USD

Visão geral

O que a API do Flux 2 faz

Flux 2 Dev, o modelo de pesos abertos que se destaca com prompts longos e detalhados. Gera ou edita a partir de até 3 imagens de referência, em até 2K.

Flux 2 Dev, um modelo de pesos abertos para prompts longos e detalhados, geração e edições a partir de até três imagens de referência.

Aceita image e additional_images como entradas.

Início rápido

Chame a API do Flux 2

Defina MAGE_API_KEY, envie para /flux2/generate e consulte a status_url até a requisição ser concluída.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/flux2/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": "flux2-dev"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('flux2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'flux2-dev',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("flux2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "flux2-dev",
})

print(request["result"]["url"])

Modelos

Valores de model_id do Flux 2

Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.

Opções

Parâmetros do Flux 2

Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.

Entradas

Entradas de mídia aceitas pelo Flux 2

Envie cada uma como URL https, data URL ou upload de até 100 MB.

Mais modelos de imagem

Outras APIs de geração de imagens no Mage

Perguntas frequentes

Perguntas frequentes

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.

Relacionados

• API de geração de imagens com IA
• Referência da API do Flux 2
• Playground do Flux 2
• Todos os modelos da API
• Servidor MCP do Mage