跳到正文

Seedream 5.0 Lite API

由文字或参考图生成图片,价格低。

  • 参考图与输出图片每次请求合计最多 15 张
  • 最多 14 张参考图,不另收费
  • 标准7 积分/张 ($0.035)
完整价格 ↓
Size
选择预设,或用“自定义”输入 宽x高,总像素 370 万到 1040 万。
输出格式
图片文件格式。
高级设置
相同的种子和设置会得到相近的结果。留空则随机。
生成前先改写提示词。

正在确认登录状态。

登录后即可生成。这里填写的内容和选择的文件会保留,登录回来后继续。

生成结果会显示在这里

价格

价格自 2026-11-09 起生效

档位价格
标准
standard
7 积分/张 ($0.035)

1 积分 ≈ $0.005。按标准充值包计算;较大的充值包含赠送积分,实际单价更低。

交付与计费

成品
成品文件列在任务结果中,每个文件有素材 ID 和类型。
下载
文件保存 7 天,通过短期签名链接下载,可随时删除。
计费
任务受理时冻结积分,交付后扣费。生成失败,或 24 小时内未交付,冻结的积分会全部释放。
通知
按任务 ID 轮询,或使用签名 Webhook,并按 event_id 去重。
如何计费?
按输出图片张数计费。
生成失败会扣费吗?
不会。生成失败,或受理后 24 小时内未交付,冻结的积分会全部释放。

API 参考

任务只创建一次,之后按 ID 查询。 完整脚本(含上传和下载) · API 文档

请求示例
API=https://api.vizoapi.com/v1
AUTH="Authorization: Bearer $VIZO_API_KEY"

# Create the task once and keep its ID.
ID=$(curl -fsS $API/generations -H "$AUTH" -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-lite",
  "input": {
    "prompt": "一碗拉面,逆光蒸汽"
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}' | jq -r .id)

# Poll until the task closes, then read its status and result.
until curl -fsS $API/generations/$ID -H "$AUTH" | jq -e '.closed_at != null' > /dev/null; do sleep 5; done
curl -fsS $API/generations/$ID -H "$AUTH" | jq '{status, result}'
全部字段

在 input 中发送这些字段。表中没有的字段会被拒绝,返回 HTTP 422 invalid_input。

  • optimize_prompt_options is allowed only with optimize_prompt set to true.
  • sequential_image_generation_options is required when sequential_image_generation is auto and allowed only then; reference images plus max_images are at most 15.
请求参数
字段说明
promptstring必填

Text prompt. Must not be blank.

seedinteger可选

Random seed; -1 picks one at random.

最小 -1 · 最大 9223372036854775807

sizestring可选

Output size: WIDTHxHEIGHT with 3,686,400 to 10,404,496 pixels in total, or 2k or 3k.

格式^([1-9][0-9]*x[1-9][0-9]*|2k|3k)$

imagearray of strings可选

Reference images, up to 14.

最多 14 项

optimize_promptboolean可选

Rewrites the prompt before generation.

默认值 false

optimize_prompt_optionsobject可选

Allowed only with optimize_prompt set to true.

optimize_prompt_options.thinkingstring可选

Prompt expansion.

可选值autoenableddisabled
optimize_prompt_options.modestring可选

Optimization mode. Only standard.

固定值 standard

output_formatstring可选

Image file format.

可选值jpegpng

默认值 jpeg

sequential_image_generationstring可选

auto generates a set of related images and requires sequential_image_generation_options.max_images; disabled generates one image.

可选值autodisabled

默认值 disabled

sequential_image_generation_optionsobject可选

Allowed only with sequential_image_generation set to auto. Reference images plus max_images must not exceed 15.

sequential_image_generation_options.max_imagesinteger必填

Number of images to generate, 1 to 15. The hold covers each requested image; a succeeded task is charged only for the images delivered.

最小 1 · 最大 15

watermarkboolean可选

Add a visible watermark. Defaults to false; the tier price is unchanged.

默认值 false

完整请求与响应示例

完整的创建请求、202 响应,以及任务成功后的状态。 此输入选择 standard 档位,每张 7 积分。一张图片冻结 7.000 积分。

请求

{
  "model": "seedream-5-0-lite",
  "input": {
    "prompt": "A paper boat on a pond at dawn, soft watercolor"
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}

202 已受理

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "seedream-5-0-lite",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "processing",
  "execution_status": "processing",
  "delivery_status": "pending",
  "billing_status": "pending",
  "version": 1,
  "price": {
    "unit": "credit",
    "estimated": "7.000",
    "reserved": "0.000",
    "charged": "0.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": null,
  "error": null,
  "result": null
}

200 已成功

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "seedream-5-0-lite",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "succeeded",
  "execution_status": "succeeded",
  "delivery_status": "ready",
  "billing_status": "settled",
  "version": 4,
  "price": {
    "unit": "credit",
    "estimated": "7.000",
    "reserved": "0.000",
    "charged": "7.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": "2026-11-08T09:01:31Z",
  "error": null,
  "result": {
    "asset_id": "ast_01JD8Z9M2C4V",
    "outputs": [
      {
        "index": 0,
        "asset_id": "ast_01JD8Z9M2C4V",
        "content_type": "image/jpeg"
      }
    ]
  }
}

Seedream 5.0 Lite 完整 API 参考