创建视频生成任务

POST https://open.feiyutoken.com/v1/video/generations

请求参数

参数	类型	必填	说明
model	string	是	模型名，沿用厂商官方命名；可用值见模型列表
prompt	string	条件必填	文本提示词，描述画面内容与镜头运动。文生视频必填；图生视频视模型厂商而定
image	string	否	图生视频的输入图，填图片 URL 或 Base64
duration	number	否	期望的视频时长（秒）
width	integer	否	期望的宽
height	integer	否	期望的高
fps	integer	否	期望的帧率
seed	integer	否	随机种子，固定它便于复现同一条结果
n	integer	否	生成数量
response_format	string	否	结果的返回形式，如 url
user	string	否	调用方自己的用户标识，便于对账
metadata	object	否	厂商扩展参数，如 negative_prompt、style、quality_level

只传 prompt（不带 image）就是文生视频；带上 image 就是图生视频。

metadata 里可用的键名由模型厂商定义，这里不做约定；不确定就先不传，或者只传厂商文档里 明确写有的那一两个。

请求示例

curl https://open.feiyutoken.com/v1/video/generations \
  -H "Authorization: Bearer <你的飞鱼Token API Key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名>",
    "prompt": "清晨的山谷，镜头缓慢向前推进，光线从左侧照入"
  }'

响应

{
  "task_id": "<task_id>",
  "status": "queued"
}

拿到 task_id 就说明任务已经受理，此时还没有视频结果。接着用 获取视频生成任务状态 轮询，直到 completed 或 failed。

计费与用量

视频生成按视频时长与分辨率从账户余额扣减，用量明细在控制台查看。