Flow · Veo 3.1 视频

当前对外提供两个视频别名：flow-veo-3-1（标准）与 flow-veo-3-1-fast（Fast）。两者均为异步任务，固定按次计费；失败任务不计费。

视频走 OpenAI 兼容接口 /v1/videos（提交→轮询→下载）。请求中的视频参数会透传；只有下文标注“已验证”的组合才属于当前接入承诺。

接口信息

当前公开模型与价格

价格是固定任务价，不是按秒价。即使传入 seconds，本组仍只扣一次对应模型的价格。

请求参数（当前接入范围）

图片数量边界（已实测）：单图首帧为 1 张；首尾帧为固定 2 张；多图参考使用 images，最多 3 张。传入第 4 张会在任务执行阶段返回 INVALID_ARGUMENT。首尾帧请求不要再混入 images。

示例 1：文生视频（最低已验证参数）

BASE_URL="https://newapi-2.oairegbox.cc"
TOKEN="sk-你的Flow令牌"

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flow-veo-3-1",
    "prompt": "一只橘猫在窗边抬头，阳光缓慢移动，固定机位，电影感",
    "seconds": "4",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Fast 版只需把 model 改为 flow-veo-3-1-fast。提交成功会返回 task_id。

示例 2：单图生视频（I2V / 首帧）

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flow-veo-3-1-fast",
    "prompt": "保持人物外观和服装一致，让人物自然回头并向镜头走来",
    "seconds": "4",
    "resolution": "720p",
    "image_url": "https://cdn.example.com/start.jpg"
  }'

也可以把 image_url 的值换成 data:image/jpeg;base64,...。图片必须能被服务端读取，不能使用需要登录的网页地址。

示例 3：首尾帧过渡（固定两张图）

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flow-veo-3-1",
    "prompt": "镜头从室内平滑移动到阳台，人物动作和光线自然衔接",
    "seconds": "4",
    "resolution": "720p",
    "first_image_url": "https://cdn.example.com/first.jpg",
    "last_image_url": "https://cdn.example.com/last.jpg"
  }'

首尾帧也支持 base64。first_image_url 与 last_image_url 必须成对；不要同时再传 images 或其他参考图数组。

示例 4：多图参考（最多 3 张）

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flow-veo-3-1-fast",
    "prompt": "把图 1 的人物置于图 2 的场景，参考图 3 的光线风格，镜头缓慢推进",
    "seconds": "4",
    "resolution": "720p",
    "images": [
      "https://cdn.example.com/character.jpg",
      "https://cdn.example.com/scene.jpg",
      "https://cdn.example.com/style.jpg"
    ]
  }'

images 最多 3 张，数组顺序就是参考图顺序。需要免图床时，把每一个 URL 换成各自的 data:image/jpeg;base64,... 即可。

图片上传格式

当前公开契约是 JSON + URL / data URI。本地图片先转成 data URI，再放入 image_url、first_image_url、last_image_url 或 images 数组：

IMAGE_B64=$(base64 < ./start.jpg | tr -d '\n')
curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"flow-veo-3-1-fast\",
    \"prompt\": \"让图片中的主体自然运动\",
    \"seconds\": \"4\",
    \"resolution\": \"720p\",
    \"image_url\": \"data:image/jpeg;base64,$IMAGE_B64\"
  }"

input_reference、image_reference 和 multipart 文件字段目前实测返回 HTTP 403，不属于这两个公开别名的可用上传方式。请使用 JSON 中的 URL 或 data URI。

轮询、取 URL 与下载

TASK_ID="task_xxx"

# 单次查询
curl -sS "$BASE_URL/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN" | jq .

# shell 轮询示例（每 5 秒一次）
while :; do
  BODY=$(curl -fsS "$BASE_URL/v1/videos/$TASK_ID" \
    -H "Authorization: Bearer $TOKEN") || exit 1
  STATUS=$(printf '%s' "$BODY" | jq -r '.status // "unknown"')
  echo "status=$STATUS"
  case "$STATUS" in
    completed|success|succeeded) break ;;
    failed|error) printf '%s\n' "$BODY" | jq .; exit 1 ;;
  esac
  sleep 5
done

VIDEO_URL=$(printf '%s' "$BODY" | jq -r '.video_url // .data[0].url // empty')
test -n "$VIDEO_URL" || { echo "completed but no video_url" >&2; exit 1; }
curl -fL "$VIDEO_URL" -o flow-veo-result.mp4

完成任务通常会返回顶层 video_url；客户端应同时兼容 data[0].url。返回的下载地址是临时地址，请及时转存，不要把地址写死到业务配置。

返回与错误处理

// 提交
{ "task_id": "task_xxx", "status": "queued", "progress": 0 }

// 轮询完成
{ "task_id": "task_xxx", "status": "completed", "progress": 100,
  "video_url": "https://sd.oaibox.xyz/d/dl/video/20260813/example.mp4" }

// 失败
{ "task_id": "task_xxx", "status": "failed",
  "error": { "code": "...", "message": "..." } }

• queued / in_progress：继续轮询，不要重复 POST。
• completed：优先下载 video_url。若立刻请求 /content 得到 409 video_not_ready，继续查询一次任务后再下载返回的 URL。
• failed：本次任务不计费；修改提示词、图片或参数后再提交。
• 生成结果的实际时长、宽高可能与请求的 seconds、resolution、aspect_ratio 不完全相同，必须以完成任务和媒体探测结果为准。

接入建议与限制

• 当前最低已验收组合：seconds="4" + resolution="720p"。一次实测请求虽传入 4 秒和横屏意图，成片被归一化为 8 秒、720×1280；这不是客户端可以依赖的固定输出规格。
• 单图 I2V 使用 1 张图；首尾帧使用固定 2 张图；多图参考使用 images，最多 3 张。第 4 张会导致任务失败。
• 图片建议使用 JPEG/PNG/WebP，公网 HTTPS 或 data URI；请控制文件大小并确保图片没有登录、Referer 或临时 Cookie 依赖。
• 提示词中写清楚“图 1 是谁 / 做什么”“首帧到尾帧如何过渡”，比堆叠大量素材更稳定。
• 示例中的令牌、图片 URL 和任务 ID 都是占位符；不要把真实令牌提交到前端代码或公开仓库。

Gemini 高速文本模型

高速分组的文本模型使用独立 -fast 名称，与 Official 分组的官方标准模型名和价格完全隔离。

模型

接口

curl https://newapi-2.oairegbox.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash-fast",
    "messages": [{"role":"user","content":"你好"}]
  }'

高速令牌请使用上表带 -fast 后缀的模型名称。

反重力 Antigravity（Claude + Gemini 图文）

基于 Google Antigravity 免费额度的独立分组，提供 Claude（Opus / Sonnet 4.6）+ Gemini 文本 + 原生 4K 出图。标准 OpenAI 兼容接口，支持 function call。令牌分组 gemini-anti。

模型与价格

以上为 gemini-anti 分组卖价（已含分组倍率）。实际以模型广场为准。

接口信息

示例：Claude 对话

curl https://newapi.oairegbox.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role":"user","content":"用一句话解释量子纠缠"}]
  }'

示例：4K 出图

图像通过对话接口返回，结果在 choices[0].message.images[].image_url.url（data:image/jpeg;base64）。强制输出 4K（5632×3072）。

curl https://newapi.oairegbox.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-4k",
    "messages": [{"role":"user","content":"一只戴宇航头盔的柴犬，电影级布光"}]
  }'

示例：Function Call

curl https://newapi.oairegbox.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role":"user","content":"北京天气如何"}],
    "tools": [{"type":"function","function":{
      "name":"get_weather",
      "parameters":{"type":"object","properties":{"city":{"type":"string"}}}
    }}]
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(api_key="sk-xxx", base_url="https://newapi.oairegbox.cc/v1")
resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

注意事项

• 令牌需在 gemini-anti 分组下
• gemini-3.1-flash-image-4k 固定输出 4K，按次计费（¥0.112/张），失败不计费
• Claude 与 Gemini 均走同一 /v1/chat/completions，切换 model 即可

官方 Key（Google AI Studio 原生模型）

直连 Google AI Studio 的官方标准模型，模型名与官方完全一致。令牌分组 gemini-official。文本 / 图像走 /v1/chat/completions；音乐为异步按次任务。价格 = 官方价 × 分组倍率。

文本模型（按 token）

图像模型

按 token 的图像模型，生成图像本身计入输出 token（故输出单价看似高）。

音乐（异步按次）

接口信息

示例：官方文本

curl https://newapi.oairegbox.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-pro",
    "messages": [{"role":"user","content":"你好"}]
  }'

示例：官方出图

curl https://newapi.oairegbox.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image",
    "messages": [{"role":"user","content":"赛博朋克风格的城市夜景"}]
  }'

示例：官方音乐（lyria，异步任务）

curl -X POST https://newapi.oairegbox.cc/v1/videos \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "lyria-3-pro-preview",
    "prompt": "轻快的钢琴爵士，适合咖啡馆"
  }'
# 轮询取片同上（GET /v1/videos/{task_id}）

注意事项

• 令牌需在 gemini-official 分组下
• 模型名与 Google 官方一致，价格 = 官方价 × 分组倍率（当前 1.6）
• 音乐（lyria）为异步按次任务，提交与轮询方式见「Omni 视频生成」板块
• 图像模型部分按 token、部分按次，见上表

Veo-Clean 去水印

上传带水印的视频，系统自动去除水印后返回。异步任务流程与视频生成一致。

