Maak Seedream-afbeeldingen

POST

images

generations

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro-260628",
  "prompt": "A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.",
  "size": "2K",
  "response_format": "url",
  "output_format": "png",
  "watermark": false
}' | jq -r '.data[]? | .url // .b64_json'

{
  "created": 1781075000,
  "data": [
    {
      "url": "https://<provider-cdn>/<file_id>.png",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "total_tokens": 0
  }
}

Gebruik CometAPI’s OpenAI-compatibele POST /v1/images/generations-route om Seedream-afbeeldingsgeneratie uit te voeren. Dit endpoint ondersteunt text-to-image-prompts, verzoeken met referentieafbeeldingen en begrensde sequentiële afbeeldingsuitvoer wanneer het geselecteerde model die opties ondersteunt. Deze pagina behandelt seedream-5-0-pro-260628 voor Pro text-to-image-verzoeken en seedream-5-0-260128 voor Seedream 5.0-voorbeelden met referentieafbeeldingen, sequentiële generatie en async. Zie voor beschikbaarheid per account de Models page of raadpleeg /v1/models. Zie voor details over providerparameters de BytePlus image generation API en de Seedream 4.0-5.0 tutorial.

Kies een request-vorm

Text to image: verstuur model, prompt, size en optionele output-opties zoals response_format, output_format en watermark.
Image to image: voeg image toe als een array met openbare HTTPS-URL’s of data-URI’s. Gebruik een array, zelfs wanneer je één referentieafbeelding verstuurt.
Sequential prompt: stel sequential_image_generation in op auto en gebruik sequential_image_generation_options.max_images als bovengrens. Het model kan minder afbeeldingen retourneren dan het maximum.
Async task: voeg async: true toe wanneer je wilt dat het create-verzoek data.task_id retourneert in plaats van de HTTP-verbinding open te houden.

Referentieafbeeldingen plus gegenereerde afbeeldingen moeten binnen de providerlimiet blijven. Houd sequentiële verzoeken begrensd met max_images.

Voer een async afbeeldingstaak uit

Stel async in op true voor afbeeldingstaken die je client moet indienen en pollen. Het create-verzoek retourneert data.task_id; gebruik die waarde met Retrieve a Seedream image task totdat data.status success of failure is. Gebruik 2K in de async voorbeelden voor Seedream 5.0-verzoeken. Ondersteuning voor afmetingen verschilt per model ID, dus kies een door het model ondersteunde afmeting voordat je een async taak indient.

Verstuur referentieafbeeldingen

Gebruik data:image/png;base64,YOUR_BASE64_IMAGE voor inline afbeeldingsdata, of gebruik een openbare HTTPS-URL die de provider kan ophalen. De API-referentievoorbeelden tonen de volledige JSON-vorm voor elk request-type.

Lees output-URL’s

De geretourneerde url is een ondertekende object-storage-link en kan &, % en andere speciale tekens bevatten. Haal de URL uit geparste JSON in plaats van een gedeeltelijke terminalregel te kopiëren. In shell-voorbeelden behoudt jq -r '.data[]?.url' de volledige ondertekende URL.

Autorisaties

Authorization

string

header

vereist

Bearer token authentication. Use your CometAPI key.

Body

application/json

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

model

string

standaard:seedream-5-0-pro-260628

vereist

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

prompt

string

standaard:A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.

vereist

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>

standaard:url

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

Beschikbare opties:

url,

b64_json

size

string

standaard: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

standaard:false

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

async

boolean

standaard: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>

standaard:png

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

Beschikbare opties:

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.

Vereist bereik: 1 <= x <= 10

seed

integer

standaard:-1

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

Vereist bereik: -1 <= x <= 2147483647

sequential_image_generation

enum<string>

standaard: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.

Beschikbare opties:

auto,

disabled

sequential_image_generation_options

object

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

Show child attributes

Respons

200 - application/json

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

Option 1
Async task response

created

integer

vereist

Unix timestamp in seconds when the image response was created.

data

object[]

vereist

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

Show child attributes

usage

object

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

Show child attributes

Haal een Replicate prediction op

Een Seedream-afbeeldingstaak ophalen

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro-260628",
  "prompt": "A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.",
  "size": "2K",
  "response_format": "url",
  "output_format": "png",
  "watermark": false
}' | jq -r '.data[]? | .url // .b64_json'

{
  "created": 1781075000,
  "data": [
    {
      "url": "https://<provider-cdn>/<file_id>.png",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "total_tokens": 0
  }
}

Contentmoderatie

API-sleutels

Kies een request-vorm

Voer een async afbeeldingstaak uit

Verstuur referentieafbeeldingen

Lees output-URL’s

Autorisaties

Body

Respons

​Kies een request-vorm

​Voer een async afbeeldingstaak uit

​Verstuur referentieafbeeldingen

​Lees output-URL’s

Autorisaties

Body

Respons

Kies een request-vorm

Voer een async afbeeldingstaak uit

Verstuur referentieafbeeldingen

Lees output-URL’s