Seedream 5.0

Seedream 5.0 é a família de imagem da ByteDance na Pixapi. Troque entre Pro e Lite alterando o campo model.

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
seedream-5-0-pro	Geração e edição Seedream de maior qualidade
seedream-5-0-lite	Fluxos Seedream de menor custo

Preços

ID do modelo	Créditos / imagem
seedream-5-0-pro	4
seedream-5-0-lite	3

Campos de requisição

Campo	Tipo	Obrigatório	Descrição
model	string	Sim	Use seedream-5-0-pro ou seedream-5-0-lite. 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.
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":"seedream-5-0-pro","prompt":"Foto editorial de produto em um fundo cinza quente","n":1,"size":"1024x1024"}'

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": "seedream-5-0-pro",
  "prompt": "Foto editorial de produto em um fundo cinza quente",
  "n": 1,
  "size": "1024x1024"
},
)
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": "seedream-5-0-pro",
  "prompt": "Foto editorial de produto em um fundo cinza quente",
  "n": 1,
  "size": "1024x1024"
}),
});

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": "seedream-5-0-pro",
  "prompt": "Foto editorial de produto em um fundo cinza quente",
  "n": 1,
  "size": "1024x1024"
}`)

  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": "seedream-5-0-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.