模型与价格

按视频实际时长计费。例如 10 秒视频 = ¥0.20。失败不计费。

参数

示例

# Multipart 上传
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" \
  -F "model=veo-clean" \
  -F "prompt=remove watermark" \
  -F "input_video=@watermarked.mp4"

# 轮询取片（同其他视频模型）
curl https://YOUR_BASE/v1/videos/{task_id} \
  -H "Authorization: Bearer sk-xxx"

注意事项

• 仅支持 multipart/form-data 提交（需上传视频文件）
• 视频文件大小限制 20MB
• 处理时间通常 20-60 秒（取决于视频长度）
• 不涉及 Gemini 视频生成，不消耗生成配额

Adobe Firefly · Veo 3.1

Adobe Firefly 视频生成现已提供 Veo 3.1 标准版、Veo 3.1 Fast（静音档，无音频）与 Veo 3.1 Fast Direct（含音频）。两者均使用 OpenAI 兼容的异步视频接口：提交任务后轮询，完成时从响应中的 video_url 获取成片。

本页仅列出当前已验收并已开放的 VEO 模型。Sora 2 尚未开放；请勿以模型名或参数猜测方式调用未列出的模型。

模型

⚠️ 音频说明（重要）：firefly-veo-3.1-fast 是无音频的静音档，成片不含任何音频轨。如需带音频，请改用 firefly-veo-3.1-fast-direct（同为 Fast、含音频）或 firefly-veo-3.1 标准版（含音频）。

实际计费、模型可见性和可用额度以控制台模型列表及你的 API 令牌权限为准。

接口信息

参数

size 支持两种传法：① 像素尺寸（如 1280x720），画幅与清晰度自动识别，无需 video_resolution；② 官网式纵横比（16:9/9:16）+ 必填 video_resolution（720p/1080p），对齐 Adobe 官网“画幅 + 分辨率”两栏。两套输出完全一致。音频区分：firefly-veo-3.1（标准版）与 firefly-veo-3.1-fast-direct 默认含音频；而 firefly-veo-3.1-fast 为静音档、无音频轨。

size 取值与输出

官网式取值（size 纵横比 + video_resolution）

示例：提交 6 秒 Fast 视频

BASE_URL="https://newapi-2.oairegbox.cc"
TOKEN="sk-xxx"

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firefly-veo-3.1-fast",
    "prompt": "日出时一盏彩色纸灯笼缓缓飘过安静的湖面，水面泛起微光，电影感镜头，无文字无标志。",
    "seconds": "6",
    "size": "1280x720"
  }'

示例：官网式参数（纵横比 + 分辨率）

与像素式输出完全一致，区别只是把画幅和清晰度拆成 size（纵横比）+ video_resolution 两栏，对齐 Adobe 官网 UI。size 传纵横比时 video_resolution 必填。

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firefly-veo-3.1-fast",
    "prompt": "日出时一盏彩色纸灯笼缓缓飘过安静的湖面，水面泛起微光，电影感镜头，无文字无标志。",
    "seconds": "6",
    "size": "16:9",
    "video_resolution": "720p"
  }'

示例：图生视频（带参考图 input_reference）

在文生的基础上，用 multipart 表单额外带一张参考图作为首帧，其余参数（seconds、size）一致。input_reference 支持本地文件、图片 URL 或 base64 三种传法。

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-veo-3.1' \
  -F 'prompt=让画面里的主体自然动起来，镜头缓慢向前推进，保持构图。' \
  -F 'seconds=6' \
  -F 'size=1280x720' \
  -F 'input_reference=@frame.jpg;type=image/jpeg'

用图片 URL：把最后一行换成 -F 'input_reference=https://your-cdn.com/frame.jpg'；用 base64：换成 -F 'input_reference=data:image/jpeg;base64,<...>'。提交后与文生一样轮询 GET /v1/videos/{task_id}，完成后取顶层 video_url。

首尾帧（First / Last Frame）

用 first_frame（起始帧）和 last_frame（结束帧）两张图，引导 Veo 从首帧画面过渡到尾帧画面。两个字段都支持图片 URL、base64（data:image/...;base64,）或 multipart 文件。只传 first_frame 等同于用首帧做图生视频（与上面的 input_reference 首帧一致）。首尾帧模式与下方“多参考图”模式互斥，不能同一请求混用（Adobe 官方规则，混传会在生成前返回 400、不计费）。

⚠️ Veo 的首尾帧按两张参考图处理（首帧、尾帧各作为一个参考引导），过渡的具体表现由模型把控、未必是逐帧线性插值，实际以成片为准。参考图请用真实、合规的照片（勿用随机占位图 / 纯色图；含可识别真人面孔可能触发内容策略）。

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firefly-veo-3.1",
    "prompt": "镜头从清晨薄雾笼罩的湖面缓缓推进，雾气逐渐散去，远处倒影渐渐清晰",
    "seconds": "8",
    "size": "16:9",
    "video_resolution": "720p",
    "first_frame": "https://your-cdn.com/first.jpg",
    "last_frame":  "https://your-cdn.com/last.jpg"
  }'

首尾帧也可走 multipart 文件：改成 -F 'model=firefly-veo-3.1' -F 'first_frame=@first.jpg;type=image/jpeg' -F 'last_frame=@last.jpg;type=image/jpeg'（prompt/seconds/size 同样用 -F 传）。

多参考图（Reference Images）

用 reference_images 传入多张参考图，引导角色、风格与构图。Veo 取用前若干张作参考（标准版 firefly-veo-3.1 最多 3 张、Fast 版最多 2 张），支持图片 URL、base64 或 multipart（重复字段名传多张）。与首尾帧模式互斥：同一请求不能同时传 first_frame/last_frame，混传在生成前返回 400、不计费。

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-veo-3.1' \
  -F 'prompt=保持这几张参考图的人物形象与画面风格，让主体自然动起来' \
  -F 'seconds=6' \
  -F 'size=1280x720' \
  -F 'reference_images=@char.jpg;type=image/jpeg' \
  -F 'reference_images=@style.jpg;type=image/jpeg'

参考图须为真实合规照片；超量或与首尾帧字段混用会在生成前返回 400（不扣积分）。

成功提交会返回异步任务，例如：

{
  "id": "task_xxx",
  "status": "queued",
  "model": "firefly-veo-3.1-fast",
  "progress": 0
}

示例：轮询并获取成片

curl -sS "$BASE_URL/v1/videos/task_xxx" \
  -H "Authorization: Bearer $TOKEN"

当响应中的 status 为 completed 时，读取 video_url：

{
  "id": "task_xxx",
  "status": "completed",
  "model": "firefly-veo-3.1-fast",
  "video_url": "https://..."
}

video_url 是短期签名下载地址，请在有效期内下载或转存。当前请直接使用完成任务返回的 video_url，不要依赖 /v1/videos/{task_id}/content。

常见问题

• 提交成功但还没有视频：继续查询同一个任务 ID，直到状态变为 completed 或 failed。
• 模型不可见或返回权限错误：确认 API 令牌已开通 Firefly VEO 模型权限。
• 任务失败：保留任务 ID 与错误响应，提交给技术支持排查；不要为同一任务并发重复提交。

Adobe Firefly · Seedance 2.0

Adobe Firefly 的 Seedance 2.0 与 Seedance 2.0 Fast 视频模型。支持文生视频与单图生视频，使用 OpenAI 兼容的异步视频接口：提交任务后轮询，完成时读取 video_url 获取成片。四档均原生自带音频（对白 / 音效 / 环境音同步生成），无需额外参数。

本页仅适用于 firefly 分组的 Adobe Firefly Seedance 模型；与导航中另一套 Seedance 服务是独立通道、独立模型和独立素材协议，不能混用模型名或多图参数。

模型与价格

视频默认带音频（AAC 音轨）：Seedance 2.0 是 Adobe 官方原生音频模型，一次生成即同步产出对白 / 音效 / 环境音；四档（标准 / Fast × 480p / 720p）全部自带音频，无需额外参数、也不额外计费。

模型名已固定输出分辨率；video_resolution 只能填写与所选模型一致的值，不能用 480p SKU 请求 720p 输出。

已支持规格

单图生视频（I2V）

提交一张首帧参考图即可启用图生视频；不带图片则为文生视频。input_reference 为单张首帧图。若需首尾帧或多图 / 视频 / 音频参考，见下方“首尾帧”“全能参考（Omni）”两节。可上传 JPEG/JPG、PNG、WebP。服务会按目标画幅进行居中裁切、缩放并转为 PNG 后提交；建议先按目标画幅准备主体清晰的图片，以免裁掉重要内容。

示例：文生视频

BASE_URL="https://newapi-2.oairegbox.cc"
TOKEN="sk-xxx"

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firefly-Seedance-2.0-fast-480p",
    "prompt": "一盏纸灯笼在夜色湖面上缓缓漂过，水面反射暖色灯光，电影感镜头。",
    "seconds": 5,
    "video_resolution": "480p",
    "size": "854x480"
  }'

示例：单图生视频

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-Seedance-2.0-fast-480p' \
  -F 'prompt=让画面中的山间云雾缓慢流动，镜头轻微向前推进。' \
  -F 'seconds=5' \
  -F 'video_resolution=480p' \
  -F 'size=854x480' \
  -F 'input_reference=@frame.jpg;type=image/jpeg'

参考图含真人脸 · image_style 风格化（可选）

先分清你要哪种结果，再决定用不用这个参数：

