Seedream Images

POST /seedream/images

Seedream Images

cURL

curl --request POST \
  --url https://api.acedata.cloud/seedream/images \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-5-0-260128",
  "prompt": "a white siamese cat"
}
'

import requests

url = "https://api.acedata.cloud/seedream/images"

payload = {
    "model": "doubao-seedream-5-0-260128",
    "prompt": "a white siamese cat"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({model: 'doubao-seedream-5-0-260128', prompt: 'a white siamese cat'})
};

fetch('https://api.acedata.cloud/seedream/images', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "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://cdn.acedata.cloud/8c5b69a6e0.png"
    }
  ]
}

{
  "error": {
    "code": "token_mismatched",
    "message": "The specified token is not matched with API."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "invalid_token",
    "message": "The specified token is invalid or wrong."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "used_up",
    "message": "Your balance is not sufficient for current request, please buy more in Ace Data Cloud."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "no_api",
    "message": "API does not exist, please make sure url is correct."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "request_too_large",
    "message": "Request body is too large."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "too_many_requests",
    "message": "You have exceeded the rate limit."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "api_error",
    "message": "Internal server error."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

承認

Authorization · string · header · 必須

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

ヘッダー

accept · enum<string>

Seedream Images Param Accept

利用可能なオプション: application/json

ボディ

application/json

model · enum<string> · 必須

Seedream Images Model

利用可能なオプション: doubao-seedream-5-0-pro-260628, doubao-seedream-5-0-260128, doubao-seedream-4-0-250828, doubao-seedream-4-5-251128, doubao-seedream-3-0-t2i-250415, doubao-seededit-3-0-i2i-250628

prompt · string · 必須

Seedream Images Prompt

例:

"a white siamese cat"

image · string[]

Seedream Images Image

size · enum<string>

Seedream Images Size

利用可能なオプション: 1K, 2K, 3K, 4K, adaptive

例:

"2K"

seed · integer

Seedream Images Seed

sequential_image_generation · enum<string>

Seedream Images Sequential Image Generation

利用可能なオプション: auto, disabled

sequential_image_generation_options · object

Seedream Images Sequential Image Generation Options

Show child attributes

stream · boolean

Seedream Images Stream

guidance_scale · number<float>

Seedream Images Guidance Scale

response_format · string

Seedream Images Response Format

watermark · boolean

Seedream Images Watermark

output_format · enum<string>

Seedream Images Output Format

利用可能なオプション: jpeg, png

tools · object[]

Seedream Images Tools

Show child attributes

optimize_prompt_options · object

Seedream Images Optimize Prompt Options

Show child attributes

callback_url · string

Seedream Images Callback Url

async · boolean

Seedream Images Async

レスポンス

200

application/json

Seedream Images Response 200

success · boolean

Seedream Images Response 200 Success

task_id · string

Seedream Images Response 200 Task Id

trace_id · string

Seedream Images Response 200 Trace Id

data · object[]

Seedream Images Response 200 Data

Show child attributes