JojoKey Video · AI 视频生成

当前账号是 native_direct（原生直连）模式。视频生成请使用海外 BytePlus ARK（海外方舟）原生 Ark API Key（方舟接口密钥）和 Endpoint（模型接入点）；这里仍可上传素材并复制 asset:// 引用。

提示词 (Prompt)

建议英文，部分模型支持中文/日/西/葡/印尼 {{ form.prompt.length }} 字

制作方式

文生视频

首尾帧动画

多参考创作

文生视频、首尾帧动画、多参考创作在同模型、分辨率、时长下价格一样，不按图片数量加价；最终按官方实际 token（令牌）消耗结算。只有视频参考、生成音频、分辨率、时长、模型不同，价格才会变。

文件名来自上传文件，用来区分素材；不代表模型、上传格式或功能类型。普通 URL、asset:// 素材、预登记 asset://、受控人像 asset:// 只是本系统的引用方式标签。

起止画面

首帧图片

移除

{{ assetScopeLabel(firstFrameUpload) }} · role=first_frame

上传并使用

尾帧图片（可选）

移除

{{ assetScopeLabel(lastFrameUpload) }} · role=last_frame

上传并使用

参考图板

图片顺序就是 Prompt（提示词）里的图片1、图片2顺序。

上传并加入

图片{{ idx + 1 }}

{{ assetScopeLabel(a) }} · role=reference_image

还没有参考图。添加后会显示为图片1、图片2，生成时全部作为 reference_image（参考图）提交。

参考视频（可选）

用于参考运动节奏、镜头运动或动作风格；生成时会作为 reference_video（参考视频）提交。

上传视频

{{ assetScopeLabel(referenceVideoUpload) }} · role=reference_video

移除

不选参考视频时，仍可正常文生视频、首尾帧动画或多参考图创作。选择参考视频后，预计结算会按“带视频参考”重新计算。

参数配置

本次实际发送给上游的 model（模型）：{{ effectiveUpstreamModel }}

后台已配置模型 Endpoint（模型接入点）映射，当前模型会按上面的 Endpoint 发送；分辨率 480p/720p/1080p 不会单独切换 Endpoint，除非后台另做“模型 + 分辨率”映射。

后台已配置模型 Endpoint（模型接入点）映射，但当前模型没有单独 Endpoint，后台会按官方 ID 发送；分辨率 480p/720p/1080p 不会单独切换 Endpoint。

当前账号绑定了 Endpoint（模型接入点），后台会把 {{ me.endpoint_id }} 作为官方 model 发送；上面的选择用于计费档位、任务记录和没有 Endpoint 时的官方模型映射。

当前账号没有绑定 Endpoint（模型接入点），后台会按所选卡片的官方 ID 直接调用上游模型。

官方参数是整数；同一提示词和同一 Seed 会生成相似结果，但不保证完全一致。

生成音频

{{ currentModelSupportsAudio ? 'Seedance 2.0 / 2.0 Fast / 1.5 Pro 支持' : '当前模型不支持' }}

加水印

官方 Brand 水印

预计结算

按当前参数估算，实际以任务完成后的 token（令牌）为准。

预扣上限 ${{ fmt(estimatedCost) }}

${{ fmt(estimatedSettlementCost) }}

≈ {{ estimatedTokens.toLocaleString() }} tokens（令牌）

可用余额 {{ fmtUsd(me?.available_usd) }}

冻结中 {{ fmtUsd(me?.held_usd) }} ({{ me?.pending_tasks }})

余额不足，预计结算 ${{ fmt(estimatedSettlementCost) }}，提交需预扣 ${{ fmt(estimatedCost) }}

提交生成

费用备注

预计结算 是按当前参数算出的参考值；任务成功后，会按上游返回的 usage.completion_tokens（官方实际输出 token）重新结算。
预扣上限 是提交时先冻结的最高金额，用来保证余额足够；预扣不是最终收费，不代表最终一定扣这么多。
任务完成后多退少补；实际消耗少于预扣时会自动退回差额，任务失败、取消或过期时会退回预扣。
文生、首尾帧、多图参考在同模型、分辨率、时长下价格一样，不按图片数量加价；会改变价格的是视频参考、生成音频、分辨率、时长和模型。

性感推理接口提交

使用当前同一套 Prompt（提示词）、参考素材和参数提交；启用专属质量优化，结果仍进入“我的任务”。

