메인 콘텐츠로 건너뛰기
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"
    }
  ]
}

인증

​
Authorization
string
header
필수

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

헤더

​
accept
enum<string>

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

사용 가능한 옵션:
application/json

본문

application/json
​
model
enum<string>
필수

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

사용 가능한 옵션:
doubao-seedream-4-0-250828,
doubao-seedream-4-5-251128,
doubao-seedream-3-0-t2i-250415,
doubao-seededit-3-0-i2i-250628
​
prompt
string
필수

The prompt which used to generate the images.

예시:

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

사용 가능한 옵션:
1K,
2K,
4K,
adaptive
예시:

"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

사용 가능한 옵션:
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.

응답

OK, the request is successful.

The response is of type object.