Home > PDF Tips

How to Get a Seedream API Key 2026 & Seedream 5.5 Pricing

Home > PDF Tips > How to Get a Seedream API Key 2026 & Seedream 5.5 Pricing

How to Get a Seedream API Key 2026 & Seedream 5.5 Pricing

Key Takeaways:
  • If you need a Seedream key exists, possibly you are looking for a BytePlus ModelArk API key (or Volcengine Ark in mainland China). With that key, you can then activate the Seedream model, and send the key as a Bearer token.
  • Seedream 5.5 is the newest version (released Nov 9, 2026), offering multi-round editing, transparent PNGs, and improved small-text rendering; Pro has been announced but not released.
  • You can try Seedream for free through BytePlus's 200-image free quota for new users, Dreamina's daily credits, or apps like CapCut and Doubao, though there's no free API tier.
  • Seedream key API Pricing is per output image (e.g., $0.04 for Seedream 4.5, $0.020–$0.035 for 5.5), with first-purchase discount plans and free input images on most models.
  • Common Seedream key API connection errors are fixable. 401 means a wrong or cross-platform key, "model not activated" requires activation in the console, and custom sizes must use "x" and stay within the model's pixel range.

There's no separate "Seedream API key." To use the Seedream API, you create a BytePlus ModelArk API key (or a Volcengine Ark key if you're in mainland China), activate the Seedream model you want, and send the key as a Bearer token with each request. The newest model is Seedream 5.5, released on November 9, 2026.

You don't have to pay to try it. New BytePlus users get a free image quota, and Dreamina gives daily free credits if you don't need code. This guide covers the ByteDance Seedream versions, how to get a Seedream API key step by step, your first API call, pricing and discounts, every free route, and fixes for common errors.

Part 1. What Is ByteDance Seedream? Versions and Release Dates

bytedance seedream 5.5 official api page byteplus

Seedream is ByteDance Seed's family of image generation and editing models. It powers the image tools in Dreamina, CapCut and Doubao, and developers can use it through BytePlus ModelArk. People often search for "seadream api" or "seadream 4.0 api," but the model is spelled Seedream.

swiper icon Please swipe to view
Version
Released
API model ID (BytePlus)
Best for
Seedream 5.5
Nov 9, 2026
dola-seedream-5-5-261028
Multi-round editing, transparent PNGs, small text
Seedream 5.0 Pro
Jul 2026
dola-seedream-5-0-pro-260628
Highest quality, layer decomposition
Seedream 5.0 Flash
Sep 2026
dola-seedream-5-0-flash-260915
Fast, lowest price, high volume
Seedream 5.0 Lite
Jan 2026
seedream-5-0-lite-260128
Up to 4K output, image sets, streaming
Seedream 4.5
Late 2025
seedream-4-5-251128
2K/4K output, up to 14 reference images
Seedream 4.0
Sep 2025
seedream-4-0-250828
4K output, older workflows

BytePlus describes Seedream 5.5 as having "More Precise Multi-Round Editing, Generate Transparent RGBA Assets, More Natural, Realistic Textures, Improved Small-Text Rendering." A Pro version of 5.5 has been announced but isn't out yet.

seedream versions and release dates seedream 5.5 seedream 4.5

1.1 Is Seedream Open Source?

No. ByteDance published a technical paper for Seedream 4.0, but it hasn't released the model weights for Seedream 4.0 or any other version. You can only use Seedream through ByteDance's apps, the official API, or third-party APIs that resell it.

note icon
Note:

Downloads on GitHub or Hugging Face that claim to be the "real" Seedream weights aren't official. Avoid them.

Part 2. How to Get a Seedream API Key on BytePlus (Step-by-Step)