适合已有参考图的人物视频任务。提交体验保持标准视频任务形态，进度、结果和结算口径都按正常任务返回，适合把高表现参考图快速转成可交付视频。

调用性感推理接口提交

需要至少一张首帧、尾帧或参考图；不影响上方普通“提交生成”。

还没有任务，去新建一个吧

新建视频

该内容已过期

审核原因

{{ taskModerationSummary(t) || (moderationResultLoading[t.id] ? '正在查询详细失败原因...' : '打开详情可查看或重新查询') }}

{{ t.model }} · {{ t.resolution || '-' }} · {{ t.duration || '-' }}s ${{ fmt(t.actual_cost_usd ?? t.estimated_cost_usd) }}

{{ detailTask.model }} · {{ detailTask.resolution || '-' }} · {{ detailTask.duration || '-' }}s · {{ fmtTs(detailTask.created_at) }}

用户原文 Prompt（提示词）

"{{ detailTask.prompt_text }}"

提交上游英文 Prompt（实际发给 BytePlus 的提示词）

"{{ detailTask.upstream_prompt_text }}"

官方结果来源

{{ detailTask.result_source === 'official_byteplus' ? '海外 BytePlus ARK（海外方舟）官方结果链接' : '原生直连回传任务' }}

预览 / 下载方式

{{ detailTask.video_storage_mode === 'official_url_only' ? '官方链接直连播放' : (detailTask.video_storage_mode === 'local_compat_cache' ? '兼容旧任务本地缓存' : '官方链接或回传链接') }}

浏览器直接用这个官方链接预览和下载；本系统只保存任务记录和链接元数据，不另存完整 MP4。

上游 Task ID（任务 ID）

任务引用素材

{{ detailTask.reference_materials.length }} 个

{{ referenceKindLabel(item.kind) }} · {{ referenceRoleLabel(item.role) }}

关闭

用此任务再生成

上传素材

支持 JPG / PNG / WebP / MP4 / MOV / MP3 / WAV。公开视频 URL 会给上游模型拉取。

上传

可关闭后普通首帧直传；如果图片里明显有人脸或头像，建议打开预登记。系统会把图片预登记为 asset://，减少裸人脸 URL 触发上游隐私检测的概率；不是绕过审核，不能保证一定通过上游审核。

一般用户不需要打开。仅当运营明确告知你已绑定某个真人的上游 GroupId（素材组 ID）时使用；这个组只对应一个已完成真人认证的人，不能混传其他人的脸。这里只是把素材登记到已绑定的组，不会发起官方真人 KYC（真人身份认证）。

Seedream 制图

直接用文字生成一张图片素材。生成完成后会自动进入下方“我的素材库”，可以作为视频参考图继续使用。

生成后保存为图片素材

选择模型

制图提示词

参考图生图

Seedream 参考图 · 发送素材原始 URL 给上游

可选。开启后是 image-to-image（图生图）/ 多参考图制图；不选参考图时仍是 text-to-image（文生图）。Seedream 参考图会作为官方 image 字段发送给上游。

批量与优化

开启后会生成一组风格和主体相关的图片。参考图数量 + 最大输出图数量不能超过 {{ seedreamSequentialMaxTotal }}。

最大输出图数量

当前最多可输出 {{ seedreamOutputMaxCount }} 张；实际返回可能少于这个数量，系统按实际保存张数结算。

开启后会把 optimize_prompt_options.mode 设为 standard，通常画面理解更稳，但可能多等几秒。

尺寸 / 分辨率

自定义宽高

当前尺寸：{{ seedreamSizeValue }}。本功能先生成图片素材；如果要拿到 asset://，可以点右侧“上传并预登记为 asset://”。

生成图片

还没有生成图片

写一句你想要的画面，生成后会出现在这里和下方素材库。

图片预登记

已有 HTTPS 图片链接时，可以先通过图片预登记（素材预注册）拿到 asset://。这适合常用头像、参考图和批量任务；不是官方真人 KYC（真人身份认证），也不是绕过审核。

预登记

成功后会出现在下方素材库，标签显示为“图片预登记”，生成视频时直接使用返回的 asset://。

还没有素材，先上传一张参考图或一段视频

{{ a.id }} · {{ formatBytes(a.size_bytes) }}

国内账户状态

正在读取 /v1/video-cn/me ...

提交 JojoKey Video CN 任务

生成方式

文生视频

