Tokaify APITokaify API
API 参考
AI 模型接口图像doubao接口doubao-seedream-4-0-250828

图像生成

doubao-seedream-4-0-250828 图像生成接口

用于高质量文生图、参考图生成、多图融合和组图生成。

POST
/v1/images/generations

Authorization

BearerAuth

AuthorizationBearer <token>

模型 relay 接口鉴权。请求头:Authorization: Bearer

In: header

Request Body

application/json

model*string

图片模型名称。

Default"doubao-seedream-4-0-250828"
prompt*string

正向提示词。 提示词。范围:1 到 200000 字符,具体上限以模型官方接口为准。

n?integer

返回图片数量。 生成候选数量。范围:1 到 10;具体上限以模型官方接口为准。

Range1 <= value <= 10
size?string

生成尺寸,例如 1024x1024

quality?string

生成质量档位。

style?string

生成风格。

response_format?string

图片返回格式,例如 urlb64_json

user?string

终端用户标识。

Response Body

application/json

curl -X POST "https://api.tokaify.com/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "doubao-seedream-4-0-250828",    "prompt": "用简洁中文介绍这个 API 网关的能力。"  }'
{
  "created": 1,
  "data": {}
}

请求参数

字段类型必选默认值描述
modelstring固定为 doubao-seedream-4-0-250828
promptstring生成或编辑提示词。建议不超过 300 个中文字符或 600 个英文单词。
imagestring 或 string[]参考图 URL 或 Base64;多图融合最多建议 14 张,参考图数量与最终生成图数量合计不超过 15。
sizestring2K支持 1K2K4K<宽>x<高>;宽高比建议在 1:1616:1
response_formatstringurl返回格式,支持 urlb64_json
watermarkbooleantrue是否添加 AI 生成水印。
sequential_image_generationstringdisabled组图模式,支持 disabledauto
sequential_image_generation_options.max_imagesinteger1组图最大输出数量,范围 115
streambooleanfalse是否开启流式输出。
userstring终端用户标识。

示例代码

curl https://api.tokaify.com/v1/images/generations \
  -H "Authorization: Bearer $TOKAIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "生成三张一致风格的 SaaS 官网首屏插画,蓝紫渐变,玻璃拟态",
    "size": "2K",
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": { "max_images": 3 },
    "response_format": "url"
  }'
import requests

response = requests.post(
    "https://api.tokaify.com/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_TOKAIFY_API_KEY"},
    json={
        "model": "doubao-seedream-4-0-250828",
        "prompt": "生成三张一致风格的 SaaS 官网首屏插画,蓝紫渐变,玻璃拟态",
        "size": "2K",
        "sequential_image_generation": "auto",
        "sequential_image_generation_options": {"max_images": 3},
        "response_format": "url",
    },
)
print(response.json())
const response = await fetch("https://api.tokaify.com/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TOKAIFY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "doubao-seedream-4-0-250828",
    prompt: "生成三张一致风格的 SaaS 官网首屏插画,蓝紫渐变,玻璃拟态",
    size: "2K",
    sequential_image_generation: "auto",
    sequential_image_generation_options: { max_images: 3 },
    response_format: "url",
  }),
});
console.log(await response.json());

响应示例

{
  "created": 1777432320,
  "data": [
    {
      "url": "https://api.tokaify.com/assets/images/seedream-4-0-1.png",
      "b64_json": null,
      "revised_prompt": "SaaS 官网首屏插画,蓝紫渐变,玻璃拟态,统一品牌视觉"
    }
  ]
}

业务提示

计费倍率按后台模型倍率与渠道倍率配置执行。Seedream 4.0 不建议传 guidance_scale;如需组图,传 sequential_image_generation=auto 并限制 max_images

这篇文档对您有帮助吗?

最后更新于