One ModelArk API key works for all of ByteDance's Seed models (Seedream, Seedance and the Seed text models), once you activate each model. BytePlus is the international platform. Volcengine Ark is the platform for mainland China, and keys don't work across the two.

  • Create a BytePlus account and sign in to the ModelArk console.

  • how to get a seedream api key byteplus modelark quick start
  • Click API Keys in the left menu and create a key. Copy it and keep it somewhere safe.

  • how to get a seedream api key byteplus modelark quick start
  • Open the Model activation page and activate each Seedream model you'll call (for example, Seedream 5.5 and 5.0 Flash). Then Click Activate.

  • how to get a seedream api key byteplus modelark quick start
  • Click Confirm Activaton and Authorization. If you have not fill your payment info there will be a pop up remind you to supplement it. A model that isn't activated won't answer, even with a valid key.

  • how to get a seedream api key byteplus modelark quick start
  • Save the key as an environment variable named ARK_API_KEY instead of pasting it into your code. On macOS or Linux: export ARK_API_KEY="your_api_key_here"

how to get a seedream api key byteplus modelark quick start

2.1 Getting a Key in Mainland China (Volcengine Ark)

The flow is the same in the Volcengine Ark console: go to API Key management > Create API Key. One main account can create up to 50 keys, and you can limit a key to certain models, endpoints or IP addresses.

Part 3. How to Use the Seedream API: Your First Request

All Seedream versions use the same API endpoint for image generation. You can call this endpoint using cURL, Python, or other HTTP clients. Follow the steps below to send your first text-to-image request using Seedream 5.5.

API Endpoint
POST https://ark.ap-southeast.bytepluses.com/api/v3/images/generations

Step 1. Get Your API Key

Before making an API request, you need an API key to authenticate your access to Seedream. Sign in to the BytePlus ModelArk platform, activate the required model service, and obtain your API key from the API key management section.

Important: Keep your API key private. Do not publish it in frontend JavaScript, public repositories, or webpages. Use an environment variable or a secure backend configuration instead.

Step 2. Set Your API Key

Open your terminal and configure your API key as an environment variable. For macOS, Linux, or Git Bash on Windows, run:

Bash
export ARK_API_KEY="your_api_key"

If you are using Windows PowerShell, use this command instead:

PowerShell
$env:ARK_API_KEY="your_api_key"

Replace your_api_key with the API key you obtained from your account.

Step 3. Prepare Your First Image Generation Request

Use the cURL command below to send a POST request to the Seedream image generation endpoint. This example uses Seedream 5.5 to create a coffee shop menu poster.

cURL · Text-to-Image
curl https://ark.ap-southeast.bytepluses.com/api/v3/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "dola-seedream-5-5-261028",
    "prompt": "A coffee shop menu poster with the title \"Daily Brew\" and three prices",
    "size": "2K",
    "response_format": "url",
    "watermark": false
  }'

The request consists of three main parts:

  • Endpoint: Specifies the Seedream image generation API.
  • Headers: Defines the request format and authenticates your API key.
  • Request body: Contains the model ID, image prompt, resolution, and other generation settings.

Step 4. Customize Your Generation Parameters

You can modify the JSON request body to control how Seedream generates your image. Here is what each parameter does:

Parameter Purpose Example
model Selects the Seedream model version. dola-seedream-5-5-261028
prompt Describes the image you want to generate. A coffee shop menu poster
size Sets the output image resolution. 2K
response_format Specifies how the generated image is returned. url
watermark Controls whether a watermark is added. false

For example, change the prompt value to describe a different subject, or update the size parameter to another resolution supported by the API.

Step 5. Send the Request and Check the Result

Run the complete cURL command in your terminal. If the request succeeds, the API returns a JSON response containing information about the generated image. With "response_format": "url", the response includes an image URL that you can open in your browser or use in your application.

note icon
Note:

The response structure and image URL availability depend on the API's response and output settings. Refer to the official API documentation for the complete response schema and error codes.

Step 6. Edit Images or Switch Seedream Versions

Seedream also supports image-to-image editing and multi-reference generation. To edit an existing image, add the appropriate image input field to your JSON request. Depending on the API specification, you can provide an image URL or a Base64-encoded image, and use multiple image references where supported.

To switch to another Seedream version, such as Seedream 4.5, update the model field with the corresponding model ID. The endpoint remains the same, although available parameters and capabilities may vary between versions.

