Saltar al contenido 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"
    }
  ]
}

Autorizaciones

​
Authorization
string
header
requerido

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

Encabezados

​
accept
enum<string>

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

Opciones disponibles:
application/json

Cuerpo

application/json
​
model
enum<string>
requerido

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

Opciones 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
requerido

The prompt which used to generate the images.

Ejemplo:

"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.

Opciones disponibles:
1K,
2K,
4K,
adaptive
Ejemplo:

"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

Opciones 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.

Respuesta

OK, the request is successful.

The response is of type object.