• 要真人输出（真人参考 → 生成的仍是真人）：不要用 image_style。请改用三视图 / 多角度参考的方式——把同一人物的正面、侧面、背面等多张清晰照片作为多图参考传入（见下方“全能参考（Omni）”的仅多图参考示例），既能提高“真人脸”过审率，又能保持真人形象。
• 要漫剧 / 动漫角色脸型（真人参考 → 生成动漫角色）：传可选参数 image_style=anime。网关会在提交 Adobe 前把你的真人参考图整图风格化（动漫化），从而通过 Adobe 的“真人脸”内容审核，产出漫剧风格的角色视频。

一句话：真人要真人 → 用三视图多图参考，别传 image_style；真人要漫剧脸 → 传 image_style=anime。不传该参数时行为完全不变（原图直发），主动权在你。

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-Seedance-2.0-fast-480p' \
  -F 'prompt=参考图中的人物，转成漫剧角色在城市街头行走，日系动漫画风' \
  -F 'seconds=5' \
  -F 'video_resolution=480p' \
  -F 'size=854x480' \
  -F 'input_reference=@person.jpg;type=image/jpeg' \
  -F 'image_style=anime'

参考图门过了之后，Adobe 输出侧的内容 / 版权审核仍是概率性的，个别任务可能要重试 1–2 次才出片；失败不计费。想保留真人、不要漫剧脸时，用上面“三视图多图参考”的做法，别传 image_style。

首尾帧（First / Last Frame）

提供起始帧和结束帧图片，Seedance 生成从首帧平滑过渡到尾帧的视频。用 first_frame、last_frame 两个字段，支持 multipart 文件、图片 URL 或 base64（data:image/...;base64,）。只传 first_frame 即为单首帧动画。首尾帧模式与下方“全能参考”模式互斥，不能同一请求混用（Adobe 官方规则）。

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-Seedance-2.0-fast-480p' \
  -F 'prompt=镜头从第一张画面平滑过渡到第二张画面，电影感运镜' \
  -F 'seconds=5' \
  -F 'size=854x480' \
  -F 'first_frame=@first.jpg;type=image/jpeg' \
  -F 'last_frame=@last.jpg;type=image/jpeg'

全能参考（Omni · 图 / 视频 / 音频）

Seedance 2.0 的核心能力：一次最多提供 9 张图 + 3 段视频 + 3 段音频（总计 ≤ 9 个参考资产）作为风格、角色、构图、运镜、音效的引导。用 reference_images、reference_videos、reference_audios 传入，可在 prompt 里用文字说明各参考的作用。参考视频引导运动与氛围（不是直接动画化）。与首尾帧模式互斥。

三类合计 ≤ 9 个；多值用重复字段名传（如 -F 'reference_images=@a.jpg' -F 'reference_images=@b.jpg'）。超量、超大、或与首尾帧字段混用会返回 400（生成前拦截，不扣积分）。

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-Seedance-2.0-fast-480p' \
  -F 'prompt=参考图片的色调、视频的运镜、音频的节奏，生成一段电影感镜头' \
  -F 'seconds=5' \
  -F 'size=854x480' \
  -F 'reference_images=@style.jpg;type=image/jpeg' \
  -F 'reference_videos=@motion.mp4;type=video/mp4' \
  -F 'reference_audios=@beat.mp3;type=audio/mpeg'

更多参考用法示例

① 仅多图参考（角色/风格一致性，最多 9 张，重复字段名传多张）：

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-Seedance-2.0-fast-480p' \
  -F 'prompt=保持这几张参考图的人物形象与画面风格，让主体自然走动' \
  -F 'seconds=6' \
  -F 'size=854x480' \
  -F 'reference_images=@char1.jpg;type=image/jpeg' \
  -F 'reference_images=@char2.jpg;type=image/jpeg' \
  -F 'reference_images=@style.jpg;type=image/jpeg'

② 图 + 参考视频（用视频引导运镜/氛围，不直接动画化）：

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-Seedance-2.0-fast-720p' \
  -F 'prompt=参考图片的主体，沿用参考视频的镜头运动方式生成' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'reference_images=@subject.jpg;type=image/jpeg' \
  -F 'reference_videos=@camera-move.mp4;type=video/mp4'

③ 图 + 参考音频（用音频引导节奏/情绪）：

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-Seedance-2.0-fast-480p' \
  -F 'prompt=参考图片的场景，随音乐的舒缓节奏缓慢运镜' \
  -F 'seconds=8' \
  -F 'size=854x480' \
  -F 'reference_images=@scene.jpg;type=image/jpeg' \
  -F 'reference_audios=@music.mp3;type=audio/mpeg'

④ 仅首帧动画（只给起始帧，让静图动起来）：

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-Seedance-2.0-fast-480p' \
  -F 'prompt=让画面中的云雾缓慢流动，镜头轻微向前推进' \
  -F 'seconds=5' \
  -F 'size=854x480' \
  -F 'first_frame=@start.jpg;type=image/jpeg'

⑤ 标准版 720p + 图片 URL（JSON）——参考图支持公网 URL / base64；视频、音频仅支持 multipart 文件或 base64（不接受 URL）：

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firefly-Seedance-2.0-720p",
    "prompt": "参考这张图的色调，生成一段唯美空镜",
    "seconds": 8,
    "size": "1280x720",
    "reference_images": ["https://example.com/ref1.jpg", "https://example.com/ref2.jpg"]
  }'

轮询结果

curl -sS "$BASE_URL/v1/videos/task_xxx" \
  -H "Authorization: Bearer $TOKEN"

任务状态依次为 queued、in_progress、completed 或 failed。当状态为 completed 时，读取响应中的 video_url；建议每 5-10 秒轮询一次，不要为同一请求并发重复提交。

Adobe Firefly · Kling 3.0

Adobe Firefly 的 Kling 3.0 与 Kling 3.0 Omni 视频模型。支持文生视频、图生视频（首帧参考图）与 Omni 多主体参考（@元素，单次最多 3 个），使用 OpenAI 兼容的异步视频接口：提交任务后轮询，完成时读取顶层 video_url 获取成片。

模型名区分大小写（Kling 首字母大写、Omni 首字母大写），请严格按下表填写，否则会报 model_not_found。

模型与价格 · 按秒计费

按秒计费 = 单价 × 时长。例如 Kling 3.0 720p 10 秒 = ¥0.45。失败不计费。

视频默认带音频（AAC 音轨）：Kling 3.0 标准与 Omni 均自带生成音效，无需额外参数。

接口信息

参数（参考 Adobe 官方）

Adobe 官方 Kling 支持三种画幅：16:9（横）/ 1:1（方）/ 9:16（竖）；也可用 aspect_ratio 传 16:9 / 1:1 / 9:16。

示例：文生视频

BASE_URL="https://newapi-2.oairegbox.cc"
TOKEN="sk-xxx"

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firefly-Kling-3.0-720p",
    "prompt": "一只雄鹰在金色夕阳下掠过雪山之巅，电影感镜头，缓慢推进。",
    "seconds": "5",
    "size": "1280x720"
  }'

示例：图生视频（首帧参考图 input_reference）

用 multipart 表单带一张参考图作为首帧，其余参数一致。input_reference 支持本地文件、图片 URL 或 base64。

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-Kling-3.0-720p' \
  -F 'prompt=让画面中的主体自然动起来，镜头缓慢向前推进，保持构图。' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=@frame.jpg;type=image/jpeg'

用图片 URL：把最后一行换成 -F 'input_reference=https://your-cdn.com/frame.jpg'；用 base64：换成 -F 'input_reference=data:image/jpeg;base64,<...>'。

示例：Omni 多主体参考（@元素，最多 3 个）

Kling 3.0 Omni 支持把参考图作为命名“元素”（主体/角色/物体/场景），在 prompt 中用 @元素名 引用，让生成画面保持该主体的一致性。单个视频请求最多引用 3 个元素（第 4 个起会被上游拒绝：reference_elements: List should have at most 3 items）。分两步：

第 1 步：创建元素（POST /v1/entities）

每个元素用 1~4 张参考图构建（建议 4 张不同角度，效果更稳）。type 取 character（角色）/ object（物体）/ location（场景）。

curl -sS -X POST "$BASE_URL/v1/entities" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Alice",
    "type": "character",
    "images": [
      "https://your-cdn.com/alice_front.jpg",
      "https://your-cdn.com/alice_side.jpg"
    ]
  }'

图片可传图片 URL或 base64（data:image/...;base64,）；每个元素 1~4 张。可重复调用创建多个元素（如 Alice、Bob、Cafe）。用 GET /v1/entities 查看已建元素，DELETE /v1/entities/{id} 删除。

第 2 步：生成时用 @元素名 引用（最多 3 个）

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firefly-Kling-3.0-Omni-720p",
    "prompt": "@Alice 和 @Bob 在 @Cafe 里相视而笑，暖色灯光，电影感镜头。",
    "seconds": "5",
    "size": "1280x720"
  }'

上限：单次最多 3 个 @元素（本网关经 Adobe Firefly，硬上限为 3；超过报 reference_elements: at most 3 items）。被引用的元素须已通过第 1 步创建；同一请求引用的多个元素需属于同一账号（网关自动路由，无需手动指定）。此功能仅 firefly-Kling-3.0-Omni-720p / firefly-Kling-3.0-Omni-1080p 支持。

示例：轮询并获取成片

curl -sS "$BASE_URL/v1/videos/task_xxx" \
  -H "Authorization: Bearer $TOKEN"

