跳至主要内容
试玩区文档获取 API 密钥

Mage API · 图像模型

Seedream API

Seedream,带严格过滤

获取 API 密钥在试玩区体验 Seedream
POST https://api.mage.space/v1/seedream/generate

一览

Seedream API 通过 Mage 运行 Seedream 5.5 及其他 5 个版本,接口为 POST https://api.mage.space/v1/seedream/generate。使用默认设置发起一次请求需 42 Gems(约 $0.042),无需订阅。Seedream 支持在提示词中通过 @handle 调用已保存的角色和参考图。

  • 图像输出
  • 6变体
  • 42默认每张图片所需 Gems
  • $0.042约合美元

概览

Seedream API 能做什么

字节跳动的 Seedream，从适合草稿的 Seedream 5.0 Flash 到最新的默认版本 Seedream 5.5，可呈现细节丰富的场景和清晰可读的文字，并支持基于最多 10 张参考图或 Characters 进行编辑，Seedream 4.5 最高可达 4K。严格过滤：每次运行前都会检查提示词和首张图像。

字节跳动的 Seedream 图像模型系列,适合生成细节丰富的场景、清晰可读的文字,并支持基于最多 10 张参考图或 Characters 进行编辑:Seedream 5.5(`seedream-5.5`),最新版本,也是默认模型,图像更逼真,小字更清晰,多次重复编辑更稳定;Seedream 5.0 Pro(`seedream-5.0-pro`),上一代旗舰;Seedream 5.0 Flash(`seedream-5.0-flash`),统一定价且已包含输入图片,在 2K 分辨率或使用输入图片时价格最低(仅使用 1K 提示词时,Seedream 5.5 更便宜);Seedream 5.0 Lite(`seedream-5.0-lite`),最高支持 3K;Seedream 4.5(`seedream-4.5`),最高支持 4K;以及 Seedream 4.0(`seedream-4.0`)。严格过滤:Mage 会在运行前检查提示词和第一张图片;被拒绝的请求会返回 `content_blocked` 及原因,并会退款。

支持的输入:image、additional_images。

快速开始

调用 Seedream API

设置 MAGE_API_KEY,向 /seedream/generate 提交请求,然后轮询 status_url,直到请求完成。

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedream/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "seedream-5.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('seedream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'seedream-5.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seedream", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "seedream-5.5",
})

print(request["result"]["url"])

模型

Seedream 的 model_id 值

传入 model_id 即可选择变体。未指定时将使用默认变体。

model_id名称默认
seedream-4.0Seedream 4.0
seedream-4.5Seedream 4.5
seedream-5.0-liteSeedream 5.0 Lite
seedream-5.0-proSeedream 5.0 Pro
seedream-5.0-flashSeedream 5.0 Flash
seedream-5.5Seedream 5.5是

选项

Seedream 参数

以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。

字段取值
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

输入

Seedream 支持的媒体输入

可通过 https 链接、data URL 或不超过 100 MB 的上传文件发送。

字段用途
image参考图片。
additional_images额外的参考图片。

更多图像模型

Mage 上的其他图像生成 API

常见问题

常见问题解答

Seedream API 的费用是多少?
使用默认设置(Seedream 5.5)发起一次 Seedream 请求需 42 Gems,约 $0.042。其他分辨率、时长和版本会影响价格,具体扣费以返回结果中的金额为准。生成失败会退还 Gems;若因违反 Mage 内容政策而被拦截,则不予退还。
Seedream API 的接口地址是什么?
向 POST https://api.mage.space/v1/seedream/generate 发送请求,并在 Authorization: Bearer 请求头中携带你的 Mage API 密钥。响应中包含 status_url,用于轮询获取结果。
可以调用哪些 Seedream 模型?
seedream-4.0（Seedream 4.0）、seedream-4.5（Seedream 4.5）、seedream-5.0-lite（Seedream 5.0 Lite）、seedream-5.0-pro（Seedream 5.0 Pro）、seedream-5.0-flash（Seedream 5.0 Flash）、seedream-5.5（Seedream 5.5）。默认是 Seedream 5.5。
Seedream 支持参考图或角色吗?
Seedream 接受 image、additional_images。Seedream 支持在提示词中通过 @handle 调用已保存的角色和参考图。
可以在 Claude 或 ChatGPT 中使用 Seedream 吗?
可以。将 Mage MCP 服务器连接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然后直接说出 Seedream 的名字即可。你的助手会通过 get_model 读取它的选项,并在生成前告知价格。
Seedream 的生成结果会保存多久?
结果和输入内容会保存 30 天。想长期保留的内容,请下载到你自己的存储空间。

用 Mage 开始开发

一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。

获取 API 密钥在试玩区体验 Seedream