首尾帧动画

多参考创作

文生视频只传 Prompt（提示词）；首尾帧动画使用 first_frame（首帧）/ last_frame（尾帧）；多参考创作使用 reference_image（参考图）和 reference_video（参考视频）。

first_frame（首帧）

last_frame（尾帧，可选）

reference_image（参考图，最多 9 张）

reference_video（参考视频，可选）

生成音频

return_last_frame（返回尾帧）

这个入口调用 /v1/video-cn/videos，会写入国内任务表和人民币账本。4k、15 秒、智能时长等高成本参数会做更保守预扣；professional（专业版）超分因上游额外计费口径仍在确认，Beta 阶段暂不开放。

提交 JojoKey Video CN 任务

国内任务列表

刷新

{{ task.mode }} · {{ task.resolution }} · {{ task.duration || '-' }}s · 上游 {{ task.upstream_task_id || '-' }}

{{ task.prompt_text }}

预扣 ¥{{ money(task.held_cny || 0) }} 结算 ¥{{ money(task.actual_cost_cny || 0) }} tokens（令牌计量）{{ task.total_tokens || '-' }} Seed（种子）{{ task.seed ?? '-' }} generate_audio（生成音频）{{ task.generate_audio === null || task.generate_audio === undefined ? '-' : (task.generate_audio ? 'true' : 'false') }} tos_key（对象键）{{ task.tos_key }}

查看详情

查询状态

复制视频链接

复制尾帧链接

国内素材列表

刷新

上传本地素材

上传并预登记为 asset://

这里调用 POST /v1/video-cn/assets。系统会先保存文件，生成可被上游拉取的公网 URL，再登记到国内素材组；成功后返回 asset://，用于 first_frame（首帧）、last_frame（尾帧）、reference_image（参考图）或 reference_video（参考视频）。

URL 登记素材

登记国内素材

这里调用 /v1/video-cn/assets/from-url，只登记 JojoKey Video CN 素材，不写入海外 Seedance 素材库。建议使用国内对象存储或国内 CDN（内容分发网络）的图片/视频 URL；asset_type=3（音频资产）暂不开放。

{{ cnAssetTypeLabel(asset) }} · 国内素材同步状态: {{ cnSyncLabel(asset) }} · sync_status（同步状态）: {{ asset.sync_status ?? '-' }} · asset_status（资产状态）: {{ asset.asset_status ?? '-' }}

复制 asset://

复制源 URL

适合谁使用

JojoKey Video CN Beta 面向需要国内 Seedance / 即梦视频能力的测试客户。它使用独立人民币余额、国内任务账本和国内素材登记，不混海外美元账本，也不会把国内任务写到海外 Seedance 工作台里。

目前只有管理员开放的测试账号能使用。未开通账号仍可看到入口，但提交任务会被拦截。

完整使用流程

1. 管理员开通国内 Beta

管理员为账号打开 JojoKey Video CN Beta，并充值人民币余额。用户侧会看到 ¥ 余额、国内任务和国内素材登记。

2. 准备国内可访问素材 URL

图片和视频素材建议放到国内对象存储或国内 CDN（内容分发网络），避免上游拉取境外 URL 超时。

3. 新建视频任务

在“新建视频”里填写 Prompt（提示词）、模式、分辨率、比例和时长；系统会先做人民币预扣。

4. 到“我的任务”查看结果

任务提交后进入“我的任务”。点击任务可查看详情、播放结果、复制视频链接和尾帧链接；失败时会展示上游返回的错误原因。

5. 对账和充值

国内任务按人民币账本结算。余额不足时请联系管理员充值；海外美元余额不能抵扣国内任务。

素材准备规则

素材类型	当前建议	注意事项
图片素材	用于人物、商品、场景参考；建议 JPG / PNG / WebP。	优先使用国内 HTTPS URL；人脸和复杂素材建议先登记再用于生成。
视频素材	用于动作、镜头、姿态或风格参考；前台支持 MP4 / MOV。	建议短视频片段，文件放国内对象存储；过大、过长或境外公网文件容易拉取超时。
音频素材	Beta 阶段暂不开放音频资产登记。	接口会返回 video_cn_audio_asset_not_supported，等上游用法确认后再开放。

费用和预扣

国内任务提交时会先冻结一笔人民币预扣，任务完成后按返回的 token（令牌计量）和当前价格策略结算，多余冻结金额会释放；任务失败时不收最终生成费，冻结金额会按本地账本释放。

