FLUX.2

FLUX.2 é a família de imagem da Black Forest Labs na Pixapi com controle de resolução. Escolha flux-2-pro, flux-2-max ou flux-2-flex e envie resolution como 1MP, 2MP, 3MP ou 4MP.

Superfície da API

Operação	Endpoint	Modo
Geração de imagens	POST /v1/images/generations	Síncrono
Tarefa de geração de imagens	POST /v1/async/images/generations	Assíncrono
Edição de imagens	POST /v1/images/edits	Síncrono
Tarefa de edição de imagens	POST /v1/async/images/edits	Assíncrono

IDs do modelo

ID do modelo	Ideal para
flux-2-pro	Qualidade e custo FLUX.2 equilibrados
flux-2-max	Saída FLUX.2 de maior qualidade
flux-2-flex	Níveis de resolução FLUX.2 flexíveis

Preços

ID do modelo	1MP	2MP	3MP	4MP
flux-2-pro	3	4	5	6
flux-2-max	6	8	10	13
flux-2-flex	4	8	12	16

Se você omitir resolution, a Pixapi cobra o nível 1MP.

Campos de requisição

Campo	Tipo	Obrigatório	Descrição
model	string	Sim	Use flux-2-pro ou flux-2-max ou flux-2-flex. Os IDs distinguem maiúsculas.
prompt	string	Sim	Texto do prompt, até 2.000 caracteres.
image	string | string[]	Obrigatório para edições	URL pública de imagem ou uma matriz de URLs.
n	integer	Não	Número de saídas. Valor inicial 1, máximo 9.
size	string	Não	Tamanho de saída suportado pelo provedor. Encaminhado como está.
quality	string	Não	Valor de qualidade opcional do provedor.
output_format	string	Não	Formato de saída opcional, por exemplo png, quando o origem suportar.
resolution	string	Não	1MP (inicial), 2MP, 3MP ou 4MP. Controla o nível de saída e a cobrança.
providerOptions	object	Não	Campos adicionais do provedor encaminhados pelo gateway.

Exemplo

cURL

curl https://api.pixapi.ai/v1/images/generations \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"flux-2-pro","prompt":"Foto editorial de produto em um fundo cinza quente","n":1,"resolution":"2MP"}'

Python

import os
import requests

response = requests.post(
    "https://api.pixapi.ai/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['PIXAPI_KEY']}",
        "Content-Type": "application/json",
    },
    json={
  "model": "flux-2-pro",
  "prompt": "Foto editorial de produto em um fundo cinza quente",
  "n": 1,
  "resolution": "2MP"
},
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://api.pixapi.ai/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "model": "flux-2-pro",
  "prompt": "Foto editorial de produto em um fundo cinza quente",
  "n": 1,
  "resolution": "2MP"
}),
});

if (!response.ok) {
  throw new Error(await response.text());
}

console.log(await response.json());

Go

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  body := []byte(`{
  "model": "flux-2-pro",
  "prompt": "Foto editorial de produto em um fundo cinza quente",
  "n": 1,
  "resolution": "2MP"
}`)

  req, err := http.NewRequest(
    "POST",
    "https://api.pixapi.ai/v1/images/generations",
    bytes.NewBuffer(body),
  )
  if err != nil {
    panic(err)
  }
  req.Header.Set("Authorization", "Bearer "+os.Getenv("PIXAPI_KEY"))
  req.Header.Set("Content-Type", "application/json")

  resp, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  result, _ := io.ReadAll(resp.Body)
  fmt.Println(string(result))
}

Editar uma imagem

{
  "model": "flux-2-pro",
  "prompt": "Substitua o fundo por um estúdio minimalista",
  "image": "https://example.com/input.png",
  "n": 1
}

Para requisições assíncronas e polling, consulte Tarefas assíncronas de mídia.

O formato de resposta compartilhado está na Referência da API.