الانتقال إلى المحتوى الرئيسي
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.