4k、15 秒、智能时长等高成本参数会更保守预扣；professional（专业版）超分因为上游额外计费口径未完全确认，Beta 阶段暂不开放。

已知限制

generate_audio=false 目前不能承诺强制静音；如必须无音乐，请在 Prompt（提示词）中明确“不生成背景音乐，只保留环境音”。
professional（专业版）超分暂不开放，避免额外计费和客户账单不一致。
asset_type=3（音频资产）暂不开放。
duration=-1（智能时长）可以传，但 Beta 阶段按 15 秒保守预扣，实际时长字段等待上游进一步完善。
境外素材 URL 容易被上游拉取超时，建议使用国内对象存储或国内 CDN（内容分发网络）。

上线建议

先给测试用户开通小额人民币余额，跑通“素材登记 -> 新建视频 -> 我的任务 -> 对账”闭环；确认素材源稳定后再放大并发和时长。

新建视频 CN

素材登记 CN

查看 API Key（接口密钥） CN

JojoKey Video CN API 文档

本页只描述国内 JojoKey Video CN Beta 接口。海外 Seedance 仍使用 /v1/videos、/v1/uploads 等海外接口，两个体系的余额、素材和任务互不混用。

Base URL（基础地址）：{{ cnApiHost() }}。所有请求都使用 Authorization（鉴权）请求头。

接口总览

接口	用途
GET /v1/video-cn/me	查看开通状态、人民币余额和冻结金额。
POST /v1/video-cn/videos	提交国内视频任务。
GET /v1/video-cn/videos	查看当前账号的国内任务列表。
GET /v1/video-cn/videos/{id}	查询单个任务状态并触发刷新。
POST /v1/video-cn/assets	上传本地素材，并预登记为国内 asset://。
POST /v1/video-cn/assets/from-url	把公网素材 URL 登记到国内素材账本。
GET /v1/video-cn/assets	查看当前账号的国内素材列表。
GET /v1/video-cn/assets/{asset_id}	查询单个国内素材状态，并同步上游最新 sync_status（同步状态）。

鉴权方式

使用账户页展示的国内 Relay API Key（中转接口密钥）。请求头格式如下：

Authorization: Bearer $KEY
Content-Type: application/json

请求示例：文生视频

curl -X POST {{ cnApiHost() }}/videos \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "阳光竹林里，一位女子缓慢走向镜头，电影感写实风格",
    "mode": "fast",
    "resolution": "720p",
    "ratio": "9:16",
    "duration": 5
  }'

请求示例：使用参考素材

先登记素材 URL 或上传本地素材，再把返回的素材地址放进 content[] 作为参考。国内素材同步状态建议达到 sync_status=2（已同步）后再用于生成。

curl -X POST {{ cnApiHost() }}/assets \
  -H "Authorization: Bearer $KEY" \
  -F "file=@reference.mp4;type=video/mp4" \
  -F "asset_type=2" \
  -F "asset_name=walk-reference"

curl -X POST {{ cnApiHost() }}/assets/from-url \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://cdn.example.cn/reference.jpg",
    "asset_name": "model-reference",
    "asset_type": 1
  }'

curl -X POST {{ cnApiHost() }}/videos \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [
      { "type": "text", "text": "参考图片中的人物，在城市街头自然行走" },
      { "type": "image_url", "image_url": { "url": "asset://asset_xxx" }, "role": "reference_image" }
    ],
    "mode": "fast",
    "resolution": "720p",
    "ratio": "9:16",
    "duration": 5
  }'

请求示例：首尾帧动画

首尾帧动画使用 first_frame（首帧）和 last_frame（尾帧），适合指定开始画面和结束画面。

curl -X POST {{ cnApiHost() }}/videos \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [
      { "type": "text", "text": "让首帧人物自然走到尾帧姿态，镜头稳定，写实风格" },
      { "type": "image_url", "image_url": { "url": "asset://asset_first" }, "role": "first_frame" },
      { "type": "image_url", "image_url": { "url": "asset://asset_last" }, "role": "last_frame" }
    ],
    "mode": "pro",
    "resolution": "720p",
    "ratio": "9:16",
    "duration": 5,
    "return_last_frame": true
  }'

请求示例：参考视频

参考视频使用 reference_video（参考视频），适合参考动作节奏、镜头运动或姿态变化。图片参考仍使用 reference_image（参考图）。

