提交视频生成任务
采用 OpenRouter 风格的平铺视频输入。Felo 的模型 ID、通道、任务 ID 和响应格式保持不变。旧的 input 包装和供应商原生字段会被拒绝。不支持回调、续接生成、供应商选项和视频超分。模型和通道的能力可能会进一步限制这些参数。返回 HTTP 202 和 Felo 的 task_id。轮询 GET /api/v1/videos/generations/{task_id}。不支持的字段返回 HTTP 400。
- 类型: stringX
- Request - Id 可选的调用方请求 ID,用于诊断时回显。
- 类型: stringX
- Felo - Channel 以逗号分隔、按顺序排列的公开通道代码。省略此请求头表示使用 default;default 必须单独使用。在钱包模式下,default 会从后往前扫描该模型实际生效的公开通道顺序,跳过未发布或不可用的通道,并选择第一个可用通道的提供方。它会纳入该提供方下上游模型 ID 和服务层级相同的可用端点。显式通道按客户端指定的顺序校验;仅提交第一个通道所属的提供方组。不会自动回退到其他提供方。旧版提供方请求头无法覆盖通道路由。
采用 OpenRouter 风格的平铺视频输入。Felo 的模型 ID、通道、任务 ID 和响应格式保持不变。旧的 input 包装和供应商原生字段会被拒绝。不支持回调、续接生成、供应商选项和视频超分。模型和通道的能力可能会进一步限制这些参数。
- 类型: stringmodel最小长度:1必填
- 类型: string 枚举aspect
_ratio 值- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
- 3:2
- 2:3
- 21:9
- 9:21
- 类型: string 枚举character
_orientation Required by supported Kling motion-control models: orientation source.
值- image
- video
- 类型: integerduration最小值:1
Integer numbers.
- 类型: array object[]frame
_images - frame类型: string 枚举
_type 必填值- first
_frame - last
_frame
- image
_url 必填- url类型: string最小长度:1必填
- 类型: string
- file类型: string
_id 最大长度:80Uploaded Felo file owned by the authenticated user.
- type枚举常量:image_url必填值
- image
_url
- 类型: booleangenerate
_audio - 类型: arrayinput
_references - image
_url 必填- url类型: string最小长度:1必填
- 类型: string
- file类型: string
_id 最大长度:80Uploaded Felo file owned by the authenticated user.
- type枚举常量:image_url必填值
- image
_url
- 类型: stringprompt
- 类型: objectprovider
- options类型: object必填
Options keyed by the slug published in the model catalog provider_options.
- property类型: object
Name
- 类型: string 枚举resolution值
- 360p
- 480p
- 720p
- 768p
- 1080p
- 1
K - 2
K - 4
K
- 类型: integerseed
Integer numbers.
- 类型: stringsession
_id 最大长度:256
- 类型: stringsize
- 类型: objecttrace
- generation类型: string
_name - parent类型: string
_span _id - span类型: string
_name - trace类型: string
_id - trace类型: string
_name - property类型: anything
Name
- 类型: stringuser最大长度:256
- 类型: object · VideoGenerationAccepted202
任务已接受
- 枚举kind常量:video必填值
- video
- 类型: array string[]outputs必填
任务成功前为空。
- 枚举status常量:queued必填值
- queued
- 类型: stringtask
_id 必填用于轮询的任务 ID。
application/json - 类型: object · GenerationError400
请求无效(未知模型、混用输入模式、字段无效)
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json - 类型: object · GenerationError401
Felo API 密钥无效或缺失
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json - 类型: object · GenerationError402
余额不足 / 未满足计费要求
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json - 类型: object · GenerationError403
该账户未获授权(需要订阅或用户已被封禁)。已停用的模型也会在调用上游之前被拒绝。已接受的请求和任务继续进行。
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json - 类型: object · GenerationError429
已达到请求或消费上限
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json - 类型: object · GenerationError502
上游提供方失败
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json - 类型: object · GenerationError503
生成服务或计费服务暂时不可用
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json
curl https://openapi.felo.ai/api/v1/videos/generations \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"model": "veo-3.1-lite",
"prompt": "A cinematic camera move",
"duration": 4,
"resolution": "720p",
"generate_audio": false,
"frame_images": [
{
"type": "image_url",
"frame_type": "first_frame",
"image_url": {
"url": "https://example.com/first.png"
}
}
]
}'
{
"task_id": "string",
"status": "queued",
"kind": "video",
"outputs": [
"string"
]
}