curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "bytedance/seedream/v4.5/text-to-image",
"input": {
"prompt": "A detailed isometric cutaway illustration of a small polar research station standing on steel stilts on an Antarctic ice shelf, shown like a page from a science museum guidebook. The roof and front wall are removed so six rooms are visible, each with a small clean sans-serif label plate printed exactly: \"LAB\" (a scientist examining an ice core under a lamp), \"GALLEY\" (two people cooking soup at a steaming stove), \"BUNKS\" (stacked beds with colorful quilts), \"RADIO\" (an operator with headphones in front of dials), \"GREENHOUSE\" (lettuce and tomatoes under pink grow lights) and \"GARAGE\" (an orange snowcat being repaired). A banner across the top reads exactly \"AURORA RIDGE STATION\", and a small thermometer sign beside the entrance reads \"-38°C\". Tiny figures, pipes, ladders and cables connect the rooms logically. Outside: blowing snow, a weather mast, a pale green aurora in the dark sky. Crisp linework, soft flat colors, consistent isometric perspective, every label spelled correctly and legible, no extra text, no watermark.",
"size": "4:3",
"n": 1,
"enable_safety_checker": true
}
}
'{
"code": 200,
"data": {
"task_id": "PGQCZ3X31DC6OEXQ",
"status": "running",
"created_time": "2026-09-25T16:14:03"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Seedream
Seedream 4.5 文生图
Seedream 4.5 文生图 API 根据一条提示词生成多张图像,用于发展视觉概念、探索不同风格和构图。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "bytedance/seedream/v4.5/text-to-image",
"input": {
"prompt": "A detailed isometric cutaway illustration of a small polar research station standing on steel stilts on an Antarctic ice shelf, shown like a page from a science museum guidebook. The roof and front wall are removed so six rooms are visible, each with a small clean sans-serif label plate printed exactly: \"LAB\" (a scientist examining an ice core under a lamp), \"GALLEY\" (two people cooking soup at a steaming stove), \"BUNKS\" (stacked beds with colorful quilts), \"RADIO\" (an operator with headphones in front of dials), \"GREENHOUSE\" (lettuce and tomatoes under pink grow lights) and \"GARAGE\" (an orange snowcat being repaired). A banner across the top reads exactly \"AURORA RIDGE STATION\", and a small thermometer sign beside the entrance reads \"-38°C\". Tiny figures, pipes, ladders and cables connect the rooms logically. Outside: blowing snow, a weather mast, a pale green aurora in the dark sky. Crisp linework, soft flat colors, consistent isometric perspective, every label spelled correctly and legible, no extra text, no watermark.",
"size": "4:3",
"n": 1,
"enable_safety_checker": true
}
}
'{
"code": 200,
"data": {
"task_id": "PGQCZ3X31DC6OEXQ",
"status": "running",
"created_time": "2026-09-25T16:14:03"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- 提交后会返回
task_id。如果提供了callback_url,当任务状态变为finished或failed时,系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url,都可以通过统一的查询任务状态接口获取结果。
模型
- bytedance/seedream/v4.5/text-to-image - 根据文本提示词生成图像。
功能
- 根据文本提示词生成图像。
- 通过
n控制输出图像数量。
输出选项
图像尺寸
size:可选。默认:1:1。- 预设:
2K、4K、1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9。 - 自定义尺寸时,提供包含整数
width和height的对象,两者都必须为正数。 - 自定义尺寸也可以使用
WIDTHxHEIGHT字符串,两个正数之间用x或X分隔。
图像数量
n:可选。要生成的图像数量。1到15的整数。默认:1。
高级参数
model 和可选的 callback_url 放在请求根级。所有工作流参数(包括输出选项)都放在 input 内。
提示词
prompt:必填。描述期望的图像。长度:1-3,000 个字符。- 至少包含一个非空白字符。
安全检查
enable_safety_checker:可选。设为true开启内容安全检查,设为false关闭。默认:true。
已验证示例
此示例通过 Vidgo 测试 API、使用 API Playground 中的basic 请求生成。结果图托管在 Vidgo CDN 上。
{
"code": 200,
"data": {
"task_id": "PGQCZ3X31DC6OEXQ",
"status": "finished",
"files": [
{
"file_url": "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/text-to-image/v1/01/output.jpg",
"file_type": "image"
}
],
"created_time": "2026-09-25T16:14:03",
"error_message": null,
"progress": 100
}
}
授权
使用 VIDGO_API_KEY。
请求体
application/json