Seedream 5.0 Lite Text to Image API

POST /v1/tasks

所有模型都通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称	seedream-5.0-lite/text-to-image
类型	图像生成（文生图）
接口	POST /v1/tasks
价格	见 HiAPI 定价

字节跳动 Seedream 5.0 Lite 文生图：带推理的图像生成，支持实时联网知识，多语言文字渲染准确，擅长海报、菜单与信息图，2K 与 4K 同价。

生产建议

生产环境建议

生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

文字排版类画面

海报、菜单、信息图等含文字的画面是强项，中英多语言文字渲染准确；把要出现的文字逐字写进提示词即可。

prompt

实时知识作画

模型自带联网检索与推理能力，可以把时事、数据等现实信息画进画面，标注类信息图的数据准确性好。

prompt

4K 超清交付

4K 档长边约 4096px（实测），与 2K 同价，印刷物料和大屏展示直接选 4K。

resolution

多画幅适配

8 档宽高比从 1:1 到 21:9，同一提示词适配信息流、横幅与竖版海报。

aspect_ratio

请求参数

POST https://api.hiapi.ai/v1/tasks

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
# 把 YOUR_API_KEY 换成你的账号 API Key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5.0-lite/text-to-image",
  "input": {
    "prompt": "A hand-painted museum poster for a bronze-age exhibition, featuring an ancient Chinese bronze ding vessel as the centerpiece, elegant Chinese calligraphy title 青铜时代 at the top with smaller English subtitle BRONZE AGE below it, cinematic composition, dramatic directional lighting, rich cohesive color grade of aged gold and deep teal, ultra-detailed, premium commercial finish, subtle film grain",
    "aspect_ratio": "3:4",
    "resolution": "2K"
  }
}'

import requests, json

# 业务参数对象，字段随模型而定（见对应模型页）
payload = json.loads(r'''
{
  "model": "seedream-5.0-lite/text-to-image",
  "input": {
    "prompt": "A hand-painted museum poster for a bronze-age exhibition, featuring an ancient Chinese bronze ding vessel as the centerpiece, elegant Chinese calligraphy title 青铜时代 at the top with smaller English subtitle BRONZE AGE below it, cinematic composition, dramatic directional lighting, rich cohesive color grade of aged gold and deep teal, ultra-detailed, premium commercial finish, subtle film grain",
    "aspect_ratio": "3:4",
    "resolution": "2K"
  }
}
''')

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # 成功返回 { code, message, data: { taskId } }

// 提交异步任务，成功立即返回 taskId（不等待生成完成）
// 把 YOUR_API_KEY 换成你的账号 API Key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedream-5.0-lite/text-to-image",
  "input": {
    "prompt": "A hand-painted museum poster for a bronze-age exhibition, featuring an ancient Chinese bronze ding vessel as the centerpiece, elegant Chinese calligraphy title 青铜时代 at the top with smaller English subtitle BRONZE AGE below it, cinematic composition, dramatic directional lighting, rich cohesive color grade of aged gold and deep teal, ultra-detailed, premium commercial finish, subtle film grain",
    "aspect_ratio": "3:4",
    "resolution": "2K"
  }
}),
});
console.log(await resp.json()); // 成功返回 { code, message, data: { taskId } }

model string 必填

固定填 seedream-5.0-lite/text-to-image。

示例 seedream-5.0-lite/text-to-image

input object 必填

业务参数对象；Seedream 5.0 Lite Text to Image 的模型专属配置都放在这里。

prompt string 必填

要生成的画面描述，3–3000 字符。模型会推理提示词背后的意图，并可结合实时联网知识作画；需要画面中出现文字时，把每个字词逐字写进提示词。

aspect_ratio enum 必填

输出图片的宽高比。

默认 1:1 可选值: 1:14:33:416:99:162:33:221:9

resolution enum 必填

输出分辨率档位：2K 标准档（长边约 2300px），4K 超清档（长边约 4096px，实测），两档同价。

默认 2K 可选值: 2K4K

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback

when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

博物馆展览海报（书法文字渲染）

3:4 / 2K，中英双语标题海报，验证文字渲染与排版。

请求体

{
  "model": "seedream-5.0-lite/text-to-image",
  "input": {
    "prompt": "一张手绘风博物馆青铜时代特展海报，以中国古代青铜鼎为主体，顶部书法标题「青铜时代」，下方英文副标题 BRONZE AGE，电影感构图，戏剧性定向打光，做旧金与深青统一色调，超高细节，商业级质感，细微胶片颗粒",
    "aspect_ratio": "3:4",
    "resolution": "2K"
  }
}

太阳系信息图（数据标注）

4:3 / 4K，八大行星带公转周期标注，验证知识准确性。

请求体

{
  "model": "seedream-5.0-lite/text-to-image",
  "input": {
    "prompt": "现代扁平设计的太阳系科普信息图海报，极简几何行星配清晰无衬线标注：水星、金星、地球、火星、木星、土星、天王星、海王星，靛蓝渐变深空背景上的细白轨道环，附公转周期数据标注，博物馆印刷品质",
    "aspect_ratio": "4:3",
    "resolution": "4K"
  }
}

雨夜霓虹街（电影感摄影）

16:9 / 4K，三语霓虹招牌全部清晰可读。

请求体

{
  "model": "seedream-5.0-lite/text-to-image",
  "input": {
    "prompt": "雨夜的亚洲都市霓虹小吃巷，招牌文字清晰可读：「夜宵小馆」「NIGHT NOODLES」「ラーメン横丁」，湿滑柏油路面镜面反射，食摊蒸汽升腾，电影感构图，青色与品红统一色调，超高细节，细微胶片颗粒",
    "aspect_ratio": "16:9",
    "resolution": "4K"
  }
}

获取结果

提交成功后立即返回 taskId（不等待生成完成）。
生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
status=success 后，从返回的 output[].url 下载生成的图片。
如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

2K 和 4K 有什么区别？价格一样吗？

2K 标准档长边约 2300px，4K 超清档长边约 4096px（均为实测）。两档同价，按张计费，与分辨率无关，实时价格见价格页。查看价格

能在图里准确渲染文字吗？

中英多语言文字渲染是这款模型的强项。把要出现的每个字词逐字写进提示词并注明「文字准确」，不要只给拼音或英文译名；生僻字形在艺术字体下偶有失准，重要文案生成后放大检查。

联网知识和推理是什么？需要额外参数吗？

模型内置实时联网检索与意图推理，直接在提示词里描述需求即可（例如画当天的天气或某组真实数据），不需要任何额外参数。

怎么拿到生成的图片？

提交后立即返回 taskId，任务进入终态后从 output[].url 下载图片。生产环境建议在请求体顶层传 callback.url 收终态通知，减少无效轮询。