图像与视频的提示词扩写

· Hyperouter · 阅读约 3 分钟

图像和视频模型更适合长而具体的提示词，而大多数人写得很短。提示词扩写正是为了弥补这一差距：设置 "prompt_expand": true 后，Hyperouter 会在模型生成之前为它改写你的提示词。图像会得到更完整的描述，视频会得到逐秒的脚本。

该功能默认关闭，因此提示词会按你写的原样发送给模型。

哪些模型支持

Lumina 和 Qwen 的图像与视频模型中，列出 prompt_expand 的才支持它。支持的模型会陆续增加，请以该列表为准，不要依赖文章：GET /v1/models 会为每个模型返回 supported_parameters，支持该字段的模型会在其中列出 prompt_expand。

curl https://api.hyperouter.app/v1/models \
  -H "Authorization: Bearer $HYPEROUTER_API_KEY"

该字段只能用于创建图像或视频。用在其他模型上，或用于视频的编辑、延长、remix 时，会以 400 unsupported_parameter 拒绝。它也不能与 prompt_extend: true 同时使用，否则会以 400 invalid_body 拒绝。

在请求中开启

prompt_expand 是图像和视频创建接口的顶层字段。OpenAI SDK 将它作为额外的请求体字段发送。Qwen Image 2.0 支持它：

curl https://api.hyperouter.app/v1/images/generations \
  -H "Authorization: Bearer $HYPEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen-image-2.0",
    "prompt": "A lighthouse at dusk",
    "prompt_expand": true
  }'

创建视频时，使用 POST /v1/videos 并带上同一个字段。另一个字段 locale 是 BCP 47 语言标签，例如 zh-CN。与 prompt_expand 一起使用时，它决定视频中台词的语言，前提是模型会说该语言。不设置时，台词为英语。

查看实际生成的内容

响应中带有 expanded_prompt，即模型实际收到的提示词。你自己的 prompt 保持不变。该字段出现在：

Hyperouter 在请求后保留 expanded_prompt 30 天，之后返回 null。未做扩写时，它同样为 null。

如果需要保存超过 30 天，请把 expanded_prompt 存入你自己的记录。

费用

改写在同一个请求上计费，按它实际用掉的 token、以 x-ai/grok-4.6 的 token 价格计算。与任何请求一样，Hyperouter 会把改写可能产生的最高费用和生成费用一起预先预扣，再按实际用量扣费。不会产生第二次调用。

改写失败、超时或无法使用时，不会导致你的请求失败。模型会按你发送的原始提示词生成，响应中 expanded_prompt: null，改写不收费。

如何开通

提示词扩写需由 Hyperouter 为账户开通后才能使用。如需申请，请在控制台中提交支持工单。

开通之前，GET /v1/models 不会为任何模型列出 prompt_expand。在提供该功能的模型上发送 prompt_expand: true，会返回：

{
  "error": {
    "message": "...",
    "type": "permission_error",
    "code": "feature_not_enabled",
    "param": "prompt_expand"
  }
}

状态码为 403。不会预扣任何费用，也不会向服务商发送任何内容，因此被拒绝的请求不收费。请以 code 匹配，不要以 message 匹配。

下一步

相关文章