Passer au contenu principal
POST
/
seedream
/
images
Seedream Images
curl --request POST \
  --url https://api.acedata.cloud/seedream/images \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-4-0-250828",
  "prompt": "a white siamese cat",
  "image": [
    "<string>"
  ],
  "size": "1:1",
  "seed": 123,
  "sequential_image_generation": "auto",
  "stream": true,
  "guidance_scale": 123,
  "response_format": "<string>",
  "watermark": true,
  "callback_url": "<string>"
}
'
{
  "success": true,
  "task_id": "93f11baf-347b-4bb4-9520-8653cb46d6a3",
  "trace_id": "a9063166-26ed-4451-85b5-54e896817c69",
  "data": [
    {
      "prompt": "a cute cat running",
      "image_url": "https://platform.cdn.acedata.cloud/seedream/ced32fad-5572-4c2b-8e91-9264dd9b8868.jpg"
    }
  ]
}

Autorisations

​
Authorization
string
header
requis

API token from https://platform.acedata.cloud

En-têtes

​
accept
enum<string>

Specifies the format of the response from the server. If not specified, the default format is application/json.

Options disponibles:
application/json

Corps

application/json
​
model
enum<string>
requis

The model which used to generate the images. If not specified, the default model is doubao-seedream-4.0.

Options disponibles:
doubao-seedream-4-0-250828,
doubao-seedream-4-5-251128,
doubao-seedream-3-0-t2i-250415,
doubao-seededit-3-0-i2i-250628
​
prompt
string
requis

The prompt which used to generate the images.

Exemple:

"a white siamese cat"

​
image
string[]

Link to the picture that needs to be edited. It can be a accessible http or https url or a base64 encoded image string like data:image/png;base64,iVBORw0KG... format. The image size should not exceed 10MB for each. If the action is edit, this parameter is required.

​
size
enum<string>

The aspect ratio of the generated images. Supported values are 1K, 2K, 4K, 1024x1024 and so on.

Options disponibles:
1K,
2K,
4K,
adaptive
Exemple:

"1:1"

​
seed
integer

The seed of the generated images. Supported values are [-1, 2147483647]. Default is -1, this only works when model is doubao-seedream-3.0-t2i or doubao-seededit-3.0-i2i.

​
sequential_image_generation
enum<string>

Default is disabled, created related images based on your input, only supports doubao-seedream-4.5 and doubao-seedream-4.0

Options disponibles:
auto,
disabled
​
stream
boolean

Default is false,stream all pictures or not, only supports doubao-seedream-4.5 and doubao-seedream-4.0

​
guidance_scale
number<float>

The prompt weight, the bigger, more related to prompt input, only supports doubao-seedream-3.0-t2i default is 2.5 and doubao-seededit-3.0-i2 default is 5.5, those two both range from [1,10]

​
response_format
string

default is url, also support b64_json

​
watermark
boolean

Default is true, if add AI generated watermark

​
callback_url
string

The callback URL which will be called when the images is generated, the URL should be accessible from the public internet. If specified, the response will be returned immediately and the result will be sent to the callback URL when it's ready.

Réponse

OK, the request is successful.

The response is of type object.