跳转到主要内容
POST
提交 Flux Schnell 文生图任务
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。

提交任务

向 POST /api/generate/submit 发送 model: "blackforestlabs/flux/schnell" 和一个 input 对象。使用 Authorization: Bearer VIDGO_API_KEY 认证。
  • prompt:必填字符串。描述图像,去除首尾空白后至少一个字符。
  • size:输出画布,默认 1:1。可选 1:1、1:1 HD、4:3、3:4、16:9、9:16,或自定义 WIDTHxHEIGHT(如 1024x1536)。自定义宽和高为正整数。
  • n:正整数,指定输出图像数量,默认 1。
  • output_format:png 或 jpeg,默认 png。

获取图像

提交响应会返回 data.task_id。使用查询任务状态跟踪任务经过 not_started、running、finished 或 failed 等状态。 状态为 finished 时,从 data.files[].file_url 读取图像 URL。状态为 failed 时,读取 data.error_message。 可以在顶层提供 callback_url,通过 Webhook 接收最终结果。

已验证示例

崖边泳池的第一缕晨光。此文生图示例只使用提示词。
崖边泳池的第一缕晨光

授权

Authorization
string
header
必填

使用 Authorization: Bearer VIDGO_API_KEY。

请求体

application/json
model
enum<string>
必填
可用选项:
blackforestlabs/flux/schnell
input
object
必填

文生图参数。

callback_url
string<uri>

可选的 Webhook 回调 URL。

响应

任务提交成功

code
integer
必填
示例:

200

data
object
必填