> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Opprett en Seedream-bildeoppgave
> Send inn en asynkron Seedream-bildeoppgave via CometAPI, og lagre den returnerte oppgave-ID-en for statusspørring.
Bruk `POST /v1/images/generations` med `async: true` for å sende inn en Seedream-bildeoppgave uten å holde HTTP-tilkoblingen åpen.
Denne asynkrone arbeidsflyten gjelder for disse modell-ID-ene:
| Modell | Modell-ID |
| ----------------- | ---------------------------- |
| Seedream 4.0 | `doubao-seedream-4-0-250828` |
| Seedream 4.5 | `doubao-seedream-4-5-251128` |
| Seedream 5.0 Lite | `doubao-seedream-5-0-260128` |
| Seedream 5.0 Pro | `seedream-5-0-pro-260628` |
For tilgjengelighet for kontoen, se [Models-siden](/no/overview/models) eller spør etter `/v1/models`. Se BytePlus for detaljer om leverandørparametere [API for bildegenerering](https://docs.byteplus.com/en/docs/ModelArk/1541523) og [veiledningen for Seedream 4.0-5.0](https://docs.byteplus.com/en/docs/ModelArk/1824121).
## Send inn oppgaven
Send `model`, `prompt` og `async: true`. Eksempelet ber også om et `2K` URL-svar med `watermark: false`. Størrelsesstøtten varierer etter modell-ID, så bruk en størrelse som støttes av den valgte modellen.
Opprettelsessvaret returnerer `data.task_id`, `data.status` og en tom `data.data`-matrise mens oppgaven venter. Lagre `data.task_id`; ikke bruk svarkoden på øverste nivå som oppgaveidentifikator.
## Spør etter oppgaven
Send den lagrede oppgave-ID-en til [Hent en Seedream-bildeoppgave](/no/api/image/seededit-seedream/bytedance-image-generation-task). Fortsett å spørre så lenge `data.status` er `pending`. Stopp når den blir `success` eller `failure`.
## Les bilde-URL-en
Når en oppgave lykkes, les `data.data[0].url` fra parsede JSON-data. I shell bevarer `jq -r '.data.data[0].url'` spesialtegn i hele URL-en.
Last ned eller overfør bildet raskt. URL-en er midlertidig; denne dokumentasjonen forutsetter ikke en fast levetid.
## OpenAPI
````yaml api/openapi/image/seededit-seedream/post-bytedance-image-generation.openapi.json POST /v1/images/generations
openapi: 3.1.0
info:
title: Seedream asynchronous image task API
version: 1.0.0
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/v1/images/generations:
post:
summary: Create a Seedream image task
description: >-
Submit a Seedream asynchronous image task. Store `data.task_id`, then
poll `GET /v1/images/generations/{task_id}`.
operationId: bytedance_image_generation
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- model
- prompt
- async
properties:
model:
type: string
description: >-
Seedream model ID. This async workflow is documented for
`doubao-seedream-4-0-250828`, `doubao-seedream-4-5-251128`,
`doubao-seedream-5-0-260128`, and `seedream-5-0-pro-260628`.
Query `/v1/models` or open the [Models
page](/overview/models) for account availability.
example: doubao-seedream-5-0-260128
prompt:
type: string
description: Text prompt describing the image to generate.
example: >-
A clean studio photograph of a small red ceramic teapot on a
pale blue table, soft window light, no text.
size:
type: string
description: >-
Requested output size. Use a value supported by the selected
model.
example: 2K
response_format:
type: string
description: >-
Response workflow for this async request. The example uses
`url` and retrieves the URL from the completed task.
example: url
watermark:
type: boolean
description: >-
Whether to request a visible watermark on the generated
image.
example: false
async:
type: boolean
description: >-
Asynchronous task mode. Set this to `true`, store
`data.task_id`, and poll the task endpoint.
const: true
examples:
Async text to image (Seedream 5.0 Lite):
summary: Submit an asynchronous Seedream 5.0 Lite task
value:
model: doubao-seedream-5-0-260128
prompt: >-
A clean studio photograph of a small red ceramic teapot on a
pale blue table, soft window light, no text.
size: 2K
response_format: url
watermark: false
async: true
responses:
'200':
description: Seedream asynchronous task submission response.
content:
application/json:
schema:
type: object
required:
- code
- message
- data
properties:
code:
type: string
description: >-
Request status code. A successful submission returns
`success`.
example: success
message:
type: string
description: >-
Status message. A successful submission can return an
empty string.
data:
type: object
required:
- task_id
- status
- data
properties:
task_id:
type: string
description: >-
Task ID to pass to `GET
/v1/images/generations/{task_id}`.
status:
type: string
description: Task state at submission time.
enum:
- pending
- success
- failure
data:
type: array
description: >-
Empty at submission time. Poll the task endpoint for
final image data.
items:
type: object
example:
code: success
message: ''
data:
task_id:
status: pending
data: []
x-codeSamples:
- lang: Shell
label: Async text to image (Seedream 5.0 Lite)
source: |
curl 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 clean studio photograph of a small red ceramic teapot on a pale blue table, soft window light, no text.",
"size": "2K",
"response_format": "url",
"watermark": false,
"async": true
}'
- lang: Python
label: Async text to image (Seedream 5.0 Lite)
source: |
import os
import requests
response = requests.post(
"https://api.cometapi.com/v1/images/generations",
headers={
"Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
"Content-Type": "application/json",
},
json={
"model": "doubao-seedream-5-0-260128",
"prompt": "A clean studio photograph of a small red ceramic teapot on a pale blue table, soft window light, no text.",
"size": "2K",
"response_format": "url",
"watermark": False,
"async": True,
},
timeout=60,
)
response.raise_for_status()
print(response.json()["data"]["task_id"])
- lang: JavaScript
label: Async text to image (Seedream 5.0 Lite)
source: >
const response = await
fetch("https://api.cometapi.com/v1/images/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
"Content-Type": "application/json",
},
signal: AbortSignal.timeout(60_000),
body: JSON.stringify({
model: "doubao-seedream-5-0-260128",
prompt: "A clean studio photograph of a small red ceramic teapot on a pale blue table, soft window light, no text.",
size: "2K",
response_format: "url",
watermark: false,
async: true,
}),
});
if (!response.ok) throw new Error(await response.text());
const task = await response.json();
console.log(task.data.task_id);
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI key.
````