how to use seedream api first request explained
swiper icon Please swipe to view
Parameter
What it does
model
The model ID, e.g. dola-seedream-5-5-261028 or seedream-4-5-251128
prompt
What you want to create or change
image
Input image(s) for editing or reference: up to 10 for 5.5 and 5.0 Pro/Flash, up to 14 for 5.0 Lite, 4.5 and 4.0
size
A preset like "2K" or a custom size like "2848x1600"
response_format
"url" (default) or "b64_json"
watermark
Defaults to true (adds an "AI-generated" label); set to false
sequential_image _generation
"auto" makes a set of related images (5.0 Lite, 4.5 and 4.0 only)
background
For 5.5: "transparent" gives a PNG with a transparent background
note icon
Practical notes:
  • Download results right away. Result URLs expire 24 hours after generation.
  • Turn off the watermark. It's on by default, so set watermark to false for clean images.
  • Know which features each model supports. Seedream 5.5, 5.0 Pro and 5.0 Flash don't support sequential_image_generation. Use 5.0 Lite, 4.5 or 4.0 for image sets.
  • Match the format to transparency. For transparent images on 5.5, keep the output format as PNG. Asking for JPEG with a transparent background makes the request fail.

3.1 Common Seedream API Errors and Fixes

  • 401 or "authentication failed": the key is wrong or disabled, or you sent a BytePlus key to Volcengine (or the other way round).
  • Model not activated: activate the model on the Model activation page.
  • 400 on a custom size:
  • Write the size with the letter "x" (2848x1600), not "×".

    Stay inside the model's pixel range. For example, 4.5 needs at least 3,686,400 pixels, so 1024x1024 is too small.

  • 429 (too many requests): you've hit the images-per-minute limit. Wait and retry with a backoff.
  • Blocked by content moderation: rewrite the prompt. Images that fail moderation aren't charged.

Part 4. Seedream API Pricing and Discounts (November 2026)

  • BytePlus Seedream 5.5 plans for new customers: these are first-purchase plans, and new customers can buy only one. Each lasts 30 days, and unused images don't carry over.
  • Dreamina's Seedream 5.5 launch offer: since November 11, 2026, eligible paid Dreamina plans include 30 days of credit-free Seedream 5.5 image generation on Dreamina Web. Usage limits apply, and the covered resolution depends on your plan.
  • Free Third-party APIs: fal.ai, Replicate, WaveSpeed and other resellers offer Seedream with their own keys and prices. Compare the per-image price, and check which model ID they actually route to.

You pay per image returned. Images that aren't generated, for example because content moderation blocked them, aren't billed. Here are the official BytePlus pay-as-you-go prices:

seedream 5.5 api pricing byteplus official rate card
swiper icon Please swipe to view
Model
Input image
Price per output image
Seedream 5.5
$0.008 each
$0.020 (up to about 1.5K), $0.035 (up to about 2K)
Seedream 5.0 Pro
First free, then $0.003 each
$0.045 (1.5K or lower), $0.09 (above 1.5K)
Seedream 5.0 Flash
Free
$0.018
Seedream 5.0 Lite
Free
$0.035
Seedream 4.5
Free
$0.04
Seedream 4.0
Free
$0.03

4.1 Current Discounts

seedream 5.5 api discount plans byteplus first purchase
swiper icon Please swipe to view
Plan
Price
Images
Discount
Starter
$6.99 (regular $13.99)
Up to 700
50% off
Professional
$24.99 (regular $35.99)
Up to 1,800
31% off
Team
$49.99 (regular $69.99)
Up to 3,500
29% off

Part 5. How Can I Use Seedream for Free?

There's no free API tier, but there are several ways to get free access to Seedream. Here's where to use Seedream without paying:

seedream 4.5 free quota byteplus free trial 200 images
swiper icon Please swipe to view
Where to use Seedream
What's free
Needs code?
Best for
BytePlus free trial
200 free images each for Seedream 4.5, 4.0 and 3.0, for new eligible users
Yes
Testing the official API
BytePlus ModelArk playground
Uses the same free quota
No
Trying prompts before coding
Dreamina
Daily free credits (120 a day as of August 2026; check your account)
No
Trying Seedream in a browser
CapCut
AI image tools inside the editor
No
Social and video creators
Doubao / Jimeng (China)
Free generations in the app
No
Users in mainland China
Third-party APIs
Small sign-up credits (varies)
Yes
Comparing models in one place

