ByteDance logo

seedream-5.0-pro API

seedream-5.0-pro

Generate images with seedream-5.0-pro through the APINEED asynchronous media API.

Submit a task, save its ID, and poll the task endpoint for its status and result URLs.

MODALITIES

Playground

Generate with seedream-5.0-pro, review the output, and use the same request shape in your application.

Workflow
Estimating does not generate media or charge your balance. Reference files, if selected, upload to temporary private storage. Settings without published options use upstream defaults.
Sign in required. Final cost uses completed usage.
Output Ready
Seedream 5.0 Pro output: red ceramic teapot on a white tabletop with soft shadows
Seedream 5.0 Pro sample
Request preview
{
  "model": "seedream-5.0-pro",
  "workflow": "text_to_image",
  "input": {
    "prompt": "A refined product photograph with natural lighting, realistic materials and a clean background."
  },
  "output": {
    "count": 1
  }
}

Provider

Current API Need routing.

API Need

Pricing

Current selling prices in USD. Channel and group adjustments are already included. A range means available routes have different prices.

Generated imageOutput image pixels ≤ 2097152$0.03375 – $0.04725 per image
Generated imageOutput image pixels > 2097152$0.0675 – $0.0945 per image
reference imageOutput image pixels ≤ 2097152$0.00225 – $0.00315 per image
reference imageOutput image pixels > 2097152$0.00225 – $0.00315 per image

Availability

Recent public performance data for this model.

No model-specific availability history is published yet. A successful request is not an uptime guarantee.

Quick Start

Call seedream-5.0-pro with the endpoint and request format shown below.

1

Create an API key

Store your APINEED key server-side as API_NEED_API_KEY.

export API_NEED_API_KEY=sk-apineed-v1-...
2

Send the request

Use seedream-5.0-pro with POST /v1/media/generations.

curl https://apineed.com/v1/media/generations \
  -H "Authorization: Bearer $API_NEED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5.0-pro",
  "workflow": "text_to_image",
  "input": {
    "prompt": "A refined product photograph with natural lighting, realistic materials and a clean background."
  },
  "output": {
    "count": 1
  }
}'
3

Poll the task

Save id, then poll GET /v1/media/generations/{id} every few seconds until the task is succeeded or failed.

curl https://apineed.com/v1/media/generations/$TASK_ID -H "Authorization: Bearer $API_NEED_API_KEY"
const images = task.outputs.filter((item) => item.type === "image").map((item) => item.url);

seedream-5.0-pro API Endpoint

Create an asynchronous image task, then use its task ID to retrieve status and direct object-storage output URLs.

POST/v1/media/generations
Authorization
Bearer $API_NEED_API_KEY
Content-Type
application/json
HTTP-Referer
optional - your site URL, for rankings
Model
seedream-5.0-pro
GET/v1/media/generations/{id}
Authorization
Bearer $API_NEED_API_KEY
Content-Type
application/json
HTTP-Referer
optional - your site URL, for rankings
Model
seedream-5.0-pro

Parameters

Use the supported parameters below. Leave optional fields out to use the service defaults.

NameTypeValuesDescription
modelstringRequiredUse seedream-5.0-pro.
workflowstringtext_to_image, image_editUse an APINEED-supported workflow.
input.promptstringRequiredDescribe the requested image.
input.assetsarrayRequired for image_editImage URLs with role input_image; up to 1 references.

seedream-5.0-pro API questions

Practical answers for choosing, integrating, pricing, and operating the seedream-5.0-pro API on APINEED.

Which model ID should I use for seedream-5.0-pro?

Use seedream-5.0-pro, exactly as returned by the API Need pricing API.

Which endpoint should I use?

Send a POST request to /v1/media/generations using your APINEED API key. Save the returned task ID, then poll GET /v1/media/generations/{id} until the task succeeds or fails. Follow the request example and parameter table on this page.

How is the API Need price calculated?

See Pricing for the current rates and discounts. Final charges use recorded usage.

How to deploy seedream-5.0-pro

Connect seedream-5.0-pro to your application through the APINEED media API.

1

Add credits

Add APINEED credits before submitting a billable generation.

2

Create an API key

Create and securely store an APINEED API key.

3

Configure the endpoint

Send seedream-5.0-pro requests to /v1/media/generations.

4

Track the task

Poll the returned task ID and store the completed image URL from outputs[].

More live models