curl -X POST {{ cnApiHost() }}/videos \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [
      { "type": "text", "text": "参考视频里的走路节奏，换成夏日街拍风格" },
      { "type": "video_url", "video_url": { "url": "asset://asset_video" }, "role": "reference_video" }
    ],
    "mode": "fast",
    "resolution": "720p",
    "ratio": "9:16",
    "duration": 5,
    "bitrate_mode": "high"
  }'

参数说明

参数	说明
prompt	提示词简写；如果传 content[]，可以不传 prompt。
content[]	完整内容数组，支持 text（文本）、image_url（图片 URL）、video_url（视频 URL）等参考内容。
images / videos	简写数组，适合轻量接入；需要精确 role（角色）时建议使用 content[]。
audios	后端字段预留；音频资产和音频参考用法仍待确认，Beta 暂不建议使用。
mode	fast（快速）、pro（高质量）、mini（轻量测试）。
resolution	480p、720p、1080p、4k；4k 预扣更保守。
ratio	常用 9:16、16:9、1:1、3:4。
duration	通常 4-15 秒；-1 表示智能时长，会按 15 秒保守预扣。
generate_audio	是否尝试生成音频；false 不能承诺强制静音。如必须无音乐，请在 Prompt（提示词）里明确“不生成背景音乐，只保留环境音”。
watermark	是否请求水印；是否生效以国内上游当前模型能力为准。
return_last_frame（返回尾帧）	请求上游返回尾帧图片地址，任务详情里会展示 last_frame_url（尾帧链接）。
bitrate_mode（码率模式）	可传 normal（标准码率）或 high（高码率）。高码率更适合需要保留细节的任务。
seed	Seed（种子），用于让同类请求更便于复现；不填则由上游随机。
super_resolution_config	超分配置字段预留；professional（专业版）超分因额外计费口径未确认，Beta 暂不开放。
ips	版权放行 ID 字段预留；当前走线下备案，不做前台自助校验。

素材接口字段

字段	说明
asset_type=1	图片素材，支持 JPG / PNG / WebP，用于 first_frame（首帧）、last_frame（尾帧）、reference_image（参考图）。
asset_type=2	视频素材，支持 MP4 / MOV，用于 reference_video（参考视频）。建议短片段、国内 URL。
asset_type=3	音频资产暂不开放；请求会返回 video_cn_audio_asset_not_supported。
asset_url	返回的 asset://（素材 URI），生成视频时放进 content[]，不要写进 Prompt（提示词）正文。
sync_status=2	建议视为“已同步可用”。如果不是 2，请先查询素材详情或稍后重试。
source_url	源素材 URL。建议使用国内对象存储或国内 CDN（内容分发网络），避免境外 URL 拉取超时。

响应示例与任务状态

{
  "id": "cnv_xxx",
  "status": "queued",
  "upstream_task_id": "task_xxx",
  "video_url": "https://cdn.example.cn/output.mp4",
  "last_frame_url": "https://cdn.example.cn/last-frame.jpg",
  "tos_key": "tos/path/output.mp4",
  "seed": 12345,
  "generate_audio": true,
  "held_cny": 3.5000,
  "estimated_cost_cny": 2.8000,
  "actual_cost_cny": 2.6136,
  "upstream_actual_cost_cny": 2.4800,
  "total_tokens": 108900,
  "created_at": 1782800000
}

任务状态包括 queued（排队中）、running（生成中）、succeeded（已完成）、failed（失败）。轮询建议每 5-8 秒查询一次 GET /v1/video-cn/videos/{id}，不要每秒高频请求。

费用、冻结和对账字段

字段	说明
held_cny	提交时冻结的人民币金额，用来保证余额足够，不代表最终一定扣这么多。
estimated_cost_cny	按当前参数估算的客户侧价格，仅供提交前后参考。
actual_cost_cny	任务完成后的客户侧实际结算金额；失败任务通常为 0。
upstream_actual_cost_cny	本系统记录的国内上游成本，用于后台对账；普通用户只需要看 actual_cost_cny。
total_tokens	国内上游返回的 token（令牌计量）数量，是对账的重要参考字段。

Beta 暂不开放 / 需确认能力

