枫林 AI API Reference
API 服务 进入控制台

FENGLIN AI · VIDEO API

视频生成 API 文档

使用统一 API Key 调用 14 个 Seedance 视频模型。模型分别使用 Sudashui Video、 OpenAI Chat Completions 和 OpenAI Videos 三种协议;请始终以 GET /v1/models 返回结果为准。

Base URL https://api.fenglinzhong.top
01获取 Key控制台创建
02上传素材获得素材 URL
03选择协议按模型 ID 调用
04读取结果同步或轮询

AUTHENTICATION

鉴权

所有 API 请求都需要在请求头中携带枫林 AI API Key。Key 只应保存在服务端,不能放入浏览器、 移动端安装包或公开仓库。

HTTP Header
Authorization: Bearer fl-your-api-key
Content-Type: application/json
密钥安全

示例中的 fl-your-api-key 是占位符。不要把真实 Key 提交到 Git、日志或前端代码。

QUICKSTART

最短调用流程

  1. 1
    调用 GET /v1/models

    确认当前 Key 能使用的模型。

  2. 2
    按需调用 POST /v1/files

    保存素材 URL,再按目标协议放入引用字段。

  3. 3
    按模型选择创建接口

    BF / GF / XH 使用 Video Generations,HN 使用 Chat Completions,Megaby 使用 Videos。

  4. 4
    读取同步结果或轮询任务

    HN 直接读取 Chat 结果;另外两类保存 task_id 后查询。

BF / GF / XHSudashui Video

POST /v1/video/generations
GET /v1/video/generations/{task_id}

HNChat Completions

POST /v1/chat/completions
同步读取消息中的视频结果

MegabyOpenAI Videos

POST /v1/videos
GET /v1/videos/{video_id}
GET /v1/videos/{video_id}/content

GET

/v1/models

返回当前 API Key 所在分组可用的模型。后台下线的模型会立即从列表移除。

curl
curl https://api.fenglinzhong.top/v1/models +  -H "Authorization: Bearer fl-your-api-key"
响应示例
{
  "object": "list",
  "data": [
    {
      "id": "seedance-2.0-1080p",
      "object": "model",
      "owned_by": "custom"
    }
  ]
}
POST

/v1/files

使用 multipart/form-data 上传单个素材,字段名固定为 file

类型MIME扩展名单文件限制
图片image/jpeg.jpg / .jpeg30 MB
图片image/png.png30 MB
图片image/webp.webp30 MB
音频audio/mpeg.mp315 MB
音频audio/wav.wav15 MB
视频video/mp4.mp450 MB
视频video/quicktime.mov50 MB
curl
curl https://api.fenglinzhong.top/v1/files +  -H "Authorization: Bearer fl-your-api-key" +  -F "file=@./reference.jpg"
200{ "url": "https://.../reference.jpg" }
POST

/v1/video/generations

BF、GF 和 XH 模型使用此异步接口。metadata.payload 必须是 JSON 字符串;不要把 imageUrlsaspectRatiomode 放到请求外层。

同一接口,两种计费方式

BF、GF 支持 4-15 秒并按实际秒数计费;XH 仅支持 10 秒或 15 秒,按一次请求计费,10 秒与 15 秒同价。XH 不支持真人脸素材。

字段类型必填说明
modelstring使用 /v1/models 返回的模型 ID
promptstring建议支持 @image1@audio1 引用
durationintegerBF / GF 为 4-15 秒;XH 为 10 或 15 秒
metadata.payloadstring内部 JSON 见下方示例
curl https://api.fenglinzhong.top/v1/video/generations +  -H "Authorization: Bearer fl-your-api-key" +  -H "Content-Type: application/json" +  -d '{
    "model": "seedance-2.0-1080p",
    "prompt": "让 @image1 中的角色自然转身,电影感运镜",
    "duration": 5,
    "metadata": {
      "payload": "{\"aspectRatio\":\"16:9\",\"mode\":\"references\",\"imageUrls\":[\"https://files.example/reference.jpg\"]}"
    }
  }'
