Geração de Imagens Seedream

Use o CometAPI POST /v1/images/generations para geração Seedream de texto para imagem e de imagem para imagem — com suporte a saída sequencial de múltiplas imagens e imagens de referência.

POST /v1/images/generations

cURL

Text to Image (5.0)

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "a cat wearing a scarf sitting by the window watching rain, illustration style",
    "size": "2K",
    "response_format": "url",
    "watermark": false
  }' | jq -r '.data[].url'

200

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ],
  "usage": {
    "generated_images": 123,
    "output_tokens": 123,
    "total_tokens": 123
  },
  "model": "<string>"
}

​

Visão geral

Gere imagens usando os modelos Seedream da ByteDance por meio do endpoint padrão compatível com OpenAI /v1/images/generations. Compatível com geração text-to-image e image-to-image.

Para ver a lista completa de modelos, consulte a página de modelos. Para a documentação detalhada dos parâmetros do provedor, consulte a documentação da VolcEngine.

Ao usar geração sequencial (múltiplas imagens), defina sequential_image_generation como auto e, opcionalmente, configure sequential_image_generation_options.max_images para limitar o número de imagens geradas. O total de imagens de referência mais imagens geradas deve ser ≤ 15.

​

Imagem para imagem

Passe uma ou mais imagens de referência pelo parâmetro image (array de URLs ou data URIs em base64) junto com um prompt de texto. Suporta até 14 imagens de referência.

​

A URL retornada gera AccessDenied?

A url retornada é um link assinado de armazenamento de objetos que contém & e outros caracteres especiais.
Se você copiar o JSON bruto e colá-lo diretamente em um navegador ou script, o escaping do shell ou o truncamento do terminal pode remover os parâmetros de assinatura, resultando em:

\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}

Como corrigir:

• curl: use um pipe com | jq -r '.data[].url' para extrair a URL corretamente.
• Python: use result.data[0].url ou image["url"] — a string já está completa; passe-a diretamente para requests.get() ou webbrowser.open().
• JavaScript: mesma ideia — result.data[0].url.
• Geral: certifique-se de que & e % na URL não sejam truncados nem recebam escape duplo.

Autorizações

Authorization · string · header · obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json

Parameters for Seedream image generation (text-to-image and image-to-image).

model · string · padrão: doubao-seedream-5-0-260128 · obrigatório

Model to use. See the Models page for current Seedream model IDs.

prompt · string · padrão: a cat wearing a scarf sitting by the window · obrigatório

Text prompt describing the image to generate. Supports both Chinese and English. Recommended max 300 Chinese characters or 1000 English characters.

response_format · enum<string> · padrão: url

Output format. url returns a temporary image link (valid for 24 hours); b64_json returns base64-encoded image data.

Opções disponíveis: url, b64_json

size · string · padrão: 2048x2048

Output resolution. Presets 2K, 4K, or exact pixels like 2048x2048, 2304x1728, 2848x1600, 1600x2848, etc. Default: 2048x2048.

image · string[]

Reference image(s) for image-to-image generation. Each item is a public URL or base64 data URI (data:image/png;base64,...). Supports up to 14 reference images. Supported formats: jpeg, png, webp, bmp, tiff, gif.

watermark · boolean · padrão: true

When true, adds an 'AI Generated' watermark to the bottom-right corner of the output image.

guidance_scale · number · padrão: 2.5

Controls how closely the output follows the prompt. Higher values increase adherence but may reduce naturalness. Range: 1.0–10.0. Not supported by Seedream 5.0 (ignored).

seed · integer · padrão: -1

Random seed for reproducible outputs. Range: -1 to 2147483647. Use -1 (default) for random generation. Legacy parameter — ignored by newer models.

sequential_image_generation · enum<string> · padrão: disabled

Controls sequential (multi-image) generation mode.

• auto: model decides whether to generate a sequence based on the prompt
• disabled: always generate a single image

Opções disponíveis: auto, disabled

sequential_image_generation_options · object

Configuration for sequential (multi-image) generation. Only effective when sequential_image_generation is auto.

Show child attributes

output_format · enum<string> · padrão: jpeg

Output image file format. Options: png, jpeg.

Opções disponíveis: png, jpeg

Resposta

200 - application/json

Successful Response

created · integer · obrigatório

Unix timestamp (seconds) when the image was generated.

data · object[] · obrigatório

Array of generated image objects.

Show child attributes

usage · object · obrigatório

Resource usage information for this request.

Show child attributes

model · string

The model used for generation.