当响应中的 status 为 completed 时，读取顶层 video_url（短期签名下载地址，请在有效期内下载或转存）。

常见问题

• model_not_found：检查大小写，必须是 firefly-Kling-3.0-720p / firefly-Kling-3.0-Omni-1080p 等（Kling/Omni 首字母大写）。
• 时长不支持：标准版与 Omni 均支持 5–15 秒任意整数。
• 任务失败：保留任务 ID 与错误响应交技术支持；不要为同一任务并发重复提交。

Adobe Firefly · Gemini Omni Flash

Google Gemini Omni Flash 视频模型，经 Adobe Firefly 接入。同一个模型名支持三种模式，按你传入的素材自动切换：只传 prompt = 文生视频（T2V）；额外带一张参考图 = 图生视频（I2V）；额外带一段参考视频 = 视频生视频（V2V）。OpenAI 兼容异步接口：提交任务后轮询，完成时从响应顶层 video_url 获取成片。

成片无音频（静音输出）。三种模式的规格、时长档、计费完全一致。

模型与价格

按秒计费，三种模式同价：4 秒 ¥0.80、6 秒 ¥1.20、8 秒 ¥1.60、10 秒 ¥2.00。实际计费、模型可见性与可用额度以控制台模型列表及你的 API 令牌权限为准。

接口信息

参数

模式互斥优先级：同时传图和视频时按 视频生视频 处理。input_reference（图）与 input_video（视频）都是可选，都不传即为文生视频。

size 取值与输出

示例一：文生视频（T2V，JSON）

BASE_URL="https://newapi-2.oairegbox.cc"
TOKEN="sk-xxx"

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firefly-gemini-omni-720p",
    "prompt": "日出时一只金毛小狗在草地上奔跑，柔和晨光，电影感镜头。",
    "seconds": "4",
    "size": "1280x720"
  }'

示例二：图生视频（I2V，带参考图 input_reference）

在文生的基础上，用 multipart 表单额外带一张参考图作为首帧，其余参数（seconds、size）一致。input_reference 支持本地文件、图片 URL 或 base64 三种传法。

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-gemini-omni-720p' \
  -F 'prompt=让画面里的小狗自然转头看向镜头并摇尾巴，镜头缓慢推进。' \
  -F 'seconds=4' \
  -F 'size=1280x720' \
  -F 'input_reference=@frame.jpg;type=image/jpeg'

用图片 URL：把最后一行换成 -F 'input_reference=https://your-cdn.com/frame.jpg'；用 base64：换成 -F 'input_reference=data:image/jpeg;base64,<...>'。

示例三：视频生视频（V2V，带参考视频 input_video）

用 multipart 表单带一段参考视频，模型在其基础上按 prompt 重新演绎（改风格、加动作等）。input_video 仅支持本地文件（@clip.mp4）或 base64，不支持纯 http URL。

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F 'model=firefly-gemini-omni-720p' \
  -F 'prompt=把这段片子改成水彩画风格，保留原有的运动。' \
  -F 'seconds=4' \
  -F 'size=1280x720' \
  -F 'input_video=@clip.mp4;type=video/mp4'

用 base64：把最后一行换成 -F 'input_video=data:video/mp4;base64,<...>'。

示例四：轮询并获取成片

三种模式提交后都返回异步任务，轮询方式一致：

curl -sS "$BASE_URL/v1/videos/task_xxx" \
  -H "Authorization: Bearer $TOKEN"

当响应中的 status 为 completed 时，读取顶层 video_url：

{
  "id": "task_xxx",
  "status": "completed",
  "model": "firefly-gemini-omni-720p",
  "video_url": "https://..."
}

video_url 是短期签名下载地址，请在有效期内下载或转存。当前请直接使用完成任务返回的 video_url，不要依赖 /v1/videos/{task_id}/content。

注意事项

• 时长仅四档：seconds 只接受 4/6/8/10，其它值会报错。
• V2V 视频来源：input_video 只收 multipart 文件或 base64 data URL，不会下载 http 链接；传 http 链接会被忽略、退化为文生。
• I2V 参考图：首发支持单张参考图作首帧。
• 无音频：成片为静音输出，不含音频轨。
• 模型权限：确认 API 令牌已开通 Firefly 分组权限；任务失败请保留任务 ID 与错误响应交技术支持，勿对同一任务并发重复提交。

Adobe Firefly · GPT Image 2

Adobe Firefly 的 GPT Image 2 文生图模型，三档质量（Low / Medium / High）。使用 OpenAI 兼容的异步接口：提交任务后轮询，完成时读取 video_url 获取图片（PNG）。

本页为 firefly 分组的 Adobe Firefly GPT Image 2，与导航中 gpt-fast 分组的 GPT-Image-2 是独立通道、独立上游，模型名不同、不能混用。

模型与价格

三档像素名副其实：1k 最长边 ~1024px、2k ~2048px、4k 顶到 3840px。近方形画幅的 4k 受 Adobe 8.29M 总像素硬限——1:1 最高只到 2880×2880、5:4/4:3/3:2 约 3200-3500，只有宽幅（16:9 / 9:16 / 21:9）能满 3840。auto 档不承诺具体像素（Adobe 自选）。

三档实际输出像素

画幅

通过 aspect_ratio（或 size）选画幅，支持：auto、1:1、16:9、9:16、5:4、4:3、3:2、4:5、3:4、2:3、21:9。不传默认 1:1。

参数

示例

# 提交任务
curl https://newapi-2.oairegbox.cc/v1/videos \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"model":"firefly-gpt-image-2k","prompt":"a cozy reading nook by a rainy window, warm lamp light","aspect_ratio":"9:16"}'
# 返回 {"id":"task_xxx","status":"queued"}

# 轮询结果
curl https://newapi-2.oairegbox.cc/v1/videos/task_xxx \
  -H "Authorization: Bearer $TOKEN"
# 完成时 {"status":"completed","video_url":"https://.../xxx.png"}

图生图（i2i · 支持多图参考）

在文生图基础上加 images 传 1–6 张参考图（图片 URL 数组），模型会把每张参考图作为主体（subject）融合进结果。价格与文生图同档，参考图张数不额外收费。

参考图最多 6 张（超出返回 400）。多图必须用数组字段 images（或 reference_images）；仅单张时也可用 input_reference（字符串）。真人脸参考图会被 Adobe 审核拒绝（确定性失败），请用合规图片。

# 图生图（images 数组，1–6 张）；轮询同文生图
curl https://newapi-2.oairegbox.cc/v1/videos \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"model":"firefly-gpt-image-1k","prompt":"blend the reference subjects into one scene","images":["https://example.com/a.jpg","https://example.com/b.jpg"]}'

Adobe Firefly · 错误码 & 审核问题归档

Adobe Firefly 的内容审核较严格，视频任务失败大多来自 Adobe 侧的内容审核或输入不合规，而非网关故障。收到失败后请先看错误类型判断能否重试：内容审核 / 参数类属确定性失败（同样输入重试必然再失败，需改输入）；账号 / 过载类属可自动恢复（网关会自动换号或重试，通常自愈）。失败不计费。

⚠️ Adobe 审核严（重点）：真人脸参考图、涉敏/名人/品牌等提示词、生成结果被判不安全、生成音频疑似版权 都会被 Adobe 拒绝。这类是确定性拒绝——同一张图 / 同一句提示词重试永远失败，必须更换输入，请勿对同一失败任务反复重试。

一、内容审核类（Adobe 拒绝 · 重试无效 · 需改输入）

参考图含真人脸的解法 · image_style 风格化（可选）

参考图真人脸是最常见的审核拒绝之一。确需用真人照片做图生视频（i2v）时，可加一个可选参数 image_style：网关会在提交 Adobe 前把你的参考图整图风格化（转成明显非真实照片的画风），从而通过 Adobe 的“真人脸”内容审核。不传 image_style 时行为完全不变（原图直发）——是否风格化的主动权在你。

作为顶层字段传（与 prompt / model / seconds 同级）。示例（multipart）：

curl https://newapi-2.oairegbox.cc/v1/videos \
  -H "Authorization: Bearer $TOKEN" \
  -F model=Seedance-2.0-fast-480p -F seconds=4 -F "size=9:16" \
  -F prompt="镜头缓缓推近，人物自然微笑" \
  -F input_reference=@person.jpg \
  -F image_style=anime

⚠️ 用前须知：① 输出会是动漫 / 绘画风（不再是写实真人），请按需使用；② 风格化能过“真人脸参考门”，但 Adobe 的输出侧审核（video_unsafe / 音频版权）仍是概率性的，个别任务可能要重试 1-2 次才出片（失败不计费）；③ 这是把真人变风格化的绕行方案，不适用需要保留写实真人的场景。

二、输入 / 参数不合规（确定性失败 · 需改请求）

三、账号 / 权限 / 配额（多为可自动恢复）

四、临时 / 基础设施（网关自动重试 · 通常自愈）

📌 排查建议：失败时请保留 任务 ID（task_xxx） 与完整错误响应再联系我们——凭任务 ID 可在后台定位到具体那一条。内容审核 / 参数类属确定性失败，请勿对同一任务反复重试（既不会成功，也占用账号请求配额）。

Seedance 2.0 视频生成

基于 Seedance 2.0 的视频生成服务。各模型调用方式完全一致，切换只需改 model 字段。支持文生视频、图生视频、多参考图（≤9）、参考视频（≤3）、参考音频（≤3）、首尾帧过渡；提供 480p / 720p / 1080p / 4K 多档清晰度。