创建成功响应
{
  "id": "task_local_xxxxxxxxxxxx",
  "task_id": "task_local_xxxxxxxxxxxx",
  "object": "video",
  "model": "seedance-2.0-1080p",
  "status": "queued",
  "progress": 0,
  "created_at": 1784200000
}
POST

/v1/chat/completions

hn-seedance-2.0-720p 使用 OpenAI Chat Completions 协议,并按一次请求计费。 支持 5、10、15 秒;响应完成后直接从 choices[0].message.content 读取视频结果,无需轮询 Video Generations。

字段类型说明
modelstring固定为 hn-seedance-2.0-720p
messagesarray文本与图片、音频、视频 URL 使用多模态 content
durationinteger5、10 或 15
resolutionstring固定为 720p
aspect_ratiostring16:99:16
curl
curl https://api.fenglinzhong.top/v1/chat/completions +  -H "Authorization: Bearer fl-your-api-key" +  -H "Content-Type: application/json" +  -d '{
    "model": "hn-seedance-2.0-720p",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "让角色自然转身,电影感运镜"},
        {"type": "image_url", "image_url": {"url": "https://files.example/reference.jpg"}}
      ]
    }],
    "duration": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "n": 1,
    "stream": false
  }'
参考能力

最多 4 张图片、1 个音频、3 个参考视频;参考视频总时长 2-15 秒。

POST

/v1/videos

四个 Megaby 模型使用 OpenAI Videos 协议并按一次请求计费。创建后保存返回的 id, 再调用 GET /v1/videos/{video_id};完成后可读取结果或访问 GET /v1/videos/{video_id}/content

curl
curl https://api.fenglinzhong.top/v1/videos +  -H "Authorization: Bearer fl-your-api-key" +  -H "Content-Type: application/json" +  -d '{
    "model": "megaby-seedance-2.0-fast-480p",
    "prompt": "参考素材中的角色向镜头挥手",
    "duration": 8,
    "ratio": "16:9",
    "resolution": "480p",
    "referenceImages": ["https://files.example/reference.jpg"]
  }'
时长4-15 秒

按次计费,价格不随时长相乘。

参考能力9 / 3 / 3

最多 9 图、3 音频、3 视频;音频和视频各自总时长不超过 15 秒。

真人脸不支持

Megaby 模型不支持真人脸素材,请使用非真人素材。

GET

/v1/video/generations/{task_id}

此查询接口用于 BF、GF、XH。使用创建任务时返回的枫林 AI 本地 task_id,不能使用任何上游任务 ID。HN 为同步 Chat 响应;Megaby 使用 GET /v1/videos/{video_id}

curl
curl https://api.fenglinzhong.top/v1/video/generations/task_local_xxxxxxxxxxxx +  -H "Authorization: Bearer fl-your-api-key"
查询状态兼容语义处理方式
QUEUEDqueued已排队,继续轮询
IN_PROGRESSin_progress生成中,继续轮询
SUCCESScompleted读取 data.result_url
FAILUREfailed读取 data.fail_reason
成功响应示例
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_local_xxxxxxxxxxxx",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://files.example/output.mp4",
    "fail_reason": ""
  }
}

PRICING

模型与价格

BF、GF 按秒计费,1M 计费单位 = 1 秒;HN、XH、Megaby 按一次请求计费。 广场中的输入价和补全价只是兼容展示,不会相加扣费。