professional（专业版）超分：上游确认有额外非 token（令牌）费用，Beta 阶段先禁用，避免客户账单不一致。
asset_type=3（音频资产）：文档字段预留，但当前不开放自助登记。
generate_audio=false：可以传，但不能承诺强制静音；如果要降低音乐风险，请在 Prompt（提示词）里明确“不生成背景音乐”。
duration=-1（智能时长）：可以传，但本系统按 15 秒保守预扣，实际输出秒数以后以上游返回字段为准。
resolution_limit（自定义短边超分）和 ips（版权放行 ID）：当前不作为普通客户自助参数开放。

错误码

错误码	含义与处理
video_cn_beta_not_enabled	当前账号未开通国内 Beta，请联系管理员开通。
insufficient_video_cn_balance	人民币余额不足，请充值后重试。
video_cn_professional_super_resolution_disabled	professional（专业版）超分暂不开放。
video_cn_audio_asset_not_supported	音频资产登记暂不开放，请先用图片或视频素材。
invalid_video_cn_request	请求体不合法，通常是 content[] 结构、role（角色）或参数范围不正确。
invalid_video_cn_asset_url	素材 URL 不是 http/https 公网链接。
invalid_video_cn_upload_type	本地上传文件类型不支持，目前只开放图片和视频素材。
video_cn_asset_type_mismatch	上传文件类型和 asset_type（素材类型）不一致。
upstream_task_failed	上游任务失败，查看 message（错误说明）判断是素材、提示词还是生成结果问题。

{
  "error": {
    "code": "insufficient_video_cn_balance",
    "message": "JojoKey Video CN 任务需要预扣 ¥3.0000，当前余额 ¥1.0000",
    "needed_cny": 3.0,
    "balance_cny": 1.0
  }
}

国内 Video CN Beta 配置

同一个账号下，国内线路使用独立人民币余额和国内任务账本。当前前台展示的是国内调用入口和国内 Relay API Key（中转接口密钥）；以后如需完全拆 key，可在后台单独发放。

国内 Host（接口地址）

国内人民币余额

国内任务

国内 Relay API Key（中转接口密钥）

{{ selectedCnVideoTask.mode }} · {{ selectedCnVideoTask.resolution || '-' }} · {{ selectedCnVideoTask.ratio || '-' }} · {{ selectedCnVideoTask.duration || '-' }}s · {{ fmtTs(selectedCnVideoTask.created_at) }}

用户 Prompt（提示词）

{{ selectedCnVideoTask.prompt_text }}

本次结算 CNY（人民币）

{{ fmtCny(selectedCnVideoTask.actual_cost_cny ?? selectedCnVideoTask.estimated_cost_cny) }}

预扣 {{ fmtCny(selectedCnVideoTask.held_cny || 0) }}

上游成本 CNY（人民币）

tokens（令牌计量）

上游 task_id（任务 ID）

关闭

刷新状态 CN

用此任务再生成 CN

3 分钟跑通

最短路径是：设置 Relay API Key（中转接口密钥）提交任务，轮询状态，成功后在 23 小时内打开官方链接下载。图生视频既可以普通首帧直传，也可以用图片预登记（素材预注册）拿到 asset://。

设置 Key（密钥）

把平台给你的 sk- 开头 Key 放进 Authorization（鉴权头），前台不会要求填写 Ark API Key（方舟接口密钥）。

提交生成

文生视频直接传 prompt（提示词）；图生视频可以直接上传首帧，也可以先预登记图片再把 asset:// 放进 content[]。

轮询并下载

任务流程是 submit -> poll -> download（提交、轮询、下载）。成功后 23 小时内下载，过期显示“该内容已过期”。

新建视频

素材库

完整 API 文档

模型能力速查

日常测试优先用 Seedance 2.0 Fast；质量、人像一致性或多模态参考优先用 Seedance 2.0 Pro。账号绑定 Endpoint（模型接入点）时，后台实际会上送 Endpoint，上面的模型选择仍用于计费档位和任务记录。

模型	适合场景	能力
Seedance 2.0 Pro	质量优先、人像/产品一致性、多参考素材	文生、图生、视频/音频参考、生成同步音频
Seedance 2.0 Fast	批量测试、速度优先、成本敏感	文生、图生、多参考、生成同步音频
Seedance 1.5 Pro	1.5 音画联合模型	文生、图生、生成同步音频
Seedance 1.0 / Lite	轻量任务或指定历史模型	按模型区分文生或图生，不支持生成同步音频