模型与价格 · 按秒计费

Seedance2.0 各档均支持 4-15 秒任意整数时长、全部高级参考功能（@Image/@Video/@Audio 引用）。

按秒计费 = 单价 × duration。例如 Seedance-2.0-720p 8秒 = ¥5.20。失败不计费。

Pro 满血系列 · 按次固定 15 秒

Pro 满血系列采用按次计费、固定 15 秒成片，画质更强、自带 AI 生成音轨。调用方式与上表完全一致（同 /v1/videos 接口、同参数、同轮询下载流程），只需把 model 换成下表名称——无需传 duration（时长锁定 15 秒）。

按次计费：每次提交按上表固定收费，与时长无关（统一固定 15 秒成片）；暂不支持首尾帧（first_image / last_image）；失败不计费。

Seedance2.0 四种生成模式（先看这里选对模式）

无需传“模式”参数——服务端按你传入的素材字段自动判定用哪种模式。关键是按手上的素材，传对字段、传够最少必填。

✅ 全能参考 933：单次最多 9 张图 + 3 个视频 + 3 个音频混合参考；在 prompt 用 @image1…@image9 / @video1…@video3 / @audio1…@audio3 引用对应素材。音频/视频参考须至少配 1 张主图（仅传音频/视频不传图会失败）。

各模式素材数量：图生视频 1～9 张图；全能参考 1～9 图 + ≤3 视频 + ≤3 音频；首尾帧固定 2 张（首帧+尾帧），不接受额外参考图——首尾帧模式下额外传的 reference_image_urls 不会生效，要多图请用图生视频/全能参考。

常见错误（请避开）：

Seedance2.0 480p / 720p 档规格

• 输出：H.264 / 24fps，含 AAC 立体声同步音轨，无水印。720p 约 1280×720；480p 随画幅（4:3 约 752×560）。
• 下载：用查询响应里的 video_url 字段（可直接下载/嵌入的直链）。
• 画幅：支持 16:9 / 9:16 / 1:1 / 21:9 / 3:4 / 4:3 六种。
• 参考图（单张/多张统一用 reference_image_urls）：参考图一律放进 reference_image_urls 数组——单张就传 1 个元素，多张最多 9 个，无需区分单图/多图字段。三种传法任选 ——公网 http(s) 链接、data:image/...;base64, 直传（免图床）、multipart 文件上传（字段 image，-F image=@photo.jpg，免图床）。输入图要求：JPEG/PNG/WEBP，长边 ≤4000px（每边 ≥300px），宽高比 0.4–2.5，≤30MB。在 prompt 用 @image1…@image9 引用（@image1=数组第 1 张，依次类推）。
• image_url 兼容保留（可选）：旧的单张主图字段 image_url 仍可用，与「reference_image_urls 传 1 张」效果完全一致（同一服务端接口、同样画幅与计费）；推荐新接入统一只用 reference_image_urls。若两者同时传，image_url 作为第 1 张、reference_image_urls 依次其后，合计 ≤9 张。
• 参考图命名 —— 让 @人物 对上正确的图（多角色必看）：当 prompt 里用 @名字 指代某个角色/主体时，需告诉我们每张参考图对应谁，否则服务端只能按顺序猜、易出现「视频里的人物与参考图对不上/错乱」。两种传法任选：
  ① 推荐 · 对象数组：reference_images 每个元素写成 {"url":"…","name":"志强"}——名字跟着自己的图走，怎么排序都不会错位。
  ② 平行数组：reference_image_names: ["志强","清雅","张秋月"]，须与 reference_image_urls 同序、一一对应（顺序错就会绑错）。
  我们会据此在 prompt 最前自动补一句「图一为志强@志强，图二为清雅@清雅…」的绑定声明，你的 prompt 原文一个字都不用改。不传名字＝维持现状：不加任何声明，若要用 @人物 绑定，请你自己在 prompt 里写明「图一为X@X，图二为Y@Y」。
• 参考图角色 —— 标明「人物图 / 背景图」，治多图融合「背景被当人、莫名多出一张脸」：多图参考时，若某张只是场景/背景（不含要出镜的人物），给它标 role:"background"；人物主体图标 role:"subject"（或直接给 name 即视为主体）。我们会据此在 prompt 最前自动声明「图N为背景场景（仅作环境参考，不得从中生成、复制或衍生任何人物面孔）」——直接告诉模型这张是布景、别从里面长出人脸，显著降低「背景里凭空多出人/同一张脸重影/多余头」。两种传法任选：
  ① 推荐 · 对象数组：reference_images 元素写成 {"url":"…","role":"background"} 或 {"url":"…","name":"志强","role":"subject"}——角色跟着自己的图走、不会错位。
  ② 平行数组：reference_image_roles: ["subject","background"]，须与 reference_image_urls 同序一一对应。
  取值：subject（人物；别名 person/face/人物/主体…）、background（背景；别名 bg/scene/背景/场景/环境…）。不标＝维持现状（仅按通用一致性约束处理）。
• 参考视频：reference_videos（或单个 reference_video）数组，≤3 个；prompt 用 @video1… 引用。视频要求：mp4/mov、单条 2–15 秒、24–60fps、≤50MB，多条总时长 ≤15 秒。
• 参考音频：reference_audios（或单个 reference_audio / audio_url）数组，≤3 个；prompt 用 @audio1… 引用（如「背景音乐用 @audio1」）。格式 mp3（支持 wav/m4a 等）。音频须搭配 ≥1 张主图（不能只传音频）。
• 首尾帧过渡：同时给 first_image_url（首帧）和 last_image_url（尾帧），生成两帧之间的过渡视频。固定 2 张、须成对；该模式不接受额外参考图（同时传的 reference_image_urls 不生效）。
• 以上 reference_image_urls / reference_videos / reference_audios / first_image_url / last_image_url 均支持公网 URL 或 base64（如 data:audio/mpeg;base64,）。
• 提示词长度：prompt ≤ 5000 字符（含 @image1/@video1/@audio1 等引用文字）；超出会立即以 400018 失败，请精简后重试。
• 字段命名完全兼容（接过 Seedance 官方接口零调整）：参考图字段等价接受 reference_image_urls（推荐）/ reference_images / extra_images / input_reference（数组），单张可用 reference_image；参考视频等价接受 reference_videos / reference_video（推荐）/ extra_videos。任选一种命名即可，语义一致——单张参考图按图生视频处理，多张自动拆为「主图 + 参考图」。

Seedance2.0 错误返回

任务失败时（轮询返回 "status":"failed"），响应里 error 为对象 {"code","message"}（message 为完整中文说明），并冗余顶层 error_code：

# 失败响应示例
{
  "task_id": "task_xxx",
  "status": "failed",
  "video_url": null,
  "error": {
    "code": "400017",
    "message": "参考图不符合要求：需 JPEG/PNG/WEBP，长边 ≤4000px、每边 ≥300px，宽高比 0.4–2.5，且不超过 30MB，请更换后重试"
  },
  "error_code": "400017"
}

核心参数

高级参考（@Image / @Video / @Audio）

在 prompt 中用 @Image1、@Video1、@Audio1 引用对应素材（参考素材上限：图片 ≤9 / 视频 ≤3 / 音频 ≤3，俗称 933）。Seedance2.0 各档均支持多参考图（≤9）、参考视频（≤3）、参考音频（≤3）与首尾帧（字段同上，见「Seedance2.0 480p/720p 档规格」）；参考音频须搭配 ≥1 张主图。

示例

# 文生视频
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance-2.0-720p",
    "prompt": "雨夜霓虹街道，镜头缓慢推进，电影感光影",
    "aspect_ratio": "16:9",
    "duration": 8
  }'

# 多素材参考（图/视频/音频）
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance-2.0-720p",
    "prompt": "以 @Image1 的人物、@Video1 的运镜，配合 @Audio1 的节奏生成广告",
    "image_url": "https://cdn.example.com/main.jpg",
    "extra_images": ["https://cdn.example.com/ref.jpg"],
    "extra_videos": ["https://cdn.example.com/ref.mp4"],
    "extra_audios": ["https://cdn.example.com/ref.mp3"],
    "aspect_ratio": "16:9",
    "duration": 10
  }'

# 480p 经济档（文生 / 图生，带 image_url 即图生视频）
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance-2.0-fast-480p",
    "prompt": "夕阳下的海浪缓缓拍打沙滩，电影感",
    "image_url": "https://cdn.example.com/main.jpg",
    "duration": 5
  }'

# 480p 图生视频 · base64 直传（免图床，image_url 填 data URI）
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{"model":"Seedance-2.0-fast-480p","prompt":"让画面动起来","duration":5,
       "image_url":"data:image/png;base64,iVBORw0KGgo..."}'

# 480p 图生视频 · multipart 文件上传（免图床，直接传本地图）
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" \
  -F "model=Seedance-2.0-fast-480p" \
  -F "prompt=让画面动起来" \
  -F "duration=5" \
  -F "image=@/path/to/photo.jpg"

# 720p 高清（文生，model 换成 720p 即可）
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{"model":"Seedance-2.0-fast-720p","prompt":"雪山日出航拍","duration":5}'

# 多参考图（≤9，prompt 用 @image1/@image2 引用）
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{
    "model":"Seedance-2.0-fast-480p",
    "prompt":"@image1 的人物在 @image2 的场景中行走",
    "image_url":"https://cdn.example.com/person.jpg",
    "reference_image_urls":["https://cdn.example.com/scene.jpg"],
    "duration":5
  }'