BF · FULL · 720P¥0.98/秒bf-seedance-2.0-720p
BF · FAST · 720P¥0.92/秒bf-seedance-2.0-fast-720p
GF · FAST · 720P¥0.95/秒seedance-2.0-fast-720p
GF · STANDARD · 720P¥1.03/秒seedance-2.0-720p
GF · STANDARD · 1080P¥1.05/秒seedance-2.0-1080p
GF · HIGH · 2K¥1.15/秒seedance-2.0-2k
GF · ULTRA · 4K¥1.20/秒seedance-2.0-4k
HN · FULL · 720P¥4.30/次hn-seedance-2.0-720p
XH · FAST · 720P¥3.00/次xh-seedance-2.0-fast-720p
XH · PRO · 720P¥3.50/次xh-seedance-2.0-pro-720p
MEGABY · STANDARD · 480P¥1.97/次megaby-seedance-2.0-standard-480p
MEGABY · STANDARD · 720P¥2.60/次megaby-seedance-2.0-standard-720p
MEGABY · FAST · 480P¥1.34/次megaby-seedance-2.0-fast-480p
MEGABY · FAST · 720P¥1.97/次megaby-seedance-2.0-fast-720p
费用公式BF / GF:duration × 每秒价格;HN / XH / Megaby:模型每次价格例:GF 1080p 生成 5 秒为 5 × ¥1.05 = ¥5.25;HN 一次请求为 ¥4.30。

ASSETS

素材与真人标记

图片最多 9 张

imageUrls;提示词中从 @image1 开始引用。

音频最多 3 个

audioUrls;总时长不超过 15 秒。

参考视频最多 3 个

GF 模型不支持参考视频;其他模型以能力表为准。

模型系列生成时长图片 / 音频 / 视频真人脸与补充规则
BF4-15 秒9 / 3 / 3支持真人素材;参考视频总时长 2-15 秒
GF4-15 秒9 / 3 / 0不支持参考视频;真人图片需填写 officialAssetIndexes
HN5 / 10 / 15 秒4 / 1 / 3使用 Chat 多模态 content;参考视频总时长 2-15 秒
XH10 / 15 秒9 / 3 / 3不支持真人脸素材
Megaby4-15 秒9 / 3 / 3不支持真人脸素材;参考音频、视频各自总时长不超过 15 秒

真人或虚拟人像

GF 官方模型使用真人或虚拟人像图片时,需要在 officialAssetIndexes 中标记对应图片。 数组下标从 0 开始,而提示词中的 @image1 从 1 开始。

imageUrls[0]普通背景图@image1
imageUrls[1]真人图片@image2
officialAssetIndexes: [1]
XH 与 Megaby 真人脸提示

这两类渠道不支持真人脸素材。请直接使用非真人素材,避免任务被上游拒绝。

素材顺序

图片、音频各自独立编号。索引不能重复或越界;真人素材登记失败时任务不会自动降级。

ERRORS

错误处理

保存响应头中的请求 ID,并在工单或联系管理员时提供。上传错误使用 OpenAI 风格包装,任务错误使用顶层字段。

上传错误

{
  "error": {
    "code": "unsupported_file_type",
    "message": "unsupported file type",
    "request_id": "req_xxxxxxxx"
  }
}

任务错误

{
  "code": "invalid_duration",
  "message": "duration is not supported by the selected model",
  "data": null
}
code含义处理
invalid_duration时长不符合所选模型能力BF / GF / Megaby 使用 4-15 秒,HN 使用 5/10/15,XH 使用 10/15
model_not_found模型不存在或已下线重新调用 /v1/models
insufficient_user_quota余额不足联系管理员充值
unsupported_file_type扩展名或 MIME 不支持转换为受支持的格式
file_too_large素材超过限制压缩素材后重新上传
upload_channel_unavailable上传通道暂不可用稍后有限次数重试

RELIABILITY

轮询与重试

01

轮询间隔建议 3-5 秒。BF / GF / XH 轮询 Video Generations,Megaby 轮询 Videos;HN Chat 成功响应无需轮询。

02

遇到 4295xx 时读取 Retry-After,最多重试 3 次,并加入随机抖动。

03

不要盲目重试 POST。成功拿到 task_id 后只轮询查询接口。

04

若网络在创建响应前断开,先用请求 ID 检查控制台日志或联系管理员,确认未创建后再提交。