API 文档

打开管理设置 → 系统配置 → 账户与安全 → 服务 API Key，填写并保存。Key 与管理员登录密码、Adobe Cookie 不同。

也支持 X-API-Key: <服务 API Key>。若同时提供 Bearer 和 X-API-Key，服务优先使用 Bearer；Key 留空时，当前实现不校验服务 API Key。

curl --fail-with-body "$BASE_URL/v1/models" \
  -H "Authorization: Bearer $ADOBE_API_KEY"复制

管理 API 和工作台的 /local-video/* 使用登录后的会话 Cookie，服务 Key 不能代替管理员登录。

返回 {"object":"list","data":[...]}，每条包含 id 和 description。从响应中复制完整模型 ID，时长、画幅和分辨率由该 ID 对应的配置决定。

模型列表代表服务支持的配置；实际可用性取决于账号权限、额度和上游状态。请勿将通配符或 TRAE 的模型 ID 直接传入。

传入视频模型和提示词。服务从账号池调度账号，生成完成后返回 JSON 及成品 URL。客户端和反向代理需要允许较长的请求等待。

cURL：文生视频

curl --fail-with-body --max-time 900 "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $ADOBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firefly-veo31-fast-4s-16x9-720p",
    "messages": [{"role": "user", "content": "一只猫在窗边看雨，镜头缓慢推近，电影质感"}],
    "generate_audio": false,
    "stream": false
  }' -o response.json复制

Seedance 2.5

工作台模型下拉框选择 Seedance 2.5；程序调用使用 firefly-seedance25-{时长}s-{画幅}-{分辨率}。支持 4–30 秒、480p / 720p，以及 21x9、16x9、4x3、1x1、3x4、9x16 六种画幅。音频默认关闭，可通过 generate_audio: true 开启；不支持 1080p 和负向提示词。

curl --fail-with-body --max-time 1800 "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $ADOBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firefly-seedance25-5s-16x9-720p",
    "messages": [{"role": "user", "content": "清晨海边，镜头缓慢推进，写实电影质感"}],
    "generate_audio": false,
    "stream": false
  }' -o response.json复制

使用与其他模型相同的账号池、代理和任务记录。模型目录已由 Adobe 返回为启用状态；实际生成仍取决于账号权限、地区和额度。此处接入生成模型，视频编辑与扩展模型尚未开放。

成功响应中的成品字段

HTTP 200；以下仅展示用于读取视频的字段。请使用实际响应中的完整 URL。

{
  "video_url": "http://127.0.0.1:6001/generated/example.mp4",
  "url": "http://127.0.0.1:6001/generated/example.mp4",
  "media": {
    "url": "http://127.0.0.1:6001/generated/example.mp4",
    "mime_type": "video/mp4"
  }
}复制

下载视频

VIDEO_URL=$(python3 -c 'import json; print(json.load(open("response.json"))["video_url"])')
curl --fail --location "$VIDEO_URL" --output video.mp4复制

成品文件可能受存储清理策略影响，请及时保存。本接口没有返回可用于 /v1/videos/{id} 查询的任务句柄。

图生视频在 user 消息中加入 image_url。替换示例图片地址为服务端能访问的图片 URL，也可以传 data URL。不同模型的图片数量和用途不同；下面使用一张首帧图。

curl --fail-with-body --max-time 900 "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $ADOBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firefly-veo31-fast-4s-16x9-720p",
    "messages": [{"role": "user", "content": [
      {"type": "text", "text": "保持主体，镜头缓慢推近"},
      {"type": "image_url", "image_url": {"url": "https://example.com/replace-with-reference.jpg"}}
    ]}],
    "generate_audio": false,
    "stream": false
  }'复制

专用图像 API

需要生成图片时，使用图像模型调用 /v1/images/generations；视频模型不适用于这个路径。

curl --fail-with-body --max-time 900 "$BASE_URL/v1/images/generations" \
  -H "Authorization: Bearer $ADOBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"firefly-image4-ultra","prompt":"清晨山谷，写实电影质感"}'复制

先安装 requests，并设置前面的 BASE_URL 和 ADOBE_API_KEY 环境变量。示例只提交一次；超时后请先检查请求日志，不要盲目循环重试。

import os
from pathlib import Path
import requests

base = os.environ["BASE_URL"].rstrip("/")
headers = {"Authorization": "Bearer " + os.environ["ADOBE_API_KEY"]}
response = requests.post(
    base + "/v1/chat/completions",
    headers=headers,
    json={
        "model": "firefly-veo31-fast-4s-16x9-720p",
        "messages": [{"role": "user", "content": "一只猫在窗边看雨，镜头缓慢推近"}],
        "generate_audio": False,
        "stream": False,
    },
    timeout=(15, 900),
)
response.raise_for_status()
video_url = response.json()["video_url"]
with requests.get(video_url, stream=True, timeout=(15, 120)) as video:
    video.raise_for_status()
    with Path("video.mp4").open("wb") as output:
        for chunk in video.iter_content(1024 * 1024):
            output.write(chunk)
print("已保存 video.mp4")复制

/video 工作台是本地生成 API 的异步调用界面。服务端实际调用 POST /v1/chat/completions，与程序调用共用模型处理、账号池调度、额度检查、代理线路、生成轮询、成品存储和请求日志。工作台只额外保留异步任务及提交去重；API Key 保留在服务端，页面使用管理员会话。

1. 登录并获取模型

将管理员登录信息写入本机权限受限的 admin-login.json：{"username":"你的管理员账号","password":"你的管理员密码"}。Cookie 文件同样应妥善保存。

umask 077
curl --fail-with-body "$BASE_URL/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  --data-binary @admin-login.json -c adobe-session.cookies

curl --fail-with-body "$BASE_URL/local-video/models" \
  -b adobe-session.cookies复制

2. 创建任务

id 为 ui- 加 UUID；account 省略或设为 auto；提示词长度 1–2000 字符。model 使用完整模型 ID，画幅、分辨率、时长必须与其匹配。默认仍为 Veo 3.1 Fast、4 秒、16:9、720p、无音频。

python3 - > local-video-request.json <<'PY'
import json, uuid
print(json.dumps({
    "id": "ui-" + str(uuid.uuid4()),
    "account": "auto",
    "model": "firefly-veo31-fast-4s-16x9-720p",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 4,
    "generate_audio": False,
    "prompt": "一只猫在窗边看雨，镜头缓慢推近"
}, ensure_ascii=False))
PY

curl --fail-with-body "$BASE_URL/local-video/jobs" \
  -b adobe-session.cookies -H "Content-Type: application/json" \
  --data-binary @local-video-request.json复制

3. 查询与下载

每 4 秒左右读取任务列表。仅在对应任务的 status 为 completed 且有 result_url 时下载。

curl --fail-with-body "$BASE_URL/local-video/jobs" \
  -b adobe-session.cookies

# 确认任务 completed 后执行：
JOB_ID=$(python3 -c 'import json; print(json.load(open("local-video-request.json"))["id"])')
curl --fail --location "$BASE_URL/local-video/jobs/$JOB_ID/content" \
  -b adobe-session.cookies --output video.mp4复制

同步生成错误通常在 error.message / error.type / error.code；部分鉴权、校验及工作台错误在 detail。

使用服务 API Key 读取视频账号池容量；提交节奏可通过 GET /api/v1/video-submit-status 查看。

curl --fail-with-body "$BASE_URL/api/v1/video-pool-capacity" \
  -H "Authorization: Bearer $ADOBE_API_KEY"复制

操作前可在号池监控检查账号状态，在管理设置 → 请求日志核查同步生成结果。文档浏览、复制示例不会自动提交生成。