API 接口文档

全量模型目录

原模型名继续可用；指定分组时完整复制该行的分组调用名，不自行改动编码。账户授权与 Key 分组限制仍然生效，目录公开不代表任意账户有权调用所有分组。价格以积分显示，专属价仅在本人登录后可见。

77 / 77 个模型

同一路径不代表同一组参数；请进入每行的规格章节。目录更新时间：2026-11-06。

没有匹配的当前模型。

语言模型：Chat Completions

本节适用于全量模型目录中标记为“语言”的模型。API Base URL 为 https://uutoken.sbs，完整路径 POST /v1/chat/completions；需要在 SDK 中填写带版本的 base_url 时使用 https://uutoken.sbs/v1，不要再重复拼接 /v1。

请求头为 Authorization: Bearer sk-your-api-key 和 Content-Type: application/json。model 必须是目录中的准确原模型名，或者账户已授权分组的完整分组调用名；原模型名继续兼容，分组调用名只用于明确指定该分组。

curl https://uutoken.sbs/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"你好"}],"stream":false}'

同步结果读取 choices[].message.content。流式请求设置 stream=true，按 SSE 的 data: 事件读取 choices[].delta，直到 [DONE]。多模态、工具调用、推理参数和最大上下文取决于具体模型；语言模型不使用视频的任务轮询接口，也不自动等同于 /v1/responses、Anthropic 原生 Messages 或 Gemini 原生协议。

目录中的语言模型价格为公开输入、输出积分/百万 token，已按该行分组倍率计算；缓存、附加能力和账户专属价以登录后的模型广场与最终使用日志为准。更换分组不等于更换账号余额。

当前 Seedance 模型规格

以下是本站当前已适配的独立规格，不把“同属 Seedance”当成参数相同。统一通过 POST /v1/videos 创建、GET /v1/videos/{task_id} 查询、GET /v1/videos/{task_id}/content 下载，使用同一把本站 API Key。

Seedance 2.0 G3：4–15 秒

seedance-2.0-g3 和兼容调用名 sd2.5-720-933 当前均为 2.0 规格：720p、4–15 秒，默认 5 秒；最多 9 张图片、3 段视频、3 段音频。兼容调用名保留是为了不影响旧客户端，不表示该模型仍为 2.5。

使用 JSON。images、videos、audios 传公开 HTTP(S) URL 数组，不能用本地路径或裸 Base64。显式提供 seconds、resolution、aspect_ratio；同义时长/分辨率字段同时提供时必须一致。size 在此只兼容分辨率名，不是像素宽高。

Seedance 2.5 G：分辨率与参考视频分档

seedance-2.5-G：480p / 720p、4–30 秒，默认 5 秒；最多 30 张图片、10 段视频、10 段音频。JSON 的 images、videos、audios 均使用公开 HTTP(S) URL。参考视频是否存在会影响单秒价格；不能把有视频请求按无视频档计算。

Seedance 2.5 高并发：三档按秒

规格核对：2026-11-07。本节只适用于 seedance2.5高并发，不要套用其他 Seedance 型号的参数。

通过 POST https://uutoken.sbs/v1/videos 创建任务，使用本站 API Key。支持文生视频，以及图片、视频、音频参考；三类参考素材可以在同一个请求中同时提供。JSON 使用公网 HTTPS 文件直链，也支持 multipart 上传本地文件。

参数、默认值与素材限制

三类参考素材可以混传，但没有公开的跨类型素材总数上限，不能据此承诺 30 张图片、10 段视频和 10 段音频同时用满一定成功。纯音频参考在本站可解析转发，但尚未完成独立音频参考的实际生成验证，不承诺其实际生成效果。

JSON 中的素材链接必须能在公网直接下载，不能依赖登录、Cookie 或浏览器页面；建议使用有效期至少 1 小时的签名链接。本机路径、blob:、data: 和 Base64 不能当作该模型的 JSON 素材 URL。若只有本地文件，使用下方 multipart 方式。

首尾帧、输出声音与不支持的参数

价格与按秒计费

费用 = 生成视频秒数 × 对应分辨率单价。参考图片、视频、音频不额外增加计费秒数；例如生成 720p、5 秒，即使参考视频共 20 秒，公开价仍为 1.95 积分。本站此模型当前分组倍率为 1；账户专属价以本人登录后的报价和最终使用日志为准。

接入价格接口时识别 /api/pricing 中本模型条目的 billing_mode=tiered_expr、billing_expr；用量定义位于 billing_usage_schema.seconds 和 billing_usage_schema.resolution，示例值位于 billing_usage_examples[].facts。不要只根据 quota_type 或 model_price 推断为按条收费。

JSON：图片、视频、音频同时参考

把 sk-your-api-key 换成本站 Key，把示例素材替换为自己可直接下载的 HTTPS 文件链接。以下素材地址是占位示例，不能原样用于生成。仅文生视频时删除三个素材数组即可。

curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance2.5高并发",
    "prompt": "参考图片保持角色形象，参考视频的动作，参考音频的节奏，生成连贯的写实短片",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "omni_reference_task_type": "reference",
    "image_refs": ["https://media.example.com/character.jpg"],
    "video_refs": ["https://media.example.com/motion.mp4"],
    "audio_refs": ["https://media.example.com/rhythm.mp3"]
  }'

multipart：直接上传本地参考文件

图片重复使用 input_image（或 input_reference），视频重复使用 input_video，音频重复使用 input_audio。每一类素材选择“上传文件”或“URL”其中一种；不同类别可以选择不同方式，例如上传图片、用 URL 提供视频和音频。

源服务公开的上传限制为：文件合计不超过 64 MB（超限报错中的阈值为 67108864 字节）、完整请求不超过 128 MB；同时须遵守本站请求入口的大小限制，收到 413 时改用 URL。此型号独立单文件上限未公开，不代表单文件大小无限制。不要手动设置 multipart 的 Content-Type，由客户端生成 boundary。

curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -F 'model=seedance2.5高并发' \
  -F 'prompt=参考图片保持角色形象，参考视频的动作和音频的节奏' \
  -F 'seconds=5' \
  -F 'resolution=720p' \
  -F 'aspect_ratio=16:9' \
  -F 'omni_reference_task_type=reference' \
  -F 'input_image=@./character.jpg' \
  -F 'input_image=@./scene.jpg' \
  -F 'input_video=@./motion.mp4' \
  -F 'input_audio=@./rhythm.mp3'

只上传图片、另外两类用 URL 时，把上例的 input_video、input_audio 文件字段替换为：

  -F 'video_refs=["https://media.example.com/motion.mp4"]' \
  -F 'audio_refs=["https://media.example.com/rhythm.mp3"]'

查询状态与下载成片

保存创建接口返回的 id，用创建任务的同一把本站 Key 每隔 3–8 秒查询。状态为 queued / in_progress 时继续等候，completed 后下载，failed 时读取 error。预计生成 5–15 分钟，实际以任务进度为准；高并发名称不代表不排队或固定完成时间。

curl --fail-with-body 'https://uutoken.sbs/v1/videos/YOUR_TASK_ID' \
  -H 'Authorization: Bearer sk-your-api-key'

curl --fail-with-body -L 'https://uutoken.sbs/v1/videos/YOUR_TASK_ID/content' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -o result.mp4

查询成功后也可读取 result_urls 中本站返回的完整成片地址，不自行拼接下载域名或路径。成片使用临时存储，完成后请及时下载。详见任务查询与结果下载。

常见参数错误

固定分辨率、图片必填与参考素材差异

这些固定分辨率模型不能通过把 resolution 换成别的档位来升级。Stable / special2 的旧兼容请求可能把时长钳制在 5–30 秒，2.0 fast / mini 会归到 5 / 10 / 15 秒；请直接按表内规格提交，不依赖自动纠正，更不要把提交的非支持档位当成实际输出。API 客户端应先把本地参考素材上传为可公开读取的 URL；不要把本机路径、Data URI 或文件二进制直接当成 URL。生成完成后读取接口返回的完整结果地址，或使用本站 content 接口，不拼接服务方地址。

curl https://uutoken.sbs/v1/videos \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.0-g3","prompt":"海边日落，镜头缓慢推进","seconds":5,"resolution":"720p","aspect_ratio":"16:9","images":["https://example.com/reference.jpg"]}'

灵境成品链接有效期

核对日期：2026-11-07。以下只适用于实际走灵境渠道的任务；多线路模型的其他渠道不套用此规则。

灵境成品不按本站镜像成品的固定 6 小时规则清理。用户上传到本站的参考图、参考视频和音频属于另一类临时素材，仍以上传响应的实际到期时间为准，不因成品链接的 24 小时签名而延长。

seedance2.5-Stable-1080p 完整接口

核对时间：2026-11-07。本节为此模型独立的接入说明，可直接提供给开发者或接入 AI。

准确调用名为 seedance2.5-Stable-1080p，位于“大客户专用2.5sd满血”分组。支持文生视频、图片参考及音频参考，固定输出 1080p、生成时长 5–30 秒、最多 9 张图片和 3 段音频，不支持参考视频。不使用高并发型号的素材字段，也不使用其按秒价格。

地址、鉴权与完整调用顺序

Base URL：https://uutoken.sbs。使用本站 API Key，所有本站接口均带 Authorization: Bearer sk-your-api-key。只需本站的公开模型名，不需要服务方模型 ID 或服务方 Key。若客户端已自动添加 /v1，不要在 Base URL 中重复填写。

请求参数与默认值

使用 Content-Type: application/json。本模型不支持 multipart/form-data 或表单文件直传；本地素材需先上传为公网可读取的文件链接，再作为 JSON 字段提交。

请直接传合法的 5–30 秒整数。历史兼容实现会将小数四舍五入、越界值钳制到范围内，并优先读取 duration；不要依赖这些纠正行为，也不要把未生效的时长当作实际生成时长。一次请求创建一个视频任务，不使用 n 批量生成。

素材限制与容易传错的字段

推荐只使用本节列出的字段。未知参数可能被忽略，不要把“请求没有报错”当作参数已生效。纯音频参考在参数转换层可被接受，但未作独立音频参考的实际生成验证，不承诺仅传音频的生成效果。

计费：按条，不按秒

当前公开价为 4.85 积分/条，本分组倍率为 1。5 秒、15 秒、30 秒同一条价格，不乘生成秒数，也不按参考图片数量累乘。用户模型专属价仅作用于对应账户，以本人登录后报价和最终使用日志为准；不要把其他用户的专属价设为公开价。

客户端可从 GET /api/pricing 中按 model_name 精确匹配本模型；当前公开条目为 quota_type=1、model_price=4.85。这与高并发型号的 tiered_expr 按秒计费不同。查询、刷新下载地址、下载原任务不会重新创建生成任务或再次收取生成费。

示例一：纯文生视频

替换 sk-your-api-key 后提交。以下命令是接入示例，执行创建请求会实际生成并计费。

curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance2.5-Stable-1080p",
    "prompt": "海边日落，浪花轻拍沙滩，写实风格，镜头缓慢向前推进",
    "seconds": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

示例二：图片与音频共同参考

示例链接是占位地址，必须替换为自己可直接下载的素材。只需图片参考时删除 audios 字段即可；最多 9 个图片 URL、3 个音频 URL。

curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance2.5-Stable-1080p",
    "prompt": "保持参考图中的人物形象与服装，参考音频节奏，人物自然行走，写实风格",
    "seconds": 15,
    "resolution": "1080p",
    "aspect_ratio": "9:16",
    "images": [
      "https://media.example.com/character.jpg",
      "https://media.example.com/clothing.jpg"
    ],
    "audios": ["https://media.example.com/rhythm.mp3"]
  }'

media 素材写法与兼容字段

上例的 images / audios 可以替换为下面的 media 数组。role 必须填写，不要使用高并发型号省略角色的格式。

{
  "model": "seedance2.5-Stable-1080p",
  "prompt": "保持人物形象，参考音频节奏生成写实短片",
  "seconds": 5,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "media": [
    {"type": "image", "role": "reference_image", "url": "https://media.example.com/character.jpg"},
    {"type": "audio", "role": "reference_audio", "url": "https://media.example.com/rhythm.mp3"}
  ]
}