# 多角色 · 参考图命名（让 prompt 里的 @人物 对上正确的图）
# 推荐：对象数组，name 跟着自己的图走，排序不会错位
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{
    "model":"Seedance-2.0-720p",
    "prompt":"@志强 与 @清雅 在医院走廊相遇，@张秋月 从远处走来",
    "reference_images":[
      {"url":"https://cdn.example.com/zhiqiang.jpg","name":"志强"},
      {"url":"https://cdn.example.com/qingya.jpg","name":"清雅"},
      {"url":"https://cdn.example.com/qiuyue.jpg","name":"张秋月"}
    ],
    "aspect_ratio":"9:16","duration":10
  }'
# 等价平行数组写法（names 须与 urls 同序一一对应）：
#   "reference_image_urls":["...zhiqiang.jpg","...qingya.jpg","...qiuyue.jpg"],
#   "reference_image_names":["志强","清雅","张秋月"]
# 不传名字＝维持现状：需绑定请自行在 prompt 里写「图一为志强@志强，图二为清雅@清雅」

# 多图融合 · 标明背景图（避免背景里凭空多出人脸 / 重影 / 多余头）
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{
    "model":"Seedance-2.0-720p",
    "prompt":"@志强 站在空旷的办公室里演讲",
    "reference_images":[
      {"url":"https://cdn.example.com/zhiqiang.jpg","name":"志强","role":"subject"},
      {"url":"https://cdn.example.com/office.jpg","role":"background"}
    ],
    "aspect_ratio":"16:9","duration":8
  }'
# 等价平行数组：reference_image_urls + reference_image_names + reference_image_roles 三者同序对应

# 参考视频（≤3，mp4/mov 2-15s 24-60fps ≤50MB；prompt 用 @video1 引用）
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{
    "model":"Seedance-2.0-fast-480p",
    "prompt":"把 @image1 的人物换进 @video1 的画面",
    "image_url":"https://cdn.example.com/person.jpg",
    "reference_videos":["https://cdn.example.com/ref.mp4"],
    "duration":5
  }'

# 首尾帧过渡（first_image_url → last_image_url）
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{
    "model":"Seedance-2.0-fast-480p",
    "prompt":"平滑电影感过渡",
    "first_image_url":"https://cdn.example.com/start.jpg",
    "last_image_url":"https://cdn.example.com/end.jpg",
    "duration":5
  }'

Seedance 2.5 · 新一代视频生成

全新一代 Seedance 2.5 视频模型，动态表现与质感升级，支持超大规模多模态参考（单次最多 30 张图 + 10 段视频 + 10 段音频）。接口、参数、提交→轮询→下载流程与 Seedance 2.0 完全一致，切换只需改 model 字段。

模型与价格

按秒计费 = 单价 × duration。例：Seedance-2.5-720p 5 秒 = 0.35×5 = ¥1.75；Seedance-2.5-480p 8 秒 = 0.25×8 = ¥2.00。生成失败不计费（自动全额退款）。

接口与调用流程

请求参数（全部）

⚠️ 参考素材必须是公网可直接下载的 URL（或 data:...;base64,）——不要用需登录/防盗链的链接，否则上游抓取失败。音频 / 视频参考建议至少配 1 张主图。

示例

① 文生视频（t2v）——只给文字描述：

curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance-2.5-720p",
    "prompt": "夕阳下的海边，海浪缓缓拍打礁石，电影感宽镜头",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

② 图生视频（i2v）——给一张主图让它动起来（多图用 reference_image_urls，prompt 用 @image1/@image2 引用）：

# 单图
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance-2.5-480p",
    "prompt": "画面中的人物微笑并缓步向前走",
    "image_url": "https://cdn.example.com/person.jpg",
    "duration": 5,
    "aspect_ratio": "9:16"
  }'

# 多图（≤30，@image1=主图、@image2=场景图）
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance-2.5-720p",
    "prompt": "@image1 的人物在 @image2 的场景中行走",
    "image_url": "https://cdn.example.com/person.jpg",
    "reference_image_urls": ["https://cdn.example.com/scene.jpg"],
    "duration": 6
  }'

③ 全能参考（图 + 视频 + 音频混合，最多 30 图 / 10 视频 / 10 音频）——用 @image / @video / @audio 在 prompt 里引用，须至少配 1 张主图：

curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance-2.5-720p",
    "prompt": "@image1 的人物，动作参考 @video1，配合 @audio1 的节奏起舞，电影级光影",
    "image_url": "https://cdn.example.com/person.jpg",
    "reference_videos": ["https://cdn.example.com/dance.mp4"],
    "reference_audios": ["https://cdn.example.com/music.mp3"],
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

④ 轮询 + 下载：

# 提交后拿到 {"task_id":"task_xxx","status":"queued"}
curl https://YOUR_BASE/v1/videos/task_xxx \
  -H "Authorization: Bearer sk-xxx"
# 完成后返回 {"status":"SUCCESS","video_url":"https://.../xxx.mp4?..."}
# 直接 GET video_url 即可下载 mp4

约束速记：时长 4-29 秒任意整数（按秒计费，不传默认 4 秒）；参考上限 30 图 / 10 视频 / 10 音频，超出自动截断；参考视频分辨率须 ≤ 1080p（长边不超过 1920、短边不超过 1080——上传 2K / 4K 会被直接拒绝，不产生任务、不计费，请先压到 1080p 及以内）；参考内容须中性（换脸 / 真人肖像 1:1 还原、含明显版权或敏感画面可能触发上游内容审核）；生成失败自动全额退款。

VEO 3.1 · 官方字段兼容

本页对应 Dallas new-api-2 的 veo官转 分组，使用 Google Veo 风格字段名，但传输仍采用本服务的 OpenAI 兼容异步接口 /v1/videos。现有 firefly 分组不受本页参数规则影响。

模型与价格

令牌分组：veo官转。模型和计费以该分组权限为准；内部适配别名不会出现在公共模型列表。

接口信息

官方字段

示例：官方字段提交

BASE_URL="https://newapi-2.oairegbox.cc"
TOKEN="sk-你的veo官转令牌"

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "prompt": "一只纸船沿着安静的湖面漂流，电影感镜头，无文字无标志",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "durationSeconds": 4,
    "generateAudio": true,
    "negativePrompt": "text, watermark",
    "seed": 123456,
    "personGeneration": "allow_adult",
    "sampleCount": 1
  }'

首帧、尾帧与参考图

image + lastFrame 用于首尾帧；只传 lastFrame、或同时混用 referenceImages 会在生成前返回 400。referenceImages 用于最多 3 张参考图，style 类型最多 1 张。

curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "prompt": "镜头从清晨湖面过渡到日出后的明亮湖面",
    "image": {"imageBytes": "<base64首帧>", "mimeType": "image/png"},
    "lastFrame": {"inlineData": {"data": "<base64尾帧>", "mimeType": "image/png"}},
    "aspectRatio": "16:9",
    "resolution": "720p",
    "durationSeconds": 4,
    "seconds": 4
  }'

明确不支持

• Gemini 原生 instances + parameters envelope
• operation.name 原生任务 ID
• video.uri 原生下载 URI
• video / 视频扩展输入
• 单请求多视频（sampleCount>1）

上游尚未独立收敛的字段（负向词、seed 可复现性、尾帧、人物策略、参考图的 Adobe 语义）会按实际成片结果更新；适配器已知边界不会被描述成 Google 原生协议支持。

Grok 视频（文 / 图生视频）

基于 xAI Grok Imagine 官方接口的视频生成，OpenAI 兼容异步接口。两个模型：grok-imagine-video（1.0，文生 / 图生视频）与 grok-imagine-video-1.5（1.5 代，图生视频、画面质感更好）。带参考图即图生视频，不带图则为纯文生视频（1.5 建议带图）。支持 480p / 720p / 1080p 输出，grok-imagine-video-1.5 可出 1080p 高清。

模型与价格

按次计费：与时长无关，每条固定价；失败不计费，成功出片才扣。

接口

参数

传图方式（图生视频）

i2v 的参考图通过 image 字段传入，支持两种写法：

图片格式 JPG / PNG / WebP。

单张首帧 vs 多张参考图

• 单张首帧：用 image（字符串，一个 URL 或 base64）。
• 多张参考图：用 reference_images（URL 数组），grok-imagine-video-1.5 最多 7 张，模型综合多张参考出片。示例："reference_images": ["https://.../a.jpg", "https://.../b.jpg"]

⚠️ 1080p 仅支持单张首帧（image 模式）：选 1080p 时不能用多图 reference_images——若同时传了多张，只有第一张作首帧生效。需要多张参考图请用 480p / 720p。

字段名兼容：单图推荐 image、多图用 reference_images；image_url / image_reference / images / image_urls / input_reference 等写法也已兼容（服务端自动识别为参考图，不会退化成纯文生视频）。

接入示例

# 文生视频（grok-imagine-video，不带图）
curl https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "灯塔在日落时分，海浪拍打礁石，电影感镜头",
    "seconds": "6",
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
# => {"task_id":"task_xxx","status":"queued",...}

# 图生视频（grok-imagine-video-1.5，带 image）
curl https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "轻微镜头推移，画面自然生动",
    "image": "https://your-public-image.jpg",
    "seconds": "6"
  }'

# 多图参考（grok-imagine-video-1.5，最多 7 张，仅 480p/720p）
curl https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "融合多张参考图的场景，电影感转场",
    "reference_images": ["https://img-a.jpg", "https://img-b.jpg"],
    "seconds": "6",
    "resolution": "720p"
  }'

