Skip to main content
POST
Use a rota compatível com OpenAI POST /v1/images/generations da CometAPI para executar a geração de imagens Seedream. Este endpoint oferece suporte a prompts de texto para imagem, solicitações com imagem de referência e saída sequencial limitada de imagens quando o modelo selecionado oferece suporte a esses controles. Esta página aborda seedream-5-0-pro-260628 para solicitações Pro de texto para imagem e seedream-5-0-260128 para exemplos do Seedream 5.0 com imagem de referência, sequência e assíncronos. Para disponibilidade na conta, consulte a página Models ou faça uma consulta a /v1/models. Para detalhes dos parâmetros do provedor, consulte a API de geração de imagens da BytePlus e o tutorial do Seedream 4.0-5.0.

​
Escolha um formato de solicitação

  • Texto para imagem: envie model, prompt, size e controles de saída opcionais, como response_format, output_format e watermark.
  • Imagem para imagem: adicione image como um array de URLs HTTPS públicas ou URIs de dados. Use um array mesmo quando enviar uma imagem de referência.
  • Prompt sequencial: defina sequential_image_generation como auto e use sequential_image_generation_options.max_images como limite superior. O modelo pode retornar menos imagens do que o máximo.
  • Tarefa assíncrona: adicione async: true quando quiser que a solicitação de criação retorne data.task_id em vez de manter a conexão HTTP aberta.
As imagens de referência somadas às imagens geradas devem permanecer dentro do limite do provedor. Mantenha as solicitações sequenciais limitadas com max_images.

​
Executar uma tarefa de imagem assíncrona

Defina async como true para trabalhos de imagem que seu cliente deve enviar e consultar. A solicitação de criação retorna data.task_id; use esse valor com Recuperar uma tarefa de imagem Seedream até que data.status seja success ou failure. Use 2K nos exemplos assíncronos para solicitações do Seedream 5.0. O suporte a tamanhos varia por model ID, então escolha um tamanho compatível com o modelo antes de enviar uma tarefa assíncrona.

​
Enviar imagens de referência

Use data:image/png;base64,YOUR_BASE64_IMAGE para dados de imagem inline ou use uma URL HTTPS pública que o provedor possa buscar. Os exemplos da referência da API mostram o formato JSON completo para cada tipo de solicitação.

​
Ler URLs de saída

A url retornada é um link assinado de armazenamento de objetos e pode conter &, % e outros caracteres especiais. Extraia a URL do JSON analisado em vez de copiar uma linha parcial do terminal. Nos exemplos de shell, jq -r '.data[]?.url' preserva a URL assinada completa.

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json

Parameters for Seedream image generation. Send JSON for text-to-image, image-to-image, and sequential prompt requests.

​
model
string
padrão:seedream-5-0-pro-260628
obrigatório

Seedream model ID to use. Query /v1/models or open the Models page for available model IDs.

​
prompt
string
padrão:A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.
obrigatório

Text prompt describing the image or edit goal. Use a concrete visual request, such as a blue ceramic mug on a white table, soft studio lighting.

​
response_format
enum<string>
padrão:url

Response image format. Use url for a temporary signed image URL, or b64_json when you need base64 image data in the response.

Opções disponíveis:
url,
b64_json
​
size
string
padrão:2K

Output resolution. Use a model-supported tier such as 2K or a model-supported WIDTHxHEIGHT value such as 2048x2048. Not every model ID accepts every tier.

​
image
string[]

Optional reference images for image-to-image generation. Each item can be a public HTTPS URL or a data URI such as data:image/png;base64,YOUR_BASE64_IMAGE. Use an array even for one image. Reference images plus generated images must not exceed the provider limit.

​
watermark
boolean
padrão:false

When true, requests a visible AI-generated watermark on the output image. Set false when your workflow handles disclosure separately.

​
async
boolean
padrão:false

CometAPI asynchronous task mode. Set this to true to return immediately with data.task_id, then poll the Seedream image task endpoint GET /v1/images/generations/{task_id} for the final image data.

​
output_format
enum<string>
padrão:png

Output image file format. Use png when you need lossless output, or jpeg for smaller files.

Opções disponíveis:
png,
jpeg
​
guidance_scale
number

Optional prompt-adherence control for model versions that support it. Higher values can follow the prompt more closely but may reduce naturalness. Omit this field when you do not need model-specific tuning.

Intervalo necessário: 1 <= x <= 10
​
seed
integer
padrão:-1

Optional random seed for reproducible attempts on model versions that support seeding. Use -1 or omit the field for a random seed.

Intervalo necessário: -1 <= x <= 2147483647
​
sequential_image_generation
enum<string>
padrão:disabled

Controls sequential prompt handling. Use auto to let the model return a sequence when the prompt calls for one. Use disabled for ordinary single-image requests.

Opções disponíveis:
auto,
disabled
​
sequential_image_generation_options
object

Options for sequential prompt handling. This object is only used when sequential_image_generation is auto.

Resposta

200 - application/json

Image generation response. Synchronous requests return completed image data. Async requests return a task response with data.task_id.

​
created
integer
obrigatório

Unix timestamp in seconds when the image response was created.

​
data
object[]
obrigatório

Generated image results. The array can contain one or more images depending on the request and model response.

​
usage
object

Usage information for the request. Fields vary by model and route.