创建响应、查询状态与错误

创建成功响应的核心字段如下，id 为后续查询与下载使用的本站任务 ID；附加时间和进度字段可能随状态出现。不要使用内部服务方任务 ID。

{
  "id": "task_example",
  "object": "video",
  "model": "seedance2.5-Stable-1080p",
  "status": "queued"
}

curl --fail-with-body 'https://uutoken.sbs/v1/videos/task_example' \
  -H 'Authorization: Bearer sk-your-api-key'

建议每隔 3–8 秒轮询。单次 HTTP 429 / 5xx、网络超时或较长等待不等于原任务已失败；先退避并重查原 ID。只有最终状态为 completed 才下载，不能仅以 HTTP 200 判断生成成功。

成功查询响应示意如下。实际 video_url 必须原样使用，不根据示例生成自己的文件路径；客户端也不能要求本模型返回高并发型号的 result_urls 数组。

{
  "id": "task_example",
  "object": "video",
  "model": "seedance2.5-Stable-1080p",
  "status": "completed",
  "progress": 100,
  "video_url": "https://uutoken.sbs/tvod/task_example.mp4"
}

失败响应会包含 status:"failed" 与 error.message；客户端应展示具体信息，不统一改写成“余额不足”或“500”。提交阶段的参数 / 鉴权错误也可能直接以 HTTP 4xx 和 error 对象返回，此时应先修正请求，不进入任务轮询。

下载成片、链接有效期与刷新

curl --fail-with-body -L \
  'https://uutoken.sbs/v1/videos/task_example/content' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -o result.mp4

本站 content 接口可能返回视频字节（包括 Range 请求的 206），也可能重定向到实际下载地址。客户端需要兼容两种方式；不要把重定向当作生成失败。若直接下载查询返回的异域官方签名链接，不携带本站或服务方 Key；完整保留原 URL 的路径和签名参数。

本模型沿用官方源文件下载方式，不保存到本站其他渠道使用的临时视频镜像桶，因此不套用本站其他成品的 6 小时清理规则。

常见问题与处理

Image 2.5 Fast / Pro 图片接口

image-2.5-fast 和 image-2.5-pro 是图片模型，不是语言模型。文生图使用 POST /v1/images/generations，图片编辑使用 POST /v1/images/edits，两者均使用 JSON；最多 2 张参考图片，素材必须是公开 HTTP(S) URL，不接受 multipart / form 文件直传。

档位用 resolution=1k / 2k / 4k；比例用 aspect_ratio。支持比例包括 1:1、2:3、3:2、3:4、4:3、9:16、16:9、5:4、4:5、21:9、1.414:1、1:1.414，默认 1:1。像素 size 是兼容形式，应优先提供明确比例和档位，不把比例字符串误放进分辨率字段。

curl https://uutoken.sbs/v1/images/edits \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"image-2.5-fast","prompt":"保持参考主体，生成横向海报","resolution":"2k","aspect_ratio":"3:2","images":["https://example.com/reference.jpg"]}'

图片接口等待生成后返回 data[].url；不要按视频任务创建接口的格式解析。积分按本次输出档位结算，不沿用其他 gpt-image 型号的默认价或参考图数量限制。

gork 分组接入状态

本分组仍在接入检查中，暂无开放模型。以下 9 款尚未通过可用性验证，当前不会路由用户请求；不属于全量目录中的活跃模型。拟配置分组倍率为 0.3 倍，模型基础价只乘本站倍率一次；接入状态不代表可调用或已收费。

未开放型号

当前检查遇到服务限流、错误或无有效响应，需要恢复并完成验证后才会开放。媒体型号采用独立的 Chat 协议，不能套用 /v1/videos 或 /v1/responses；不能因为名称相似就沿用其他 Grok 视频章节的字段。

Seedance 视频通用协议

统一入口仅统一路径与任务生命周期，不代表各模型的时长、分辨率、参考素材或收费相同。先从全量模型目录找到准确公共模型名与分组调用名，再进入该行的专属章节；不要使用旧版示例中的泛称或推测模型 ID。

鉴权 Authorization: Bearer sk-your-api-key。建议 JSON，头为 Content-Type: application/json。Base URL 只填 https://uutoken.sbs，不要让客户端重复添加 /v1。

同义字段如 seconds 与 duration 同时提供时必须一致。多线路公共模型采用各线路共同支持的参数；只有具体章节明确支持时才使用 multipart、本地文件或 Base64，不能从其他模型照搬。

curl https://uutoken.sbs/v1/videos \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"mg-sd25-1-pro","prompt":"海边日落，镜头缓慢推进","seconds":5,"resolution":"720p","aspect_ratio":"16:9"}'

保存返回的 id / task_id，按状态轮询，只有成功后再下载。失败以接口中的错误详情为准，HTTP 请求成功接收不等于视频生成成功。任务查询、完成状态与结果下载。

sd2.5pp 分档视频

调用名仍为 sd2.5pp，支持 720p / 1080p、5–30 秒整数；两种分辨率同价。以下为倍率 1 的公开档位总价，不按秒累乘，专属价格与实际结算以当前账户目录为准。

例如 5 秒和 15 秒均为 5.5 积分，16 秒和 30 秒均为 7.9 积分；不接受 4 秒、31 秒或小数秒。省略时长时默认 5 秒。seconds 与 duration 选填其一；若同时填写必须相等。

创建仍为 POST /v1/videos，查询和下载继续使用本站返回的原任务 ID。支持普通参考图片最多 30 张、视频最多 10 段、音频最多 10 段；本模型不支持首尾帧语义。参考素材可用 images、videos、audios，也可使用下方的统一 references 数组，避免重复传入同一份素材。

curl 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "sd2.5pp",
    "prompt": "海边日出，镜头缓慢向前推进",
    "seconds": 16,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "references": [
      {"kind": "image", "data": "https://YOUR_MEDIA_HOST/reference.jpg"}
    ]
  }'