# 轮询直到 completed，取 video_url
curl https://YOUR_BASE/v1/videos/task_xxx \
  -H "Authorization: Bearer sk-xxx"
# => {"status":"completed","video_url":"https://.../xxx.mp4",...}

注意事项

• 按次计费：与时长无关，每条固定价（1.0=¥0.35，1.5=¥0.4）；失败不计费，成功出片才扣
• seconds 取 1~15；resolution 支持 480p / 720p / 1080p（仅小写；1080p 用 grok-imagine-video-1.5）
• 多张参考图：grok-imagine-video-1.5 用 reference_images 数组，最多 7 张（仅 480p / 720p）；单张首帧用 image
• ⚠️ 1080p 仅支持单张首帧 image，不支持多图 reference_images（传了也只取第一张作首帧）
• 图生视频的 image 须为公网可直接抓取的 URL 或 base64 Data URI；需登录 / 内网 / 拦爬虫（如部分维基）的链接会失败
• grok-imagine-video 不带图为文生视频；grok-imagine-video-1.5 为图生视频，建议带 image
• 客户端超时建议 ≥ 300 秒；轮询间隔建议 3-5 秒

Grok 图像生成（文生图 / 图生图）

OpenAI 兼容的同步图像接口，使用 grok-imagine-image 模型。支持文生图、单图参考和多图参考；请求成功后直接返回图像结果。

模型与价格

按张计费：每张图片按模型价格计费；生成失败不扣费。

接口

参数

传图方式（图生图）

接入示例

# 文生图
curl https://YOUR_BASE/v1/images/generations \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "一座漂浮在云海上的未来城市，清晨柔光，电影感",
    "n": 1,
    "response_format": "url"
  }'

# 图生图：JSON 单张公网图片
curl https://YOUR_BASE/v1/images/edits \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "保留主体构图，将背景改为雨后的霓虹街道",
    "image": "https://your-public-image.jpg",
    "response_format": "url"
  }'

# 图生图：multipart 多张文件
curl https://YOUR_BASE/v1/images/edits \
  -H "Authorization: Bearer sk-xxx" \
  -F "model=grok-imagine-image" \
  -F "prompt=融合两张参考图的风格，生成商品展示图" \
  -F "image[]=@reference-a.png" \
  -F "image[]=@reference-b.jpg" \
  -F "response_format=url"

返回结果与下载

{
  "created": 1786675686,
  "data": [
    {
      "url": "https://YOUR_BASE/v1/images/proxy/<encrypted-token>"
    }
  ]
}

response_format=url 时，返回的是平台下载代理地址，浏览器或程序可直接访问；地址不暴露上游下载域名和签名参数，默认有效期为 30 天。需要自行保存图片数据时，使用 response_format=b64_json 并读取 data[].b64_json。

注意事项

• 接口为同步接口，请等待响应中的 data 返回后再处理结果。
• 公网图片必须允许服务端直接下载；需要登录、内网地址或访问受限的链接无法作为参考图。
• 使用 JSON 多图时传 images 数组；使用 multipart 多图时重复传 image[] 字段。
• url 与 b64_json 二选一：前者适合直接展示或下载，后者适合本地持久化或二次处理。

GPT-Image-2

文生图 / 图生图 / Chat 生图，支持三种调用方式。

模型与价格

接口

参数（文生图）

示例

# 文生图
curl -X POST https://YOUR_BASE/v1/images/generations \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫趴在窗台上晒太阳，水彩画风格",
    "size": "1024x1024",
    "quality": "high"
  }'

# 图生图
curl -X POST https://YOUR_BASE/v1/images/edits \
  -H "Authorization: Bearer sk-xxx" \
  -F "image=@reference.png" \
  -F "prompt=把背景改成海边日落" \
  -F "model=gpt-image-2"

# 图生图（Python：用 files= 让库自动生成 multipart boundary）
import requests
requests.post("https://YOUR_BASE/v1/images/edits",
    headers={"Authorization": "Bearer sk-xxx"},        # 不要手动设 Content-Type
    data={"model": "gpt-image-2", "prompt": "把背景改成海边日落"},
    files={"image": open("reference.png", "rb")})      # files= 自动带 boundary

# Chat 生图（参考图须用 Base64，不支持公网 URL）
curl -X POST https://YOUR_BASE/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "messages": [{"role":"user","content":[
      {"type":"text","text":"把这张图改成赛博朋克风格"},
      {"type":"image_url","image_url":{"url":"data:image/jpeg;base64,<BASE64>"}}
    ]}]
  }'

注意事项

• 提示词长度：按字符数计（中英文一视同仁，非字节），单次上限约 1 万字符，超出会返回生成失败。建议控制在 8000 字符以内 —— 文生图默认会自动增强/扩写提示词，判定长度时算的是「你的原文 + 扩写后」的合计，故请留足余量
• 请求体大小上限：文生图 JSON 请求体 ≤ 8MB、图生图 multipart ≤ 6MB（其中参考图合计 ≤ 5MB）；正常提示词远达不到，过大的请求会被网关拒绝
• 响应时间 15-60 秒，超时建议 ≥120 秒
• 默认返回 b64_json（Base64 编码），需客户端解码保存
• response_format: "url" 返回完整图片地址（如 https://img1.oaibox.xyz/images/...），直接使用即可，无需拼接域名；地址域名可能为 img1 或 img2，均可直接访问
• 图生图参考图提交方式：/v1/images/edits 用 multipart 上传文件（-F "image=@file.png"）；/v1/chat/completions 用 Base64（data:image/...;base64,）。暂不支持直接传公网图片 URL，请先下载文件或转 Base64 再提交
• 图生图（/v1/images/edits）必须发合法 multipart/form-data：用 HTTP 库的文件上传（curl -F、Python files=、JS FormData）让库自动生成 boundary；切勿手动设 Content-Type、手拼 body 或用 application/json，否则网关无法解析请求体，返回 500 failed to parse multipart form（非服务异常，是请求格式问题）
• 图生图上传的参考图请控制在 2K（长边 ≤ 2048）以内，超出会返回 400；更大尺寸请先压缩再上传
• size 只决定横 / 竖 / 方比例（best-effort），不保证精确像素尺寸；需要精确高分辨率请改用 gpt-image-2-4k

gpt-image-2-4k（异步 4K）

4K 超清文生图，异步任务制（提交即返回，不占用长连接）。出图分辨率 2880×2880，计费 ¥0.2/张（按次，成功才扣），典型耗时 1–3 分钟。

调用流程

示例

# ① 提交任务
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2-4k","prompt":"一只橘猫坐在窗台上"}'
# → {"id":"task_xxxx","status":"queued"}

# ② 轮询状态（每 5-10 秒一次）
curl https://YOUR_BASE/v1/videos/task_xxxx \
  -H "Authorization: Bearer sk-xxx"
# → {"status":"completed","video_url":"https://.../xxxx.png"}

# ③ 完成后从 video_url 下载 4K 图片

注意事项

• 异步任务：提交立即返回 task_id，请轮询获取结果，不要保持长连接
• 结果图片地址请读取 video_url 字段
• 出图分辨率固定 4K（2880×2880）

Gemini 图像生成

基于 Gemini 的图像生成服务。

模型与价格

接口

通过 POST /v1/images/generations 调用，参数与 GPT-Image-2 类似。

curl -X POST https://YOUR_BASE/v1/images/generations \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-image",
    "prompt": "赛博朋克风格的东京夜景",
    "size": "1024x1024"
  }'

参考图（图生图 / 编辑）

附带参考图即可进行图生图 / 编辑。image 字段同时支持字符串与数组两种写法，取值可为公网 URL 或 data:image Base64：

curl -X POST https://YOUR_BASE/v1/images/generations \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-image",
    "prompt": "把这两张图融合成一张海报",
    "image": ["https://cdn.example.com/a.jpg", "https://cdn.example.com/b.jpg"]
  }'

兼容说明：image 传单张用字符串、传多张用数组均可。早期部分客户端把图片写成数组会报 cannot unmarshal array into ... image of type string，现已兼容修复，无需改动客户端。参考图最多 5 张、每张 ≤5MB。

GPT-Image-2 多档生图（1K 同步 / 异步 · 2K / 3.5K 异步）

GPT-Image-2 按分辨率分三档：1K 可自由选择同步或异步；同步适合需要立即拿图片的客户端，异步适合连接稳定性优先、不能长时间保持请求的客户端。2K / 3.5K 固定走异步接口（提交拿 task_id → 轮询任务 → 下载结果，不占用长连接）。所有档位均支持文生图，附参考图即图生图，最多 6 张；参考图解码后的文件合计不超过 5 MiB。按张固定计费，失败不计费。

输入限制：1K JSON 请求体最多 8 MiB；参考图可使用公网 HTTPS 直链或完整 data:image/png;base64,...、data:image/jpeg;base64,...、data:image/webp;base64,...，Base64 解码后的参考图合计最多 5 MiB。超过限制会在提交前返回 400，不会扣费。

模型与价格

怎么选：需要一次请求直接拿图，用 gpt-image-2-1k 同步；需要提交后自行轮询、规避长连接超时，用 gpt-image-2-1k-async。两者分辨率、参考图能力、积分消耗和价格完全一致。2K/3.5K 始终走异步。用你的生图分组令牌调用即可。

通道 A · 1K 同步（OpenAI 兼容）

