How to Get a Seedream API Key 2026 & Seedream 5.5 Pricing
- 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
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.
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.
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.
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.
-
Click API Keys in the left menu and create a key. Copy it and keep it somewhere safe.
-
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.
-
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.
-
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"
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.
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.
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:
export ARK_API_KEY="your_api_key"
If you are using Windows PowerShell, use this command instead:
$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 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.
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.
- 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:
- 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.
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.
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:
4.1 Current Discounts
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:
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.
- 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.
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.
-
In OCR Settings, choose Editable Text, pick the language and click Perform OCR.
-
Edit or copy the recognized text. You can also fix it with Edit PDF, translate it, or convert the file to Word.
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.
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.
- Make scanned PDFs searchable and editable with 99% OCR precision
- Batch convert PDFs to Word, Excel, PPT, images, PDF/A, Text, EPUB, etc., up to 30% faster
- Edit PDFs easily like Word, including text, images, watermarks, links, and backgrounds
- Annotate PDF with highlights, comments, shapes, stickers, and stamps
- Run smoothly on any PC without lags or crashes, even on low-spec machines
Secure Download
Secure Download
Speak Your Mind
then write your review
Speak Your Mind
Leave a Comment
Create your review for PDNob articles