至少提供一份图片、视频或音频参考，不支持纯文生视频。将示例素材地址替换为真实可公开读取的文件直链，素材合计最多 50 份。multipart 客户端仍可通过 images、videos、audios 文件字段提交，文本字段保持相同，不要手动填写 multipart boundary。无参考素材会在本站提交前拒绝，不创建任务、不扣费。

mg-sd25-1-pro 参考视频

渠道已调整，公开调用名仍为 mg-sd25-1-pro，原分组调用名、分组与专属价保留。公开价格仍为 6.5 积分/条，不随 5–30 秒生成时长累乘。

参考素材使用可公开读取、不含账号密码的 HTTPS 文件直链。JSON 使用 reference_images、reference_videos、reference_audios 数组，或同义的 images、videos、audios；同一类只选一种字段，不重复提交。本站画布会将本地参考素材直传至临时对象存储，再以公链提交；上传失败不会创建生成任务。API 客户端不能将本地路径当作 URL，既有文件 / Data URL 兼容入口保留，但不等同于公链入口的真实素材出片验收。

curl 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "mg-sd25-1-pro",
    "prompt": "保留参考图主体，镜头平稳向前推进",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "reference_images": ["https://YOUR_MEDIA_HOST/reference.jpg"]
  }'

不需要额外的供应商请求头。本站会处理渠道鉴权和内部参数转换，不向客户端公布渠道地址。纯文生视频可不传参考数组。已有任务仍按原编号查询和下载，不要因为调整渠道重新创建历史任务。

curl 'https://uutoken.sbs/v1/videos/YOUR_TASK_ID' \
  -H 'Authorization: Bearer sk-your-api-key'
curl --fail --location 'https://uutoken.sbs/v1/videos/YOUR_TASK_ID/content' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -o result.mp4

查询或下载临时异常不代表生成失败。保存原任务 ID，恢复查询或下载，不要自动重复提交付费生成；跨域下载不得转发本站 Authorization。

HSS 2.0 933 渠道A

使用本站 POST /v1/videos 和自己的 API Key，以 application/json 提交公网 HTTPS 参考地址。无需额外供应商请求头。此模型至少需要一项图片、视频或音频参考，不支持纯文生视频。

以上为公开配置价，当前账户专属价与分组倍率以登录后的模型广场和画布费用预览为准；4 秒与 10 秒均为每条 1.3 积分（倍率为 1 时）。选择指定分组时，将模型广场复制的完整分组调用名原样传入 model，不要自行拼接。

图片、视频与音频混合参考

curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "hss-2.0-933-渠道A",
    "prompt": "参考主体、动作和音乐节奏，生成自然流畅的短片",
    "seconds": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "images": ["https://assets.example.com/person.jpg"],
    "videos": ["https://assets.example.com/motion.mp4"],
    "audios": ["https://assets.example.com/music.mp3"]
  }'

示例媒体地址仅为占位符，请替换成自己的公开可下载素材。可仅保留图片、视频或音频其中任意一种；每类及合计数量均不得超限。本站画布可先将本地素材上传至临时对象存储，再以符合上述限制的 HTTPS 链接提交；上传失败或账号失效时不继续创建生成任务。API 客户端仍须使用本节规定的 URL 字段，其余模型遵循各自的素材限制。

查询与下载

保存创建响应中的本站任务 id。任务状态为 queued、in_progress、completed 或 failed，失败时保留任务 ID 联系支持；不要重复提交生成请求代替查询。

TASK_ID='替换为创建响应中的id'
curl --fail-with-body "https://uutoken.sbs/v1/videos/$TASK_ID" \
  -H 'Authorization: Bearer sk-your-api-key'

# 仅在 status 为 completed 后下载
curl --fail-with-body "https://uutoken.sbs/v1/videos/$TASK_ID/content" \
  -H 'Authorization: Bearer sk-your-api-key' \
  --output video.mp4

查询使用 GET /v1/videos/{task_id}，结果下载使用 GET /v1/videos/{task_id}/content，均保留本站地址和本站 Key。结果有效期由渠道决定，本站不额外长期保存。

Seedance 2.0 满血

本模型使用本站 POST /v1/videos，以 application/json 提交公开可下载的媒体 URL；不要套用下方通用 multipart 或 Data URI 示例。查询和下载继续使用本站任务 ID 与自己的 API Key。

以上为公开配置价；当前账户专属价与分组倍率以登录后的模型广场及画布费用预览为准。按秒模型 4 秒预计 1.248 积分，15 秒预计 4.68 积分（倍率为 1 时）。若选择了明确分组，可将模型广场复制的完整分组调用名原样放入 model，不要自行拼接。

文生视频

curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "Seedance-2.0-full",
    "prompt": "海边日落，镜头缓慢推进",
    "seconds": 5,
    "resolution": "1080p",
    "ratio": "16:9"
  }'

首帧或首尾帧

curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "Seedance-2.0-full",
    "prompt": "从首帧自然过渡到尾帧",
    "seconds": 5,
    "resolution": "1080p",
    "ratio": "16:9",
    "first_frame": "https://uutoken.sbs/your-public-media/first.jpg",
    "last_frame": "https://uutoken.sbs/your-public-media/last.jpg"
  }'

只用首帧时删除 last_frame。示例媒体路径是占位符，必须替换为真实公开可下载的素材，不能直接照抄。

图片、视频、音频参考

curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "Seedance-2.0-full",
    "prompt": "参考主体、动作与音乐节奏生成短片",
    "seconds": 5,
    "resolution": "1080p",
    "ratio": "16:9",
    "images": ["https://uutoken.sbs/your-public-media/person.jpg"],
    "videos": ["https://uutoken.sbs/your-public-media/motion.mp4"],
    "audios": ["https://uutoken.sbs/your-public-media/music.mp3"]
  }'

本站托管画布可先将本地素材上传至临时对象存储，再通过 URL 提交；上传失败或账号失效时不继续创建生成任务。直接填写的素材 URL 仍受本模型的同源与安全限制，API 客户端不要将本地路径或 blob 字符串当作 URL。生成结果使用 GET /v1/videos/{task_id} 查询，完成后通过 GET /v1/videos/{task_id}/content 下载。不要重复提交生成请求代替查询，结果有效期由渠道决定，本站不额外长期保存。