The BytePlus free quota "does not expire, but is subject to change," so it's a good way to try the Seedream 4.5 API for free before you pay for anything.

try seedream 5.5 on dreamina launch offer
tips icon
Tips for making free credits last:
  • Test small first. Try your prompt at a lower resolution, then generate the final image at 2K or 4K.
  • Write clear prompts. Describe the layout, colors and any exact text in quotes, so you need fewer retries.
  • Reuse what works. Keep your best prompts and change one detail at a time.

Part 6. Turn Seedream's Text-Heavy Images into Editable Text with PDNob

Seedream 5.5 and 4.5 are good at posters, menus, infographics and slides with readable text. But the text is part of the picture, so you can't select it, fix a typo or reuse the words. When you need the text back, for proofreading, translation or a report, use OCR.

Tenorshare PDNob is a light-weight AI desktop PDF editor with high accuracy OCR that turns images and scanned pages into editable, searchable PDFs. For example, you can export posters, menus, or slides generated by Seedream as images, then use PDNob's OCR to recognize the text, allowing you to quickly proofread, copy, fix typos, or translate PDF with bilingual view . Afterward, you can reorganize the text, images, and layout into a searchable, print-ready PDF, making it easy to deliver to clients, archive, or send directly to print.

pdnob ocr turn ai image text into editable text

6.1 How to Edit Text from a Seedream Image

  • Open PDNob and click OCR PDF, then select your Seedream image. PDNob creates a PDF from it.

  • open seedream image with pdnob ocr pdf
  • In OCR Settings, choose Editable Text, pick the language and click Perform OCR.

  • pdnob ocr settings perform ocr on ai generated image
  • Edit or copy the recognized text. You can also fix it with Edit PDF, translate it, or convert the file to Word.

  • copy editable text from ai infographic with pdnob

What you can do with it:

  • Proofread an AI poster before you print it.
  • Pull the copy out of an AI infographic and drop it into a report.
  • Combine a batch of generated pages into one PDF.
note icon
Note:

OCR accuracy depends on how clean the rendered text is. Large, high-contrast text gives the best results.

FAQs About the Seedream API Key

Q1. Is there a free Seedream API key?

A1: There's no free API tier, but new eligible BytePlus users get a free quota of 200 images on Seedream 4.5 (and on 4.0 and 3.0).

Q2. Where do I get a Seedream API key?

A2: In the BytePlus ModelArk console under API Keys, or in Volcengine Ark if you're in mainland China. Then activate the Seedream model you want.

Q3. Is Seedream open source?

A3: No. Seedream 4.0 has a public technical paper, but no model weights have been released for any version.

Q4. What's the newest Seedream version?

A4: Seedream 5.5, released on November 9, 2026. A 5.5 Pro version has been announced.

Q5. How much does the Seedream 4.5 API cost?

A5: $0.04 per output image on BytePlus, with free input images, as of November 2026.

Q6. Can I use Seedream without an API key?

A6: Yes. You can try Seedream in Dreamina, CapCut or Doubao with free daily credits or a paid plan.

Conclusion: Which Way to Use Seedream Is Right for You?

To obtain a Seedream API key, you first need to create a BytePlus ModelArk API key, activate your desired Seedream model, and then call the images endpoint using your key as a Bearer token. If you are building an application, a BytePlus key is the recommended route, with Seedream 5.0 Flash offering the most cost-effective option for high-volume tasks, while Seedream 5.5 or 5.0 Pro deliver the highest image quality. For those who simply want to test the platform, you can utilize the free quota provided by BytePlus or the daily credits available on Dreamina. Additionally, if you need to extract text from your generated images, PDNob's OCR tool is a suitable solution.

Speak Your Mind

Registrer/ Login

then write your review

Speak Your Mind

Leave a Comment

Create your review for PDNob articles

Related articles

avatar
Rachel Jones

AI Tools Writer / Workflow Analyst

Rachel has spent the last 5 years testing and writing about AI-powered tools across writing, design, and research workflows. She focuses on practical AI tool usage, helping knowledge workers turn generative AI into everyday productivity.

Share article:

All topics