Flux 3 - PoYo AI

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "flux-3/text-to-video",
  "input": {
    "prompt": "A red panda walks through a sunlit forest",
    "duration": 5,
    "resolution": "720p"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "<string>",
    "status": "not_started",
    "created_time": "2023-11-07T05:31:56Z"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "flux-3/text-to-video",
  "input": {
    "prompt": "A red panda walks through a sunlit forest",
    "duration": 5,
    "resolution": "720p"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "<string>",
    "status": "not_started",
    "created_time": "2023-11-07T05:31:56Z"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

提交后会返回 task_id。如果提供了 callback_url，当任务状态变为 finished 或 failed 时，系统会向 callback_url 发送 POST 请求。
无论是否提供 callback_url，都可以通过统一的查询任务状态接口获取结果。

根据要提供的源媒体选择模型：

模型	必需的媒体输入
`flux-3/text-to-video`	无
`flux-3/image-to-video`	`image_urls` 中一张图片
`flux-3/first-last-frame-to-video`	`image_urls` 中两张按顺序排列的图片
`flux-3/extend-video`	`video_url` 中一个 MP4
`flux-3/keyframes-to-video`	`keyframes` 中 1-10 项

各模型的具体要求和限制见下方参数说明。

模型

flux-3/text-to-video — 文生视频
flux-3/image-to-video — 图生视频
flux-3/first-last-frame-to-video — 首尾帧生视频
flux-3/extend-video — 视频续写
flux-3/keyframes-to-video — 关键帧生视频

授权

Authorization

string

header

必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key：登录 PoYo，进入仪表盘 → API 密钥（poyo.ai/zh/dashboard/api-key），点击创建 Key。

在请求头中添加：

Authorization: Bearer YOUR_API_KEY

请求体

application/json

model

enum<string>

必填

要使用的 Flux 3 工作流。所选模型决定必填的媒体输入字段。

可用选项:

flux-3/text-to-video,

flux-3/image-to-video,

flux-3/first-last-frame-to-video,

flux-3/extend-video,

flux-3/keyframes-to-video

input

object

必填

Show child attributes

callback_url

string<uri>

接收 finished 或 failed 结果的 Webhook URL。

响应

任务已提交

code

enum<integer>

业务状态码。200 表示成功，其他值都表示请求失败。请务必检查这个字段：部分参数校验错误会以 HTTP 200 返回，响应体里的 code 为 400。

200：成功
400：请求参数无效
401：API Key 缺失或无效
402：积分不足
403：没有权限
404：资源不存在
408：请求超时
429：请求频率超限
500：服务器内部错误
502：上游服务错误
503：服务暂不可用

详见错误码。

可用选项:

200,

400,

401,

402,

403,

404,

408,

429,

500,

502,

503

示例:

200

data

object

Show child attributes

​模型

授权

请求体

响应

模型