SD 2.5 官渠折扣：480P / 720P / 1080P 按秒

以下三个型号使用本站 POST /v1/videos 创建任务，再用 GET /v1/videos/{task_id} 查询。Base URL 为 https://uutoken.sbs，不要重复添加 /v1。

分组倍率为 1 时，费用为请求秒数乘以对应每秒价格；当前账户专属价与实际可用分组以登录后的模型广场为准。每次生成一条，不支持批量 n > 1。

metadata.payload 内的参数

图片、视频和音频混合参考

curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "sd2.5-gf-720p",
    "prompt": "保持参考主体一致，参考动作与音乐节奏生成流畅短片",
    "duration": 5,
    "metadata": {
      "payload": "{\"aspectRatio\":\"16:9\",\"mode\":\"references\",\"imageUrls\":[\"https://assets.example.com/person.jpg\"],\"videoUrls\":[\"https://assets.example.com/motion.mp4\"],\"audioUrls\":[\"https://assets.example.com/music.mp3\"],\"bypassCopyrightReferenceLevel\":0.7}"
    }
  }'

纯文生视频时删除 imageUrls / videoUrls / audioUrls 即可。不要将示例素材地址直接当作真实素材提交。

首尾帧示例

{
  "model": "sd2.5-gf-480p",
  "prompt": "从首帧自然过渡到尾帧，主体保持一致",
  "duration": 5,
  "metadata": {
    "payload": "{\"aspectRatio\":\"9:16\",\"mode\":\"frames\",\"firstFrameUrl\":\"https://assets.example.com/first.jpg\",\"lastFrameUrl\":\"https://assets.example.com/last.jpg\",\"bypassCopyrightReferenceLevel\":0.7}"
  }
}

查询与官方下载链接

curl --fail-with-body 'https://uutoken.sbs/v1/videos/task_xxx' \
  -H 'Authorization: Bearer sk-your-api-key'

保存创建响应中的本站任务 ID；每 3–5 秒查询一次，完成或失败后停止。完成后的 video_url 是官方对象存储的签名下载链接，原样下发，不改写签名、不经过本站媒体代理、不在本站缓存成片。链接会到期，请及时下载。

curl --fail --location '查询结果中的完整 video_url' -o result.mp4

dreamina-seedance-2-5

创建、查询及下载均使用本站域名 https://uutoken.sbs，每一步均携带自己的 API Key。此模型固定输出 720p，按秒计费，公开价格为 0.45/秒；已配置账号专属价的用户以本人登录后模型广场显示的价格为准。

JSON 创建任务

export API_KEY='sk-your-api-key'
curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "dreamina-seedance-2-5",
    "prompt": "海边日落，镜头缓慢推进",
    "seconds": 5,
    "aspect_ratio": "16:9"
  }'

需要混合参考时，在 JSON 中增加 "images": ["https://example.com/reference.jpg"]、"videos": ["https://example.com/motion.mp4"] 或 "audios": ["https://example.com/music.mp3"]。这些地址是你提供的输入素材，必须可被服务端读取；不要把示例地址当作真实素材。

本地参考文件上传

curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H "Authorization: Bearer $API_KEY" \
  -F 'model=dreamina-seedance-2-5' \
  -F 'prompt=让参考图中的主体自然运动' \
  -F 'seconds=5' \
  -F 'aspect_ratio=9:16' \
  -F 'images=@reference.jpg;type=image/jpeg'

多个文件可重复传入同名字段；视频、音频文件分别使用 videos=@motion.mp4、audios=@music.mp3。单文件不超过 20 MiB；multipart 请求不要手动设置 Content-Type，交给客户端生成 boundary。

查询与下载

创建成功后保存响应中的 id，后续使用这个本站任务 ID，不要改用素材地址或其他 ID。状态通常为 queued、in_progress、completed、failed；失败时检查 error.message。

TASK_ID='替换为创建响应中的id'
curl --fail-with-body "https://uutoken.sbs/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY"

# 仅当 status 为 completed 时下载；保持使用本站路径
curl --fail-with-body -L "https://uutoken.sbs/v1/videos/$TASK_ID/content" \
  -H "Authorization: Bearer $API_KEY" \
  --output video.mp4

建议每隔 3–5 秒查询一次，不要重复提交同一生成请求。计费按请求时长预扣，完成后若有有效的实际时长则按实际时长结算。生成完成后请及时下载，结果有效期由渠道决定，本站不额外长期保存。

Seadanco 2.5 480P / 720P 按秒模型

curl --fail-with-body 'https://uutoken.sbs/v1/videos' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seadanco2.5-480-second",
    "prompt": "生成一段自然流畅的风景短片",
    "seconds": 5,
    "ratio": "16:9"
  }'

# 使用创建响应的本站 id 查询任务，建议间隔 20 秒；失败或限流时退避。
curl --fail-with-body "https://uutoken.sbs/v1/videos/$TASK_ID" \
  -H 'Authorization: Bearer YOUR_API_KEY'

# status 为 completed 后下载；始终使用本站地址和自己的 Key。
curl --fail-with-body -L "https://uutoken.sbs/v1/videos/$TASK_ID/content" \
  -H 'Authorization: Bearer YOUR_API_KEY' --output video.mp4

Wan 系列视频接口

下列模型均使用本站的异步视频任务接口：创建任务后保存任务 ID，轮询查询，完成后下载。Base URL 只填写 https://uutoken.sbs，不要额外加 /v1。

wan-3.0-prime：两档按秒计费

一个模型通过 resolution 选择两档价格，不需要更换模型名。按输出视频秒数计费，参考视频不额外收费。平均约 300 秒出片仅供参考，实际以任务进度为准。

建议显式提交 seconds 和 resolution。本站适配器默认值为 5 秒、720p、16:9；这些是本站请求默认值，不代表上游完整能力范围。兼容时长字段 duration；若与 seconds 同传，两者必须一致。不要把其他 Wan 模型的素材数量上限或画幅范围直接套用到本模型。

