<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# 豆包图片生成

> 基于字节跳动豆包 Seedream 3.0 大模型的高质量文生图服务，支持中英文混合提示词，平均 3~4 秒出图。

【核心能力】
- 影视级画质：擅长摄影、插画、电影感构图与中文场景理解
- 多种尺寸：方形 1024×1024、宽屏 1792×1024、竖屏 1024×1792 等 6 种主流分辨率
- 中文友好：原生理解中文语意，无需翻译为英文也能精准生成

【适用场景】
- 内容创作：插图、海报、Banner、社交媒体图片
- 营销素材：广告图、商品概念图、宣传背景
- 设计辅助：灵感参考、构图草稿、风格化展示
- 应用集成：聊天机器人配图、自媒体配图、AI 应用接入

【提示词建议】
- 推荐结构：主体 + 风格 + 构图 + 光线 + 氛围
- 示例：「一只赛博朋克猫在雨夜的霓虹街头，低角度，电影感，Wong Kar-Wai 风格」
- 越具体描述效果越好，可以指定材质、镜头、色调、画家风格等
- 建议 prompt 长度控制在 50~300 字符之间

【⚠️ 重要提示】
返回的图片 URL 是字节云 TOS 临时直链，**24 小时后失效**。请务必在有效期内：
- 下载保存到本地
- 或转存到自己的对象存储（阿里 OSS / 腾讯 COS 等）
- 不要长期引用此直链

【计费说明】
- 方形 1024×1024：约 4096 tokens
- 宽屏 1792×1024 / 1080p：约 7168 tokens
- 实际点数扣费请参考下方定价

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `doubao-image` |
| 接口名称 | 豆包图片生成 |
| 接口地址 | `https://v1.apizero.cn/api/doubao-image` |
| 请求方法 | `POST` |
| 分类 | ai |
| 提供方 | 极数本源 |
| 计费模式 | 按次付费 · 月套餐 |
| 单次消耗 | 0 积分 |
| 起步价 | ¥0.00 / 1000 次 |
| QPS 限制 | 2 req/s |
| 每日免费额度 | 20 次（已认证用户） |
| 匿名每日额度 | 1 次（无 API Key） |
| VIP 免费 | 否 |
| 调用总次数 | undefined |

## 2. 认证

需要 API Key（Bearer Token）。登录用户每日 20 次免费额度，超出按点数扣费；未登录无法调用。

获取 API Key：登录 `https://apizero.cn/account/keys` 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `prompt` | `string` | 是 | 图片描述文本，支持中英文混合。建议 50~300 字符，越具体效果越好。 | `一只赛博朋克猫在雨夜的霓虹街头，低角度，电影感，Wong Kar-Wai 风格` |
| `size` | `string` | 否 | 图片尺寸，可选值：1024x1024（方形，默认）/ 1792x1024（宽屏 16:9）/ 1024x1792（竖屏 9:16）/ 1280x720 / 720x1280 / 1920x1080。 | `1024x1024` |

## 4. 请求头

| Header | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `Authorization` | `string` | 是 | API Key 鉴权（在控制台申请） | — |
| `Content-Type` | `string` | 否 | 使用 JSON body 时设置。也可通过 form-urlencoded 或 query string 传参。 | — |

## 5. 请求示例 (cURL)

```bash
curl -X POST "https://v1.apizero.cn/api/doubao-image" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "一只赛博朋克猫在雨夜的霓虹街头，低角度，电影感，Wong Kar-Wai 风格",
  "size": "1024x1024"
}'
```

## 6. 响应字段

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `code` | `integer` | 业务状态码，0 表示成功 | `0` |
| `msg` | `string` | 人类可读的状态消息 | `成功` |
| `data.url` | `string` | 生成的图片 URL（字节云 TOS 临时直链，24 小时内有效） | `https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/...` |
| `data.size` | `string` | 实际生成的图片尺寸（与请求传入一致） | `1024x1024` |
| `data.prompt` | `string` | 回显的原始提示词（方便调试和保存） | `一只赛博朋克猫…` |
| `data.created` | `integer` | 图片生成的 Unix 时间戳（秒） | `1777940499` |
| `data.expires_in` | `integer` | URL 有效期（秒），固定 86400 = 24 小时 | `86400` |
| `data.tokens` | `integer` | 本次消耗的 tokens 数（参考成本：方形 4096 / 宽屏 7168） | `4096` |
| `request_id` | `string` | 本次请求 ID（出问题时反馈给客服可快速定位） | `mqx8x12345abc` |

## 7. 响应示例

```json
{
    "code": 0,
    "msg": "成功",
    "data": {
        "url": "https:\/\/ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com\/doubao-seedream-3-0-t2i\/021777940499xxx_0.jpeg?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Expires=86400&X-Tos-Signature=...",
        "size": "1024x1024",
        "prompt": "一只赛博朋克猫在雨夜的霓虹街头，低角度，电影感，Wong Kar-Wai 风格",
        "created": 1777940499,
        "expires_in": 86400,
        "tokens": 4096
    },
    "request_id": "mqx8x12345abc"
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `0` | `OK` | 成功 |
| `4000` | `Bad Request` | 参数错误：缺少 prompt 或 size 不在允许枚举内（1024x1024 / 1792x1024 / 1024x1792 / 1280x720 / 720x1280 / 1920x1080） |
| `4011` | `Unauthorized` | API Key 无效：Bearer Token 格式错误或不存在 |
| `4013` | `Forbidden` | API Key 已暂停 |
| `4014` | `Forbidden` | 当前 IP 不在 API Key 白名单内 |
| `4015` | `Unauthorized` | 本接口需要 API Key 才能调用（不开放匿名） |
| `4022` | `Payment Required` | 余额不足，请充值后再试 |
| `4029` | `Too Many Requests` | 调用过快（超过 QPS 限制 2 次/秒） |
| `4030` | `Too Many Requests` | 今日免费额度已用完（登录用户每日 20 张） |
| `5020` | `Bad Gateway` | 上游图片生成服务暂不可用（豆包模型超时或宕机） |
| `5021` | `Bad Gateway` | 上游返回数据格式异常（罕见，平台已上报） |
| `5030` | `Bad Gateway` | 上游 Key 未配置（平台运维问题，请联系客服） |

## 9. 变更日志

- **1.0.0** (2026-05-05)
  - 首次发布
  - 基于豆包 Seedream 3.0（Doubao-Seedream-3.0-T2I）
  - 支持 prompt + size 双参数，6 种尺寸枚举
  - 中英文混合提示词
  - 平均 3~4 秒出图
  - 图片 URL 24 小时有效，建议下载保存

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/doubao-image`

Source: `https://apizero.cn/aidocs/doubao-image/raw.md`
Last updated: 2026-05-11T16:15:07+08:00