人脸图片建议先预登记：普通首帧直传仍然支持；如果图片里明显有人脸或头像，建议使用 /v1/uploads 打开预登记，或调用 /v1/image-audits 拿到 asset://，再放进 content[]。

性感推理接口（授权可见）

开通性感推理接口后，仍可沿用标准 /v1/videos 请求格式；授权账号提交单张参考图任务时，平台会自动启用面向人物表现和画面质感优化的专属生成链路。客户系统也可以在 metadata（元数据）里加入 enterprise_interface=sexy_reasoning 做日志标记。任务会以正常视频任务形态返回，状态、结果链接和结算信息都按标准流程查询。

传入 Prompt（提示词）和参考图

支持 HTTPS 图片 URL 或已登记的 asset:// 素材，图片 role（角色）建议使用 reference_image（参考图）。

专属质量优化

平台会结合参考图与 Prompt（提示词）优化画面质感、人物一致性和动作表达，让最终视频更适合高要求的商业或娱乐内容场景。

按标准任务轮询结果

创建后继续查询同一个 vid_ 任务；成功后拿到官方结果链接，失败时查看任务详情里的错误原因。

查看性感推理 API 文档

打开内部测试台

任务生命周期

submit -> poll -> download（提交、轮询、下载）。提交后拿到 vid_xxx；建议每 5-8 秒查询一次；成功后前台打开官方 video_url（视频链接），23 小时内下载次数不限。

下载过期后，任务记录仍保留，但完整视频不一定还能取回。页面会标注“该内容已过期”，不会展示无法执行的恢复说明。

为什么 Relay Key（中转接口密钥）也可信

hosted（托管调用）里，客户用我们的 Relay API Key（中转接口密钥）提交任务，但完成后拿到的是海外 BytePlus ARK（海外方舟）官方结果链接。任务详情会展示上游 Task ID（任务 ID）、官方结果来源和“官方链接直连播放”的方式；页面预览和下载按钮都使用同一个官方 video_url（视频链接），本系统只保存任务记录和链接元数据，不另存完整 MP4。

Step 1

上传或登记素材

本地文件用 /v1/uploads；已有公网图片或视频用 /v1/uploads/from-url。无明显人脸的首帧可普通直传；明显有人脸或头像，建议打开图片预登记（素材预注册）。返回的素材只归当前 API key 所属账号。

去素材库

复制命令

{{ guideUploadCurl }}

Image Pre-register（图片预登记）

图片预登记为 asset://

常用头像或参考图建议先调用 /v1/image-audits，拿到 asset:// 后复用。这个功能只是图片预登记（素材预注册），不是官方真人 KYC（真人身份认证），不是绕过审核，也不能保证一定通过上游审核。

去预登记

复制命令

{{ guideImageAuditCurl }}

metadata.audit_image

生成时自动转素材

一次性首帧任务可以在 /v1/videos 里传 prompt、images 和 metadata.audit_image=true；这是本系统识别的开关，不会原样转发给海外 BytePlus ARK（海外方舟）。本系统会先把图片登记为 asset://，再转发给上游。顶层 images 只传 1 张时会作为 first_frame（首帧）；传多张时会按多参考图处理，全部作为 reference_image（参考图）。复杂多参考仍建议使用完整 content[]，每张图一个 image_url.url。

复制命令

{{ guideAuditImageVideoCurl }}

Step 2

按字节原生结构生成

生成任务使用 model、content、resolution、ratio、duration 等字段。前台制作方式会把素材转成不同 role（角色）：首尾帧动画使用 first_frame / last_frame，多参考创作使用 reference_image。一个 image_url.url 只能填写一个图片 URL；多张参考图不能用逗号拼在同一个字段里。

新建视频

复制命令

{{ guideNativeCurl }}

Native Direct

原生直连配置

native_direct（原生直连）账号直接用海外 BytePlus ARK（海外方舟）Ark API Key（方舟接口密钥）和 Endpoint（模型接入点）生成视频；hybrid（混合模式）账号也可以同时用 Relay API Key（中转接口密钥）调用本系统 /v1/videos。素材上传和图片预登记仍走本系统。

查看配置

复制回传命令

{{ guideDirectTaskCurl }}

视频生成方法范例

下面全部是原生 /v1/videos 请求体写法，客户可以直接复制 JSON 放进命令行、SDK 或自己的后台。

{{ item.code }}

复制

Key 隔离