• 参考素材使用公开 HTTPS 文件 URL：images、videos、audios 数组；兼容 image_refs、video_refs、audio_refs 和相应 reference_* 字段。也可使用 media 数组，每项填写 type（image/video/audio）和 url。不要重复提供内容冲突的别名字段。
• 不支持 size；分辨率用 resolution，画幅用 aspect_ratio 或 ratio。本地文件、Data URI 和裸 Base64 先上传为公开 HTTPS URL；不要把文件二进制直接附到创建请求。
• 此处未声明素材数量上限、时长上限或完整画幅清单，避免将未经确认的上游能力写成承诺；实际提交仍须满足模型服务的校验。

720p / 5 秒调用示例

curl https://uutoken.sbs/v1/videos \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-3.0-prime",
    "prompt": "海底珊瑚缓缓摇摆，镜头平稳推进",
    "seconds": 5,
    "resolution": "720p"
  }'

现有 Wan 视频模型区别

价格表展示普通公开价格，账户专属价格及最终可用分组以模型广场为准。wan3-Prime 只支持 720p/1080p，不要因其他模型支持 480p 而提交 480p。

参数与素材格式

• 推荐使用 JSON：model、prompt、seconds、resolution、aspect_ratio；duration 是时长兼容字段，ratio 是画幅兼容字段。相同含义的字段同时传入时必须一致。
• wan3-Prime 与 wan3.0-超限 支持 16:9、9:16、1:1；Wan3快速版 另支持 4:3。这三个模型默认画幅均为 16:9。
• 这三个现有模型的参考素材推荐使用 images、videos、audios URL 数组。Wan3快速版 要求公开 HTTPS 文件 URL；另外两个模型接受 HTTP(S) URL。不支持把本地路径或裸 Base64 当作 URL 提交。
• multipart 仅可传表单字段与公开素材 URL，不可直接附加二进制文件；本地文件先上传取得可公开访问的素材 URL。不要将其他章节的直传文件示例套用到这些模型。

wan3-Prime 多素材示例

curl https://uutoken.sbs/v1/videos \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3-Prime",
    "prompt": "参考主体、镜头动作和节奏生成自然流畅的短片",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "images": ["https://example.com/reference.jpg"],
    "videos": ["https://example.com/reference.mp4"],
    "audios": ["https://example.com/reference.mp3"]
  }'

任务查询与下载

curl https://uutoken.sbs/v1/videos/task_xxx \
  -H "Authorization: Bearer sk-your-api-key"

curl -L https://uutoken.sbs/v1/videos/task_xxx/content \
  -H "Authorization: Bearer sk-your-api-key" \
  -o result.mp4

仅在状态为 completed/SUCCESS 后下载。使用本站返回的公开结果地址或上面的本站下载接口，不拼接服务方地址；结果可用期以平台返回为准，完成后请及时下载。

Grok 1.5 历史视频协议示例（当前未开放）

Grok 1.5 两个视频模型，均使用异步视频任务。grok-imagine-video-1.5 必须传 1 张参考图（不支持纯文生）；grok-imagine-1.5-video 支持文生视频和多参考图。当前提交图片走 JSON + data URI（本地图请压缩为 JPEG 转 data URI），不走 multipart。

比例与 size 对应

请求字段

文生视频（grok-imagine-1.5-video）

curl https://uutoken.sbs/v1/videos \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.5-video",
    "prompt": "一辆跑车穿过雨夜城市街道，霓虹灯反射，电影感运镜",
    "seconds": "6",
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

单图 / 多图 data URI

curl https://uutoken.sbs/v1/videos \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.5-video",
    "prompt": "让参考图中的人物自然转身并向镜头走来，画面清晰稳定",
    "seconds": "10",
    "aspect_ratio": "9:16",
    "size": "720x1280",
    "resolution": "720p",
    "images": ["data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."]
  }'

聚合生图模型

以下图片模型使用本站统一的图片接口，Base URL 为 https://uutoken.sbs，鉴权使用本站 API Key。模型广场分组显示为“聚合生图组”；已有 gpt生图组 权限的 Key 继续可用，无需重建 Key。

可用模型与价格

价格单位为积分/张，单价四舍五入保留至小数点后 4 位。费用按请求的 n（或 count）和所选参数档位计算；失败或部分成功请求的最终费用以任务日志结算记录为准。下表未列出的模型参数不会改变该模型标示的单张价。

GPT Image 2.6 Flare / Sunburst

gpt-image-2.6-flare 与 gpt-image-2.6-sunburst 都在聚合生图组，统一 0.0310 积分/张；下表支持的画幅、分辨率和质量选项不另加价。一次请求费用按图片数量计算，例如 n=2 预估为 0.0620 积分，失败或部分成功按最终日志结算。

文生图：POST https://uutoken.sbs/v1/images/generations；图编辑/多图融合：POST https://uutoken.sbs/v1/images/edits。两者都使用本站 Key，都是等待完成后返回图片的同步接口，不是视频任务轮询接口。

gpt-image-2.6-flare：比例 × 分辨率

gpt-image-2.6-sunburst：比例 × 分辨率

两款模型的文生图示例

POST /v1/images/generations，请求头 Authorization: Bearer sk-your-api-key 与 Content-Type: application/json。

{
  "model": "gpt-image-2.6-flare",
  "prompt": "清晨山湖的自然风光，写实摄影",
  "n": 1,
  "aspect_ratio": "3:2",
  "resolution": "2K",
  "quality": "medium",
  "response_format": "url"
}

POST /v1/images/generations，请求头 Authorization: Bearer sk-your-api-key 与 Content-Type: application/json。

{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "明亮的现代建筑外景，写实摄影",
  "n": 1,
  "aspect_ratio": "16:9",
  "resolution": "4K",
  "response_format": "url"
}

多参考图编辑（JSON）

以下 reference-example-*.png 仅为占位地址，请替换为你的可读取素材 URL；也可改传 Data URI 或使用 multipart 文件上传。