# 1K 同步：直接返回图片 URL
curl -X POST https://YOUR_BASE/v1/images/generations \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{
    "model":"gpt-image-2-1k",
    "prompt":"a small red apple on a white table, product photo",
    "size":"1024x1024"
  }'
# 返回: {"created":..., "data":[{"url":"https://.../xxx.jpg"}]}
# 当前同步接口返回 URL，不返回 b64_json；需要 Base64 请由客户端下载 URL 后自行编码。

通道 B · 1K / 2K / 3.5K 异步（同视频任务接口）

# 1) 提交（异步）
curl -X POST https://YOUR_BASE/v1/videos \
  -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" \
  -d '{
    "model":"gpt-image-2-1k-async",
    "prompt":"a small red apple on a white table, product photo",
    "aspect_ratio":"1:1"
  }'
# 返回 task_id

# 2) 轮询：只以 status=completed 判定完成，progress 仅供展示
curl https://YOUR_BASE/v1/videos/task_xxx \
  -H "Authorization: Bearer sk-xxx"
# 完成后响应中的 video_url 为图片 URL；也可 GET /v1/videos/task_xxx/content 下载结果。

输入格式与错误处理

• JSON：使用 Content-Type: application/json；data URL 必须完整、Base64 可解码，格式限 PNG/JPG/WebP。
• multipart/form-data：1K 异步、2K/3.5K 可用文件字段上传参考图；请让 HTTP 库自动生成 boundary，不要手写错误的 Content-Type。
• 400：请求字段、JSON、参考图格式或大小不符合要求，修改请求后再试；不会扣费。
• 401/404：令牌或任务 ID 无效，请检查配置。
• 409：任务尚未完成，继续按 5–10 秒间隔轮询。
• 502/503/504：服务临时不可用或超时，可指数退避重试；不要并发重复提交同一任务。

Gemini 音乐生成

通过 Chat Completions 接口生成音乐。同步返回（约 30–60 秒），结果是一个可直接下载的音频链接（MP4/M4A，无需鉴权即可 GET 下载）。

模型与价格

令牌分组必须为 gemini-高速（或 gemini-低速），否则返回"无可用渠道"。失败不计费。

请求示例

curl https://YOUR_BASE/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-music",
    "messages": [{"role":"user","content":"创作一首轻快的电子风格BGM，适合科技产品广告"}]
  }'

返回示例

下载链接在 choices[0].message.content 里（Markdown 链接 + 纯 URL 各一份）：

{
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "✅ 音乐生成完成\n\n[⬇️ 点击下载音乐](https://download.oaibox.xyz/v1/audio/aud-xxxx/content)\n\nhttps://download.oaibox.xyz/v1/audio/aud-xxxx/content"
    },
    "finish_reason": "stop"
  }]
}

从 content 中取出形如 .../v1/audio/aud-xxxx/content 的 URL，直接 GET 即可下载音频（无需带 Authorization）。也支持 "stream": true，链接会在流式结束的那条消息里返回。

下载域名随所用平台不同：平台 A → download.oaibox.xyz，平台 B → download-2.oaibox.xyz。链接为生成后即时缓存，建议尽快下载保存。

通用说明 & FAQ

平台信息

两平台能力一致，账号与令牌独立、不互通。选择其一使用即可。

鉴权

所有请求需携带 Authorization: Bearer sk-你的令牌 请求头。令牌在对应平台后台创建，分组必须与模型匹配（错误分组会返回"无可用渠道"）。

错误码

FAQ

Q: 视频生成需要多久？

Omni 视频约 1-5 分钟，Grok 视频约 30s-3 分钟（时长越长越慢）。建议客户端超时 ≥300 秒。

Q: 失败会扣费吗？

不会。所有模型失败一律不扣费，仅成功出片/出图才计费。

Q: 参考图被内容策略拒绝怎么办？

包含可识别真人面孔的参考图可能触发 Gemini 内容策略。系统会自动尝试处理并重试。如仍失败，建议：使用非写实风格、虚构人物、侧面/背影/远景，或使用已授权的素材。

Q: 两个平台有什么区别？

能力完全一致。账号和余额独立。选其一使用，不可跨平台混用令牌。

视频生成 · 内容审查避坑指南

适用于 omni-fast / veo 系列视频模型 · 帮你避开 Google 内容审查，提高一次出片成功率

一、先看这条报错

如果你收到：

This request didn't pass content review (e.g. an identifiable real person, unsafe content, or protected IP). Retrying or switching accounts won't help. Try a non-photorealistic style, a non-identifiable or fictional subject (back/side/distant view), or rights-cleared content, then resubmit.

中文意思：请求没通过内容审查（可能涉及：可识别真人 / 不安全内容 / 受保护版权）。

二、六大高危雷区（命中必拒）

三、安全改写对照表

四、万能保险公式

不确定会不会被拒时，套这个组合最稳：

非写实风格 (non-photorealistic / 3D cartoon / illustration / anime)
+ 虚构、不具名的主体 (fictional, non-identifiable subject)
+ 脸部不可识别 (背面 / 侧面 / 远景)
+ 内容健康、无版权

五、提交前自检清单

MiniMax H3 视频生成

基于 MiniMax minimax-h3 的视频生成服务：1440P 超清 + 原生音频，支持文生视频、图生视频（多参考图）、首尾帧过渡、参考音频。异步创建 → 轮询 → 下载，与其它视频模型同一套 /v1/videos 接口。

模型与价格 · 按次固定

按次计费：每次提交固定 ¥3.50，与时长无关；固定 1440P + 原生音频；失败不计费。

生成模式（按传入素材自动判定）

参数

示例：文生视频

curl https://newapi-2.oairegbox.cc/v1/videos \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "A calm ocean wave rolling onto a sandy beach at golden sunset, cinematic wide shot, gentle motion",
    "duration": 5,
    "ratio": "16:9",
    "resolution": "1440p",
    "generate_audio": true
  }'

返回任务对象（含 task_id，初始 status:"queued"）。

示例：图生视频 / 首尾帧

# 图生视频（参考图 ≤5）
{"model":"minimax-h3","prompt":"...","duration":5,"ratio":"16:9",
 "referenceImages":["https://.../a.png","https://.../b.png"]}

# 首尾帧过渡（成对，不能再带 referenceImages）
{"model":"minimax-h3","prompt":"...","duration":8,"ratio":"16:9",
 "first_image":"https://.../start.png","last_image":"https://.../end.png"}

轮询 & 下载

# 轮询任务（前 60 秒每 3-5 秒一次，之后每 10-15 秒）
curl https://newapi-2.oairegbox.cc/v1/videos/TASK_ID -H "Authorization: Bearer $TOKEN"

# status=completed 后，用响应里的 video_url 直链下载
curl -L "VIDEO_URL" -o result.mp4

注意：
• 不支持参考视频（referenceVideos），传入会失败。
• 参考音频必须搭配 ≥1 张参考图；参考图与首尾帧不能同时使用。
• progress 长时间不动不代表卡住——只要 status 仍是 queued/in_progress 就继续轮询；到 completed/failed 停止。
• 15 秒长视频出片时间较长，请耐心轮询。失败不计费。

MiniMax H3 · 按秒计费（768P / 2K）

MiniMax H3 的按秒计费版本，两档清晰度，原生音频。支持文生视频、图生视频、首尾帧过渡与参考图 / 参考音频驱动；需要参考视频驱动请用下方 Pro 档。与其它视频模型同一套 /v1/videos 接口：异步创建 → 轮询 → 下载。

📌 全能参考 = 图·视频·音频 支持张数(如 933 = 9 图 + 3 视频 + 3 音频,对标 Seedance 2.0)。如需 933 全能参考,请联系客服开通。

模型与价格 · 按秒

按秒计费 = 单价 × 时长（例：minimax-h3-2k 跑 10 秒 = ¥2.00；minimax-h3-768p 跑 6 秒 = ¥0.90）。失败不计费。

生成模式（按传入素材自动判定）

参数

示例：文生视频

curl https://newapi-2.oairegbox.cc/v1/videos \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"model":"minimax-h3-2k","prompt":"A calm ocean wave at golden sunset, cinematic","duration":5,"ratio":"16:9"}'

示例：图生视频（参考图）

curl https://newapi-2.oairegbox.cc/v1/videos \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"model":"minimax-h3-768p","prompt":"角色转身微笑，镜头缓慢推近","duration":6,
       "referenceImages":["https://.../ref1.jpg"]}'

Pro 档 · 参考视频驱动

需要用一段视频驱动动作 / 镜头运动时,改用 Pro 档:在上面全部能力之上,额外支持 1 段参考视频。

参考视频:1 段,时长 2–5 秒(请上传你需要的关键片段);放进 referenceVideos,可叠加参考图 / 参考音频 / 首尾帧。价格已含参考视频处理,按输出秒数计费、失败不计费。2K / 参考视频出片较慢,高峰期偶发排队请重试。

示例：参考视频驱动（Pro）

curl https://newapi-2.oairegbox.cc/v1/videos \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"model":"minimax-h3-pro-768p","prompt":"角色跟随参考视频的动作与镜头运动","duration":5,
       "referenceVideos":["https://.../ref.mp4"]}'

轮询 & 下载

curl https://newapi-2.oairegbox.cc/v1/videos/TASK_ID -H "Authorization: Bearer $TOKEN"
# status=completed 后用响应里的 video_url 直链下载
curl -L "VIDEO_URL" -o result.mp4

参考素材可用公网 URL 或 base64；轮询到 completed/failed 停止；失败不计费。