主创只用 Relay API Key（中转接口密钥）。hosted（托管）生成走平台 fallback Key 或后台绑定的 Ark Key；素材注册只走服务器保存的 AK/SK（访问密钥）。

素材隔离

素材列表按当前 API key 查询。别人上传生成的 asset://ID 不能被当前账号使用；服务端会返回 asset_not_owned。

1. 参考图来源

可上传本地图片、粘贴 HTTPS 图片 URL，或从“我的素材库”选择图片。本页面用于内部联调；客户生产系统请使用标准 /v1/videos 接口。

本地文件会转成 data:image/...;base64（编码图片）提交，不会写入浏览器存储。

选择素材库图片时，系统会使用可访问的源文件完成内部联调。

当前参考图预览

上传或选择图片后会显示在这里

2. 生成参数

同一段提示词会用于平台专属处理和最终视频。 {{ referenceWorkflowForm.prompt.length }} 字

创建接口返回 202 Accepted（已接收）只代表性感推理任务已入队；请继续轮询同一个 wfv_...，不要重复提交。图片、Prompt 或参数变化时会自动换新的 Idempotency-Key（幂等键）。

复制 curl 示例

提交性感推理

3. 进度

任务 ID

当前状态

当前阶段

{{ workflowStatusLabel(referenceWorkflow.current_stage || referenceWorkflow.status) }}

视频任务

手动刷新

复制 ID

只重试视频阶段

4. 结果

原始参考图

等待图片

专属处理结果

生成完成后显示

最终视频

视频完成后显示

打开视频链接

复制视频链接

{{ referenceWorkflow.safe_error_message || referenceWorkflow.error_message }}

请求与响应诊断

这里只显示脱敏后的请求体和响应体，不显示 Authorization（鉴权头）或完整密钥。给工程同事排查时可以复制这里。

最后请求

{{ referenceWorkflowRequestLogText }}

最后响应

{{ referenceWorkflowResponseLogText }}

总余额

● 可用 {{ fmtUsd(me?.available_usd) }}

● 冻结中 ({{ me?.pending_tasks }} 个任务) {{ fmtUsd(me?.held_usd) }}

累计已花费 {{ fmtUsd(me?.lifetime_spent_usd) }}

需要充值请联系平台管理员

Sexy Reasoning API（性感推理接口）

性感推理接口

上传参考图或选择素材库图片，平台自动完成专属处理并提交视频任务。仅授权账号可用。

打开性感推理接口

复制 API 示例

海外 Video

模式

Endpoint（模型接入点）

Project（项目）

海外 Host（接口地址）

Relay API Key（中转接口密钥）只用于登录本平台和 hosted（托管）中转。Ark API Key（方舟接口密钥）不在前台展示；native_direct（原生直连）请使用运营发放的海外 BytePlus ARK（海外方舟）原生 Key。

复制原生示例

素材库

海外 Relay API Key（中转接口密钥）

用于登录本平台、上传素材和 hosted（托管）中转调用

# 创建视频任务
curl https://video.example.com/v1/videos \
  -X POST \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "video-pro",
    "content": [{"type":"text","text":"a cat dancing"}],
    "resolution": "720p",
    "duration": 5
  }'
              

国内 Video CN Beta

同一个账号下，国内线路使用独立人民币余额和国内任务账本。国内 Host（接口地址）和国内 Relay API Key（中转接口密钥）只用于 /v1/video-cn/*。

国内 Host（接口地址）

国内人民币余额

国内任务

国内 Relay API Key（中转接口密钥）

# 创建国内视频任务
curl {{ cnApiHost() }}/videos \
  -X POST \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "阳光竹林里，一位女子缓慢走向镜头",
    "mode": "fast",
    "resolution": "720p",
    "duration": 5
  }'
              

新建视频任务

我的视频

我的素材库

JojoKey Video CN Beta

操作指南

上传或登记素材

图片预登记为 asset://

生成时自动转素材

按字节原生结构生成

原生直连配置

{{ item.title }}

API 接入文档

性感推理接口

账号设置

{{ ssoPortal ? (authChecking ? '正在检测 JojoKey 登录态' : '登录或注册 JojoKey') : '欢迎回来' }}

新建视频任务

我的视频

我的素材库

JojoKey Video CN Beta

操作指南

上传或登记素材

图片预登记为 asset://

生成时自动转素材

按字节原生结构生成

原生直连配置

{{ item.title }}

API 接入文档

性感推理接口

账号设置