POST /v1/images/edits，请求头 Authorization: Bearer sk-your-api-key 与 Content-Type: application/json。

{
  "model": "gpt-image-2.6-flare",
  "prompt": "结合两张参考图的主体与配色，保持主体特征",
  "mode": "multi-reference",
  "images": [
    "https://uutoken.sbs/reference-example-1.png",
    "https://uutoken.sbs/reference-example-2.png"
  ],
  "n": 1,
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "response_format": "url"
}

multipart 多图编辑示例：不手动设置 Content-Type，让客户端生成 boundary。

curl "https://uutoken.sbs/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=gpt-image-2.6-sunburst" \
  -F "prompt=结合两张参考图，生成统一风格的画面" \
  -F "mode=multi-reference" \
  -F "aspect_ratio=16:9" \
  -F "resolution=2K" \
  -F "n=1" \
  -F "image[]=@reference-1.jpg" \
  -F "image[]=@reference-2.jpg"

本站成品返回

成功返回 created 与 data[].url，示例结构如下（任务名为占位值）。读取接口实际返回的完整 URL 下载，不要自行拼接上游地址。成品地址统一使用本站域名；可能有有效期，请及时保存。

{
  "created": 1793952000,
  "data": [
    {"url": "https://uutoken.sbs/v1/tasks/task_example/artifacts/image-1/content"}
  ]
}

统一图片生成

文生图使用 POST /v1/images/generations。请求体兼容 OpenAI Images，model 填上表 API model。n 与兼容字段 count 表示请求生成数量，取值 1–50；不同模型可能有更低的数量限制。

curl "https://uutoken.sbs/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "prompt": "清晨山间的玻璃温室，柔和自然光，写实摄影",
    "n": 1,
    "size": "2K",
    "aspect_ratio": "16:9"
  }'

图生图和图片编辑使用 POST /v1/images/edits，可用 multipart 上传图片，也可在 JSON 中传公网图片 URL 或 Data URI。上传图片张数不得超过对应模型的参考图片上限；MJ 不接受参考图。

curl "https://uutoken.sbs/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=gpt-image-2" \
  -F "prompt=保留主体特征，将背景改成秋日森林" \
  -F "n=1" \
  -F "image[]=@reference.jpg"

参数规则

返回格式

/v1/images/generations 与 /v1/images/edits 都是同步图片接口：请求完成后直接返回 OpenAI Images 格式的 created 和 data[]，每项优先读取本站域名下的 url。该调用不返回供客户端轮询的图片 task_id；不要用视频任务查询路径查询图片请求，也不要因等待时间较长而重复提交。

{
  "created": 1793793600,
  "data": [
    {
      "url": "https://uutoken.sbs/..."
    }
  ]
}

失败时检查响应体中的 error；只有返回图片结果的字段存在且有效时才视为成功。结果 URL 可能有有效期，不要将示例 URL 当作固定地址。

图片通用协议与当前模型

当前图片模型以全量目录中的“图片”条目为准。目录明确列出公共模型名与对应规格章节；gemini-3-pro-image、gemini-3.1-flash-image 在本站使用 OpenAI Images 兼容接口，不需要自行添加 -preview 后缀，也不从旧示例推测 Gemini 原生路径。

两者使用 Authorization: Bearer sk-your-api-key。JSON 头为 Content-Type: application/json；multipart 不手动设置 Content-Type，让客户端生成 boundary。图片接口是同步兼容协议，不能把视频的 task_id 查询流程直接套用，也不要自行请求未声明的 /v1/images/generations/{task_id}。

nano 生图组：准确公共模型名

gpt-image-2.0、gpt-image-2.0-original、gpt-image-2.5-original、gpt-image-2.5-flare、gpt-image-2.5-sunburst、nano-banana-2.1、nano-banana-3-pro、nano-banana-3.1-flash、seedream-5-pro、mj-v8.2 均使用本站 Images 兼容入口。型号名称中的 original / flare / sunburst 不能省略；带 -aggregate 的公共模型是另一个目录条目。

最小文生图请求如下；分辨率、比例、图片数量与参考素材支持范围按模型广场和对应模型返回校验，不能套用其他厂商或 2.6 型号的尺寸矩阵。多图编辑前确认具体模型支持的模式。

curl https://uutoken.sbs/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2.5-flare","prompt":"一张明亮的城市风景照片","n":1}'

聚合生图组与 Image 2.5

聚合生图组的 12 款图片模型、计价与素材格式；2.6 Flare / Sunburst 的独立尺寸、分辨率和多参考图约束；image-2.5-fast / image-2.5-pro 的公开 URL、档位和比例约束。聚合生图组是显示名称，分组调用名中的内部标识保持兼容，不要手工替换编码。

成功结果读取 data[].url 或接口实际提供的 data[].b64_json；按完整返回地址下载，及时保存在自己的设备。生成参数与积分结算以具体模型和账户为准，不在客户端把积分再次换汇。

Omni 视频接口（gemini-omni-flash）

请求字段

首帧参考

{
  "model": "gemini-omni-flash",
  "prompt": "Keep the character identity and create a smooth cinematic motion",
  "seconds": 8,
  "size": "720x1280",
  "aspect_ratio": "9:16",
  "images": ["https://example.com/first-frame.jpg"]
}

风格图 + 源视频

{
  "model": "gemini-omni-flash",
  "prompt": "Follow the style reference and the motion rhythm of the source video",
  "seconds": 10,
  "aspect_ratio": "16:9",
  "style_references": ["https://example.com/style.jpg"],
  "input_video": "https://example.com/source.mp4"
}

sora933 视频接口

请求字段

单素材用单数字段，多素材用复数字段；只使用上表字段。素材 URL 必须能被服务器公网访问。

限制

• 图片最多 9 张；视频最多 3 个，单条 2–15 秒，总时长 ≤ 15 秒；音频最多 3 个，单条 2–15 秒，总时长 ≤ 15 秒。
• 使用音频参考时至少传 1 张参考图。

文生视频

curl -X POST "https://uutoken.sbs/v1/videos" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-v3-933-pro",
    "prompt": "雨夜霓虹街道，镜头缓慢推进，电影感光影",
    "seconds": "10",
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

