# Seedream 5.0 Pro · API 接入

API 模型 ID 为 `seedream-5-0-pro`。本文说明平台的实际契约，调用前请核对实时目录中的可用性。

## 请求示例

平台地址在构建时填入，运行前设置 API_KEY 为服务端密钥。

```bash
curl "https://newrouters.com/v1/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  --data '{
  "model": "seedream-5-0-pro",
  "input": {
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "layer_decomposition": false,
    "prompt": "A small red house in a quiet garden",
    "images": []
  }
}'
```

## 查询结果

创建响应表示任务已受理，不是最终结果。用返回的 ID 替换 TASK_ID，轮询至 succeeded 或 failed。

```bash
curl "https://newrouters.com/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $API_KEY"
```

成功查看 result，失败查看 error。上游结果未知时保留原任务 ID，不盲目重复提交付费生成。

## 参数说明

| 字段 | 类型 | 要求 | 默认值 | 限制 |
| --- | --- | --- | --- | --- |
| `images` | array | 可选 | `[]` | 最多项数 10 |
| `prompt` | string | 可选 | — | 最大长度 100000 |
| `background` | enum | 可选 | — | `opaque`, `transparent` |
| `resolution` | enum | 可选 | `"1k"` | `1k`, `1.5k`, `2k`, `auto` |
| `aspect_ratio` | enum | 可选 | `"auto"` | `auto`, `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3`, `21:9` |
| `output_format` | enum | 可选 | `"jpeg"` | `png`, `jpeg`, `webp` |
| `layer_decomposition` | boolean | 可选 | `false` | — |








<!-- official-reference:start -->
## 官方来源与模型身份

核对日期: 2026-09-27 · 平台模型: `seedream-5-0-pro` · 官方对应: `doubao-seedream-5-0-pro-260628`

- [doubao-seedream-5-0-pro-260628 official reference](https://docs.volcengine.com/docs/ark/image-generation-api?lang=zh)
- [Volcengine model IDs](https://docs.volcengine.com/docs/ark/model-list?lang=zh)
<!-- official-reference:end -->

## 计费与排错

接入时核对当前可用性、契约和账号价格。排错时保留请求 ID 与消费凭据。 [完整 API 参考](/zh/docs/api)

## 多语言请求示例

### JavaScript

```javascript
const apiBaseUrl = "https://newrouters.com";
const apiKey = process.env.API_KEY;
if (!apiKey) throw new Error("Set API_KEY in your server environment");

const response = await fetch(apiBaseUrl + "/v1/tasks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + apiKey
  },
  body: JSON.stringify({
  "model": "seedream-5-0-pro",
  "input": {
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "layer_decomposition": false,
    "prompt": "A small red house in a quiet garden",
    "images": []
  }
})
});

const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result));
console.log(result);
```

### Python

```python
import json
import os
from urllib.request import Request, urlopen

api_base_url = "https://newrouters.com"
api_key = os.environ["API_KEY"]
body = json.loads("{\"model\":\"seedream-5-0-pro\",\"input\":{\"resolution\":\"1k\",\"aspect_ratio\":\"auto\",\"output_format\":\"jpeg\",\"layer_decomposition\":false,\"prompt\":\"A small red house in a quiet garden\",\"images\":[]}}")

request = Request(
    api_base_url + "/v1/tasks",
    data=json.dumps(body).encode("utf-8"),
    headers={
    "Content-Type": "application/json",
    "Authorization": "Bearer " + api_key
    },
    method="POST",
)
with urlopen(request) as response:
    print(json.load(response))
```

## 响应字段节选（示意值）

### HTTP 202

```json
{
  "id": "TASK_ID",
  "status": "pending",
  "model": "seedream-5-0-pro",
  "result": null,
  "error": null
}
```

### HTTP 200

```json
{
  "id": "TASK_ID",
  "status": "succeeded",
  "model": "seedream-5-0-pro",
  "result": {
    "assets": [
      "https://example.com/output.png"
    ]
  },
  "error": null
}
```