图 + 音频混合

{
  "model": "sora-v3-933-pro",
  "prompt": "保持人物外貌一致，并参考音频节奏生成对应画面",
  "seconds": "10",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "image_url": "https://example.com/input-image.jpg",
  "audio_url": "https://example.com/reference-audio.mp3"
}

multipart 时图片仅用 image_url/image_urls，视频仅用 video_url/video_urls，音频仅用 audio_url/audio_urls，可重复复数字段名上传多文件。

Kling 视频接口（V3 / O3）

• kling-v3 只支持首帧和可选尾帧（尾帧必须与首帧一起传），不支持普通多图、参考音频或源视频。
• kling-o3 支持普通图片参考、首尾帧或 1 个源视频；首尾帧不能与普通图片或源视频同时使用。
• kling-o3 使用源视频时普通参考图最多 4 张，且不能用 4K；audio 仅表示结果音轨开关，不是音频输入。

请求字段

kling-v3 首尾帧

{
  "model": "kling-v3",
  "prompt": "Continue the motion smoothly from the first frame to the last frame",
  "seconds": 10,
  "size": "1280x720",
  "start_frame": "https://example.com/first-frame.jpg",
  "end_frame": "https://example.com/last-frame.jpg"
}

kling-o3 源视频参考

{
  "model": "kling-o3",
  "prompt": "Use the source video motion and generate a cleaner cinematic result",
  "seconds": 8,
  "size": "1920x1080",
  "input_video": "https://example.com/source.mp4",
  "reference_images": ["https://example.com/subject.png"]
}

图片建议用 .jpg/.jpeg/.png/.webp 公网 HTTPS URL；视频建议 MP4/MOV/WebM。首尾帧不要放进 images 数组，用 start_frame/end_frame。

通用：请求格式与本地文件上传

网关提供以下两类素材提交入口，但不代表每个模型都支持相同格式、字段或素材数量。具体模型章节优先于本节通用示例；sd2.5pp 与 mg-sd25-1-pro 请按各自章节提交。

multipart 字段识别（仅限对应型号明确支持时）

• 图片：image、images、reference_images、reference_image_urls、start_frame、end_frame、image_reference、input_reference
• 视频：video、videos、reference_videos、video_references、input_video
• 音频：audio、audios、reference_audios、audio_references
• 多素材可重复同一字段名（如多个 images、多个 audios）；非标准 file 字段按文件类型自动归入 images/videos/audios。
• 已知媒体字段按原字段解析，不重复补同类型字段，避免参考素材被重复计数。

以下示例使用 multipart 文本字段携带一张公开 HTTPS 图片 URL，不是本地文件上传示例。请替换示例地址；本地文件能否直传须按具体型号章节确认，不要将 URL 字段改成文件后假定所有通道都支持。通道要求 JSON 时，请按该型号章节使用 JSON + 公链。

curl https://uutoken.sbs/v1/videos \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=seedance-2.0-g3" \
  -F "prompt=根据参考图片生成一段视频" \
  -F "seconds=5" -F "aspect_ratio=16:9" -F "resolution=720p" \
  -F "images=https://assets.example.com/reference.jpg"

部分模型只接受 JSON + 公网 URL，或只接受固定字段；Data URI、Base64 和本地文件上传仅在对应模型章节明确支持时使用。历史 Grok 示例不代表当前开放能力。本地路径 C:\x.mp4、/Users/x.mp4、file:// 不能直接当 URL。

任务查询与下载

创建返回

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "mg-sd25-1-pro",
  "status": "queued",
  "progress": 0
}

查询 GET /v1/videos/{task_id}

curl https://uutoken.sbs/v1/videos/task_xxx \
  -H "Authorization: Bearer sk-your-api-key"

建议每 3–5 秒轮询，成功或失败后停止。

下载 GET /v1/videos/{task_id}/content

curl -L https://uutoken.sbs/v1/videos/task_xxx/content \
  -H "Authorization: Bearer sk-your-api-key" \
  -o result.mp4

使用查询结果中的视频内容 URL，或按对应型号说明请求 GET /v1/videos/{task_id}/content。下载方式与有效期以对应模型及实际任务返回为准；内容接口不代表永久存储。临时缓存或源结果可能过期，也可能受容量清理影响，请任务完成后及时下载；已不可用的结果不保证能够恢复。

通用：渠道任务插件

已安装并启用的异步任务插件可使用通用任务接口。提交时路径中的 {pluginKey} 使用插件 key；请求体必须包含 model，其他参数由所选插件定义。

提交 POST /v1/tasks/{pluginKey}

curl https://uutoken.sbs/v1/tasks/example-plugin \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"example-model","prompt":"..."}'

查询与产物

灵境来源的成品请同时阅读链接签名、续签与文件保留说明；不要把签名有效期当成文件保留期。

优先使用产物列表实际返回的 content_url，不要自行拼接下载地址。下载方式、链接有效期和临时缓存策略以具体型号及任务响应为准，不保证永久保存；过期或容量清理后可能无法下载。插件自定义查询或图片响应应按对应模型章节处理，不能仅凭本节推定所有自定义媒体字段都经过相同的链接改写。

错误码与接入检查清单

接入检查清单

1. baseURL 是否只填 https://uutoken.sbs
2. 创建 / 查询 / 下载是否为 POST /v1/videos、GET /v1/videos/{task_id}、GET /v1/videos/{task_id}/content
3. 图片是否使用对应型号章节指定的接口；当前目录中的 Gemini 图片型号走 Images 兼容协议：生成 POST /v1/images/generations、编辑 POST /v1/images/edits，不要仅凭型号名称改用 /v1beta
4. model 是否原样使用模型广场 API 模型 ID
5. seconds/duration、resolution/size 是否在模型支持范围
6. 参考素材的字段、类型与数量是否符合对应型号章节；优先使用该型号支持的公网 HTTPS URL，Data URI、Base64 和 multipart 文件只在该型号明确支持时使用，不要在不同型号之间直接套用素材字段
7. 创建后是否保存 id/task_id，并在完成后再下载