从灵感，到作品。

UPDATED · 2026-10-22

最近更新

本轮已开放Omni更多4/6/8/10秒组合、Veo Lite/Fast原生8秒双帧与多图素材、Nano两种模型的有序参考和批量，以及Muse的2:3、3:2单图编辑。Spark支持原生Responses及文字工具历史。完整可提交组合和金额以实时目录为准。

以下为已上线能力。网页和API共用账号、权限和余额；完整可提交组合及价格以下方实时目录为准。

Coinseed安全重试与费用状态说明 →

START HERE

快速开始

网页和 API 共用账号与余额。先确认模型、完整规格和账号权限，再选择对话、图片、视频、配音或超分。

结果保存方式不同

下面的动态清单列出正式目录内所有服务，包含暂未开放项。显示模型、价格或接口示例，不等于已经开放；网页和 API 都还要通过账号、Key与完整规格校验。

LIVE CAPABILITY CATALOG

全部模型与能力

本表从实时正式目录读取全部模型、输入方式、计费单位和开放范围。不同模型、输入数量、时长、方向、分辨率或超分方式不能任意组合；必须同时落在该服务当前允许的完整规格内。

正在读取全部服务与开放状态…

对话、原生同步媒体和后台任务的使用步骤见各模型章节。素材上传模型是配套权限，不是独立的生图或生视频产品。

YOUR ACCOUNT

账号、余额与 API Key

注册与开通

1. 在注册页创建账号，记录用户名；用户 ID 可在个人资料查看。
2. 按与管理员约定的渠道付款。闲鱼付款后提供订单号和本站账号，管理员核实到账，再开通客户模型权限并充值。
3. 打开钱包核对余额。使用充值码时，每个码只能兑换一次；兑换余额与模型权限开通是两件事。
4. 开通后重新登录创作台。页面仍显示“账号未开放”时，请提供用户 ID 联系管理员。

当前采用闲鱼收款、管理员核实到账后手工充值，暂不提供站内自助支付。付款前请确认本站用户 ID 与约定金额；充值后到钱包核对余额。付款或充值有疑问，请保留原订单号联系管理员，不要重复付款。

创建个人 API Key

1. 登录API Key 管理，新建一个专用 Key，例如“我的视频工具”。
2. 设置有效期、额度上限和需要的模型权限。H3 还需允许 coinseed-asset 素材上传模型。
3. 把 Key 保存到你的服务端环境变量。用 Authorization: Bearer YOUR_API_KEY 调用下面的接口。

无需向管理员提供密码、验证码或 API Key。发现 Key 泄露时，在密钥管理中禁用或删除旧 Key，再创建新 Key。不要把密钥写进网页源代码、公开仓库或分享链接。

使用 API Key 查询人民币余额

GET https://api.coinseed.net/api/usage/token/，使用自己的 API Key，无需网页登录，也不用传用户 ID。查询免费，不扣生成额度。先将 Key 保存到服务端环境变量 COINSEED_API_KEY：

curl --fail-with-body --silent --show-error \
  'https://api.coinseed.net/api/usage/token/' \
  -H "Authorization: Bearer $COINSEED_API_KEY"

成功响应节选：

{
  "code": true,
  "message": "ok",
  "data": {
    "currency": "CNY",
    "account_balance_cny": "7.30",
    "key_remaining_cny": "1.46",
    "key_used_cny": "0.73",
    "unlimited_quota": false
  }
}

金额字段是保留两位小数的字符串，客户端可直接显示 ¥7.30，无需自行换算点数。实际扣费仍使用精确额度，低于一分钱的余额可能显示为 0.00。账号余额与 Key 限额不能相加；新生成还需满足有效期和模型权限等条件。

旧字段 total_available、total_used、total_granted 保留原始内部额度单位，仅供兼容，不能直接当作人民币展示。客户端应检查 code: true、currency: CNY 和金额字段是否存在；缺少新字段表示服务端版本尚未支持，不能当作零余额。

此接口只返回 Key 所属账号的余额。额度用尽或已过期的 Key 仍可只读查询余额；明确禁用、已删除的 Key 或已禁用账号无法查询。这不会恢复生成权限。

查询频率与429处理

余额查询单独按已认证账号限流：每60秒最多60次，同账号多个Key共享，与登录、注册等敏感操作的20分钟窗口分开。全站API防滥用限流仍有效。建议客户端把同一账号的并发查询合并，短时缓存10–30秒，生成完成或充值后再刷新；不要每个模型分别轮询同一钱包。

遇到HTTP 429时读取Retry-After响应头或JSON的retry_after秒数，等待后再查。返回的message和error.message说明余额查询过于频繁；error.code为balance_rate_limited。保留上次已知余额并标注“暂未更新”，首次查询失败显示“暂时无法获取”，不要显示零余额、Key失效或未知错误，也不要立即循环重试。查询始终免费，不扣生成额度。

CREATOR WORKCOINSEED

网页生成与下载

1. 登录创作台，选择“对话”“图片”“视频”或“音频”，再选有权限的模型。独立超分从已开放的超分入口进入。
2. 填写文字，按该模型要求选择本人素材。只有已开放的选项可提交；不要用别的模型的参数替代。
3. 核对完整规格与预计费用，点击一次提交。对话和 MiniMax 同步媒体会在本页接收响应；H3、Muse 视频、Coinseed 和独立超分会取得后台任务号。
4. 异步任务：在“我的作品”或任务详情查询原单；完成后预览并下载原图、MP4或WAV。网页离开后，已受理的后台任务仍可继续。
5. 同步媒体：完整响应到达并解码后，在本页点击下载。对话可下载TXT。它们不自动进入后台作品库；刷新、关闭或换账号前请先保存。

提示词示例

生成结果可能随模型和随机性变化。更改内容、档位或主动重新生成是新的收费请求；重复下载已取得的同一文件不再收生成费。

H3 · COMMON CONTRACT

H3 单图参考视频

用一张参考图确定主体，再用文字描述动作和镜头。三个档位的请求结构相同；改变 model 即可选择档位。默认单图方式不变；测试档另有两条 视频参考完整规格 。质量档另有 6秒竖屏文字、首帧及首尾帧方式 。多图/max和参考音频已按H3新规格章节的完整组合开放。

POST/coinseed/v1/jobs

输出与参考精度

固定每单 1 个 MP4、24 FPS。输出名义时长为所选整数秒；帧对齐可能带来少量尾帧，例如选择 4 秒的作品实测约 4.46 秒，仍只按 4 秒计费。

基础参考图使用match精度；max只开放H3新增规格中明确列出的单图组合。步数、采样器、LoRA和任意宽高仍不可自定；同工作流2K/4K接续仅限超分章节的完整组合。参考图PNG/JPEG/WebP，服务端验证实际解码和尺寸。

先上传，再生成

POST/v1/videos

curl --fail-with-body --silent --show-error \
  'https://api.coinseed.net/v1/videos' \
  -H "Authorization: Bearer $COINSEED_API_KEY" \
  -F 'model=coinseed-asset' \
  -F 'file=@reference.jpg' \
  --output upload.json

首次上传响应由网关封装为标准任务回执，示例结构如下。先保存 upload.json 中的 id，并校验 object: "video"、model: "coinseed-asset" 和小写 status: "completed"。这里的 object: "video" 是接口封装类型，不表示上传文件是视频；首次 POST 响应不含 asset_task_id 或 kind。

{
  "id": "task_YOUR_UPLOAD_ID",
  "object": "video",
  "model": "coinseed-asset",
  "status": "completed"
}

提交 H3 前，建议用这个 id 查询素材任务，确认返回的 kind: "image"、asset_task_id 与保存的 id 一致，且任务已完成。若初次回执尚未完成，继续查询原任务，不重复上传。

GET/v1/videos/{id}

curl --fail-with-body --silent --show-error \
  'https://api.coinseed.net/v1/videos/task_YOUR_UPLOAD_ID' \
  -H "Authorization: Bearer $COINSEED_API_KEY" \
  --output uploaded-asset.json

确认是本人已完成的图片上传任务后，把最初保存的 id 放进生成请求的 asset_tasks。素材不能跨账号使用，也不能使用上游素材 ID 或公网图片 URL 替代。

{
  "model": "h3-custom1",
  "prompt": "以 <Picture 1> 为参考，蒸汽缓缓升起，镜头轻微推进，保持主体外观一致",
  "seconds": 6,
  "orientation": "landscape",
  "asset_tasks": [
    "task_YOUR_UPLOAD_ID"
  ]
}

curl --fail-with-body --silent --show-error \
  'https://api.coinseed.net/coinseed/v1/jobs' \
  -H "Authorization: Bearer $COINSEED_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @h3-request.json \
  --output submitted.json

将上面的 JSON 保存为 h3-request.json，替换上传任务号后运行。上传素材本身不收生成费；当前首张参考图已包含在基础生成价内。

H3 · H3-TEST

H3 测试

先用短片验证动作和构图，再决定是否换更高档位。 画质受参考图和提示词影响，更高档位不保证每次都得到更满意的结果。

计费公式：所选名义输出秒数 × 当前正式秒价。首张图包含；冷启动与对齐尾帧不加价。完整参数与上传方式见H3 通用契约，查询方式见异步任务与下载。

H3 · H3-CUSTOM1

H3 加速

在 768P 下平衡细节与生成耗时，适合常规制作。 画质受参考图和提示词影响，更高档位不保证每次都得到更满意的结果。

计费公式：所选名义输出秒数 × 当前正式秒价。首张图包含；冷启动与对齐尾帧不加价。完整参数与上传方式见H3 通用契约，查询方式见异步任务与下载。

H3 · STANDARD FRAMES

H3 文字、首帧与首尾帧

在创作台选择 H3质量，再选择输入方式。当前三种方式仅开放 6秒、竖屏768×1344、24fps、不叠加超分。使用标准FL2VA模型、20步，无LoRA。每单一个MP4，实测158帧约6.583秒，按所选6秒收费。

图片须为本人通过coinseed-asset上传完成的素材，规范化元数据尺寸为768×1344；可上传PNG、JPEG或WebP。首帧按拉伸处理，尾帧按中心裁剪处理。当前不接收其他图片尺寸、视频参考、音频参考或max精度组合。帧输入用于引导，最终内容受提示词影响。

POST/coinseed/v1/jobs

{
  "model": "h3-quality",
  "video_workflow": "fl2va_first_last",
  "prompt": "人物保持外观，向前走两步，镜头缓慢推进",
  "seconds": 6,
  "orientation": "portrait",
  "asset_tasks": ["task_MY_FIRST_FRAME", "task_MY_LAST_FRAME"]
}

文字方式改用fl2va_text和空数组；首帧方式改用fl2va_first并仅保留第一张图片。查询原任务使用 GET /coinseed/v1/jobs/{task_id}；本人通过 GET /v1/tasks/{task_id}/artifacts 获取下载入口。查询、重复下载和失败退款沿用统一任务流程；结果未知时保留原任务号，不重复提交。实时开放状态及价格以正式目录为准。

H3 · H3-QUALITY

H3 质量

使用更多推理步骤，适合对细节有更高要求的作品。 画质受参考图和提示词影响，更高档位不保证每次都得到更满意的结果。

计费公式：所选名义输出秒数 × 当前正式秒价。首张图包含；冷启动与对齐尾帧不加价。完整参数与上传方式见H3 通用契约，查询方式见异步任务与下载。

H3 · OWNED REFERENCES

H3 视频参考与音频状态

基础方式仍是一张参考图。扩展方式为单参考视频、或一张参考图加一个参考视频；只在下方列出的完整规格完成验收后开放。另有 质量档6秒竖屏的文字、首帧及首尾帧方式 ；多图/max和参考音频的新增完整规格见H3固定档与音频/多图章节。视频参考用于生成新内容，不承诺逐帧编辑原片。

首轮仅在实时目录明确列出时开放： H3测试、4秒横屏、原960×544交付 ，配一段规范化 768×1344、48帧、24fps、2秒 视频，可选加一张参考图。单视频和图加视频均按 4秒输出费＋2秒参考视频费 计价；首张图包含。秒价读取下方实时参考报价，不在本文固定写死。两条完整组合不能拆开交叉组合。其他输出时长/方向、视频尺寸/帧数、加速/质量档、两图、音频或超分不能在这两条旧规格中自由叠加，新增能力以H3新规格及超分章节为准。请核对上传后的reference_media；浏览器显示2秒不足以证明规格匹配。

视频可自带音轨，这两条旧规格只使用画面；使用原声须匹配另列的完整音视频规格；不承诺输出静音。参考用于引导环境与运动，不保证人物、机器人或主体保真，也不是逐帧编辑。实测图加视频保留主要人物与机器人；单视频主要保留森林环境，主体保真有限。

正在核对测试档参考价格与状态…

正在核对加速档参考价格与状态…

正在核对质量档参考价格与状态…

总价 = 输出名义秒数 × 档位秒价 + ceil(规范化视频帧数 ÷ 24) × 档位参考秒价。单张图片包含，当前开放组合的输入为2秒，且不得超过所选输出秒数；冷启动、下载与输出对齐尾帧不重复加价。按向上取整规则，49帧会落入3秒输入，但当前公开规格没有49帧，不能据此提交。源文件显示时长、浏览器 duration 或客户传入秒数不作为结算依据。

1. 图片及视频分别通过 POST /v1/videos multipart 上传：model=coinseed-asset、file=@clip.mp4。视频可为MP4 / WebM / MOV，不设本站文件体积上限；旧素材无新计量字段时须重新上传原件。
2. 保存上传返回的 id；用本人 Key 读取 GET /v1/videos/{id}，核对 completed、kind 与 reference_media.schema=coinseed.h3.reference-media.v1。视频元数据含规范化SHA、24fps、frames及核验时长；metadata不需要提交回服务器。
3. 把本人素材任务号填入下面示例。单视频只留视频任务号；图加视频第一项放图片。不能使用他人素材、上游 asset ID、文件路径或网址。

{
  "model": "h3-test", "prompt": "参考人物外观与视频中的动作，镜头缓慢推进",
  "seconds": 4, "orientation": "landscape",
  "asset_tasks": ["task_MY_IMAGE_UPLOAD", "task_MY_VIDEO_UPLOAD"]
}

提交入口 POST /coinseed/v1/jobs，账号需同时拥有该H3模型与coinseed-asset权限。新视频参考组合暂不叠加超分；原视频音轨不作为参考输入。查询、失败处理和下载沿用统一任务流程：结果未知时保留原任务号，不重复提交。

独立音频与视频原声已按下方实时完整组合开放，每段分别向上取整计费；0.03元/输入秒。原片声音占Audio 1，其余独立音频按槽位顺序绑定。不能把仅视频参考的旧规格直接增加任意音频。

COINSEED · ASYNC JOBS

参考素材、首尾帧与视频编辑

下述为 Coinseed 参考输入的接口约定；上传成功不代表相应生成方式已开放。参考图片和MP4先上传到coinseed-media-asset，完成后再用本人任务号引用；上传本身不收生成费。图片最多三张，PNG/JPEG/WebP不设本站文件体积上限；外部MP4不设本站文件体积上限，实际时长须匹配4/6/8/10秒之一（误差≤0.1秒）。不能填上游账号、项目、media UUID、URL或文件路径。

POST/v1/videos

curl --fail-with-body --silent --show-error \
  'https://api.coinseed.net/v1/videos' \
  -H "Authorization: Bearer $COINSEED_API_KEY" \
  -F 'model=coinseed-media-asset' \
  -F 'file=@reference.jpg' \
  --output upload.json

保存返回id，使用GET /coinseed-generation/v1/jobs/{id}核对返回task_id与保存id一致、status为SUCCESS、真实kind与task_id。MP4将文件改成file=@clip.mp4。只有已确认完成、类型匹配且属于本账号的素材可以使用。

• frames：第一张是首帧，第二张是可选尾帧。
• ingredients：1–3张素材图；Omni可使用已完成的本人Gemini TTS作品作为voice_task。
• 编辑生成作品：source_task必须是本人已完成的已生成视频任务。
• 编辑外部MP4：reference_video_task必须是本人完成的已生成视频上传任务。

两种视频源不能同时使用；编辑必须保持服务端确认的原片时长和方向，可附0–3张参考图，不能与语音参考叠加。来源不匹配时不能靠手填source_seconds或尺寸覆盖校验。每一输入方式、批量、360P和超分都有独立价格与验收门禁；支持参数不代表已开放。

Coinseed素材须使用此native查询入口：标准GET /v1/videos/{id}仅为OpenAI兼容包装，会省略kind、时长和尺寸，不能据此判断MP4是否可编辑。生成仍使用统一任务接口；H3素材查询入口保持不变。

COINSEED · ASYNC JOBS

Omni 视频创作与编辑

4/6/8/10秒，文字、首帧、首尾帧及1–3图素材均支持横竖屏；原生360P/720P，可免费本地放大至1080P，¥0.05/秒。

素材图片按目标画面裁切。声音引用支持1–3张图片及上述时长、方向和分辨率，可选local免费普通缩放；已生成视频编辑先开放6秒横屏720P、不加图片。720P的4/6/8秒普通生成可选Google原生1080P超分。

实时基础价：读取中…；附加服务与开放状态分别见本节完整规格表。

Omni 的接口合同包含文字、单张首帧、首尾帧、1–3 图素材、TTS 语音参考和视频编辑。下文是用法说明，不代表这些组合全部已开放；请先查看实时目录和本节下方的完整规格。输入方式、图片张数、时长、方向、分辨率、超分和是否引用配音/视频源必须同时匹配，不能把不同已通过规格自由拼接。

正在读取 Omni 的实时开放范围；下文示例不代表已开放。

网页流程：选择 Omni → 选择已开放的输入方式 → 上传或选择本人素材 → 填写动作或修改要求 → 核对完整规格与整单预计金额 → 提交 → 在“我的作品”查看、下载。提交结果未知时保留原任务号查询，不重复提交。

选择输入方式

图片为 PNG/JPEG/WebP，不设本站文件体积上限；上传 MP4 不设本站文件体积上限，实际时长应匹配 4/6/8/10 秒之一，误差不超过 0.1 秒。上传后先确认任务成功、素材类型和真实时长/尺寸，再绑定。具体上传与查询见 参考素材章节。

编辑时，网页依据匹配的本人成功任务锁定来源时长与方向，换视频源才能改变；服务端再次验证，不以客户端声明为准。请求仍携带与来源相符的 seconds 和 orientation。source_seconds 只是网页预估字段，禁止把它、源宽高、单价、usage、上游账号/UUID/URL/路径当成 API 授权或计费参数。

POST/coinseed-generation/v1/jobs

720P 横屏 1280×720、竖屏 720×1280；每单一个 MP4。视频按所选时长交付，后台可能裁剪或重新编码，不宣称所有档位都是模型原生时长。Omni支持原生360P/720P；720P的4/6/8秒组合及Veo Lite/Fast的8秒组合可选Google原生1080P超分。local是免费普通缩放。

单张首帧（8秒横竖屏；另有4/6秒横屏及4秒竖屏）

先核对这一整组规格已开放；首尾帧需另加第二张图并重新核对完整规格。

{
  "model": "omni-flash",
  "prompt": "人物缓缓回头，镜头稳定",
  "seconds": 4,
  "orientation": "landscape",
  "input_mode": "frames",
  "asset_tasks": [
    "task_YOUR_FIRST_FRAME"
  ],
  "resolution": "720p",
  "upscale_mode": "none"
}

首尾帧

第一张为开始画面，第二张为结束画面。当前开放8秒横屏或竖屏，以及10秒横屏；均为720P、无超分。

{
  "model": "omni-flash",
  "prompt": "人物缓缓回头，镜头稳定",
  "seconds": 8,
  "orientation": "landscape",
  "input_mode": "frames",
  "asset_tasks": [
    "task_YOUR_FIRST_FRAME",
    "task_YOUR_LAST_FRAME"
  ],
  "resolution": "720p",
  "upscale_mode": "none"
}

多图素材

8秒横屏或竖屏支持1、2或3张不同素材图；10秒支持竖屏1–3张、横屏3张，并有10秒横屏首尾帧；4秒横屏支持3张。均为720P、无超分，图片顺序与asset_tasks一致。

{
  "model": "omni-flash",
  "prompt": "图一人物走进图二场景，拿起图三的物品",
  "seconds": 4,
  "orientation": "landscape",
  "input_mode": "ingredients",
  "asset_tasks": [
    "task_YOUR_PERSON",
    "task_YOUR_SCENE",
    "task_YOUR_PROP"
  ],
  "resolution": "720p",
  "upscale_mode": "none"
}

引用已完成 TTS

配音必须是本账号已完成的 Gemini TTS 任务；本例的 1 图 + 配音也需独立开放。

{
  "model": "omni-flash",
  "prompt": "人物自然说话，使用提供的配音参考",
  "seconds": 4,
  "orientation": "landscape",
  "input_mode": "ingredients",
  "asset_tasks": [
    "task_YOUR_REFERENCE_IMAGE"
  ],
  "resolution": "720p",
  "upscale_mode": "none",
  "voice_task": "task_YOUR_COMPLETED_COINSEED_TTS"
}

编辑本人已生成的 已生成视频

这里假定源视频经服务端确认为 4 秒横屏。若源不同，须使用来源真实秒档、方向及对应已开放规格。

{
  "model": "omni-flash",
  "prompt": "保留人物动作，将背景改成傍晚海边",
  "seconds": 4,
  "orientation": "landscape",
  "input_mode": "ingredients",
  "asset_tasks": [],
  "resolution": "720p",
  "upscale_mode": "none",
  "source_task": "task_YOUR_COMPLETED_COINSEED_VIDEO"
}

编辑上传 MP4

这里假定上传素材已被确认是 4 秒横屏 MP4。不能同时传 source_task 或 voice_task。

{
  "model": "omni-flash",
  "prompt": "保留动作，将环境光改成温暖夕阳",
  "seconds": 4,
  "orientation": "landscape",
  "input_mode": "ingredients",
  "asset_tasks": [],
  "resolution": "720p",
  "upscale_mode": "none",
  "reference_video_task": "task_YOUR_UPLOADED_MP4"
}

文字生成

纯文字固定 720P、none，不传任何参考；其他秒档仍以已开放范围为准。

{
  "model": "omni-flash",
  "prompt": "雨后的城市小巷，镜头缓慢前进",
  "seconds": 4,
  "orientation": "landscape",
  "input_mode": "text",
  "asset_tasks": [],
  "resolution": "720p",
  "upscale_mode": "none"
}

计费与交付

整单金额 = 输出视频费用 + 编辑输入视频费用（如有）+ Google 1080P 附加费（如有）。普通参考图、首尾帧和最多 3 张素材图包含在基础价内；引用已付费 TTS 不再收费，新建 TTS 按配音模型单独计费。360P 沿用基础价；local 只做免费普通缩放，不作为收费 AI 超分。

正在读取正式单价、输入视频费用与交付附加费…

以下是按当前正式单价计算的报价示例，不代表对应规格已开放；视频编辑例子按输入输出秒档一致计算，实际来源须由服务端核实。

编辑并加 Google 1080P 时，须将“视频编辑（含输入）”与“Google 1080P 附加费”相加。新建 Gemini TTS：读取中…，最多 120 个 Unicode 字符；引用已付费配音不重复收费。

输出按所选名义秒档结算；编辑源必须通过服务端实际时长校验，再按匹配秒档计输入费用，少量对齐尾帧不加价。报价示例不表示规格已开放；price_status: pending、open: false 或未匹配完整规格时不可提交。确定失败按任务规则退款；未知受理状态保留原单核对，查询和重复下载不额外收费。

提交、查询和下载详见 异步生成流程。

MUSE · VIDEO

Muse 视频

Muse 可选来源（普通 API Key）

普通API Key可将可选请求头X-Coinseed-Provider设为muse-laoda或muse-laozeng，在本人既有模型、Key与分组授权范围内选择来源；不携带时仍按当前路由优先级调度。它不新增权限、不改变价格或已开放完整规格，也不保证来源健康、成功率或固定耗时。

该头仅适用于以下三个模型的普通生成POST；不用于素材上传、超分或其他模型。Spark的普通JSON与SSE均可指定来源。视频和图片的GET原任务查询及本人作品下载不受此头影响，无需携带它，也不能用它切换原任务来源。

显式来源不合法、与模型不匹配、未获授权或不可用时，请读取错误说明；系统不自动改选其他来源，也不自动重发本次显式来源请求。超时、断线、未取得任务号或UNKNOWN不能当作未受理：保留原请求时间、请求编号与已有任务号，先核对原任务和用量，必要时联系客服；禁止换来源再POST或自动重发，不能自行推断退款。Spark不创建异步任务号，按原请求时间、编号和用量核对。

以下HTTP视频例与Python SDK Spark例是独立的生成请求，执行会按原规则计费。只提交选定请求一次；SDK设置max_retries=0关闭自动重试。SDK示例的extra_headers仅作用于该次调用；不选来源时省略它。视频和图片仍使用上表各自的异步POST，不能把它们的模型ID直接填入chat.completions.create()。

curl --fail-with-body --silent --show-error \
  'https://api.coinseed.net/coinseed-muse/v1/jobs' \
  -H "Authorization: Bearer $COINSEED_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'X-Coinseed-Provider: muse-laoda' \
  --data-raw '{"model":"muse-video","prompt":"雨后的城市小巷，镜头缓慢向前移动","seconds":4,"orientation":"landscape"}'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COINSEED_API_KEY"],
    base_url="https://api.coinseed.net/v1",
    max_retries=0,
)
reply = client.chat.completions.create(
    model="muse-spark",
    messages=[{"role": "user", "content": "用一句话描述雨后的城市小巷。"}],
    stream=False,
    extra_headers={"X-Coinseed-Provider": "muse-laozeng"},
)
print(reply.choices[0].message.content)

上游明确仅返回文字、没有生成视频时，本单按失败退款；请修改提示词或参考图后再提交。超时或结果未知继续核对原单，系统不会盲目重发。

首帧图片在提交前按所选视频画布等比缩放；比例不符时居中补白，保留完整图片，不裁切或拉伸。相同比例沿用原图。生成模型仍可能产生细节变化，不能保证逐像素复现。

用文字描述主体、场景、动作与镜头，生成一个视频。图片输入和方形按独立验收状态开放；以下实时状态决定能否提交，参数说明不代表全部能力已开放。

核对方形开放状态…

正在读取新增时长和画幅的完整规格…

弱参考横竖屏4/6/8/10秒沿用0.05元/秒，即0.20/0.30/0.40/0.50元，无传图附加费。老曾来源的方形4秒已支持文字、单首帧和弱参考；文字另支持横屏5/12/15秒与4秒4:3；其他未列出的组合暂未开放。弱参考不保证首帧构图、精确保形或人物身份一致。

POST/coinseed-muse/v1/jobs

横屏为 1280 × 720；竖屏为 720 × 1280；已开放方形为 720 × 720，4:3为960 × 720；每单 1 个 MP4。目录所列秒数是交付时长，平台会核对原片，必要时裁剪、缩放或重新编码为所选交付规格；这些时长不是模型原生时长保证。原片不足所选时长时，本单按失败处理并退还生成费。不附加 AI 超分。

网页选择输入方式后，可选择本地图片、预览和移除；切换账号或模型清除待提交图片。图片随生成请求提交，不必上传第三方图床。资产库旧作品可先下载，再选本地文件。

每单最多一张静态图片，原文件不设本站体积上限，每边64–8192像素、总像素不超过3200万；只接受PNG/JPEG/WebP的base64 data URL。image_url也是内联字段，不接受任意HTTP URL或multipart。未开放尾帧、多图、参考视频、视频编辑、n或客户自定timeout。

{
  "model": "muse-video",
  "prompt": "雨后的城市小巷，镜头缓慢向前移动，柔和电影光影",
  "seconds": 6,
  "orientation": "landscape"
}

首帧增加image或image_url；弱参考改用reference_image，可选4/6/8/10秒横屏或竖屏；老曾方形支持文字、image首帧或reference_image弱参考，固定4秒square，每单只传一个图片字段。以下只准备请求体，不会提交订单：

import base64
from pathlib import Path
image = "data:image/png;base64," + base64.b64encode(Path("frame.png").read_bytes()).decode()
payload = {"model": "muse-video", "prompt": "人物自然转头，镜头缓慢推进",
           "seconds": 4, "orientation": "landscape", "image": image,
           "extra": "保持服装和人物外观一致"}

curl --fail-with-body --silent --show-error \
  'https://api.coinseed.net/coinseed-muse/v1/jobs' \
  -H "Authorization: Bearer $COINSEED_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @muse-request.json \
  --output submitted.json

老曾Muse文字视频新增横屏1/2/3/7/9秒，以及4秒3:4、2:3、3:2画幅。按所选时长交付，必要时裁剪原片，不延长或循环；实际交付尺寸可从作品回执读取。将上面的 JSON 保存为 muse-request.json。正式秒价：读取中…；公式为所选名义输出秒数 × 秒价，与 Omni 采用相同秒价；已开放图片输入不另加传图费。先按所选名义秒数预占，媒体校验达标后结算；原片多出的秒数不额外收费。过短、方向不符或无有效媒体视为交付失败，确定失败退还预占，未知结果保留原单核查。4 秒 读取中…，6 秒 读取中…，8 秒 读取中…，10 秒 读取中…。

提交后保存 task_id，用 GET /coinseed-muse/v1/jobs/{task_id} 查询原任务。成功后读取本站 /v1/tasks/{task_id}/artifacts，携带本人 API Key 下载；完整示例见异步任务、状态与下载。查询和重复下载不额外收费。

MUSE IMAGE

Muse 图片与单图编辑

可用可选请求头选择已授权来源，见Muse可选来源；图片仍使用本节异步接口，模型权限、规格与价格不变。

售价已确认；正在核对实时开放状态和完整规格…

模型 muse-image ，文字生图与单图编辑均每次1张，文字生图和单图编辑均支持1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 2:3 / 3:2。可以文字生图，也可以选择一张PNG/JPEG/WebP并说明修改要求。只开放上方实时目录列出的方式，不从视频模型权限推定图片权限。

参考图片64–8192像素/边，总像素不超过3200万。两次验收曾交付1600×1600原图；这不是固定尺寸、1080P或2K承诺，实际像素以作品详情为准。

创建与查询： /coinseed-muse-image/v1/jobs ；下载通过本人账号的任务附件。单图编辑使用JSON的 image 内联data URI；暂不支持multipart、图片网址、多图、批量、掩码或自定义宽高。

{"model":"muse-image","prompt":"白色背景上的红色陶瓷杯","n":1,"aspect_ratio":"1:1"}

已确认售价：¥0.10/张，单图编辑不加价。每单先预扣一张费用，成功按实际合格交付张数收费；明确失败且不能交付时退还本单冻结费用。未知提交保留原编号和冻结额，不要重复发起。

网页选择“Muse 图片”及文字生图或编辑一张图片；单图编辑直接选择本地原图，不需要其他模型的素材任务。成功作品进入本人异步任务记录，原图、HEAD/Range和重复下载不另收费；再次生成属于新单。账号与API Key都须明确允许muse-image，旧受限Key不自动扩权。

COINSEED · ASYNC JOBS

Nano Banana 2.1 图片

实时基础价：读取中…；附加服务与开放状态分别见本节完整规格表。

Nano Banana 2.1与Pro均开放五种比例16:9 / 4:3 / 1:1 / 3:4 / 9:16，纯文字或1–3张有序参考图，每单1–4张。分别按实际成功交付张数¥0.10/张、¥0.15/张结算，参考图不另收费。像素以原图为准，不承诺原生2K/4K。

POST/coinseed-generation/v1/jobs

参考图先按Coinseed素材上传取得确认完成的任务号。无参考图时asset_tasks为空；使用参考图时最多三个且不能重复。

{
  "model": "nano-banana-2.1",
  "prompt": "午后咖啡馆，蓝色陶瓷茶壶，写实摄影",
  "aspect_ratio": "1:1",
  "outputs_per_prompt": 1,
  "asset_tasks": []
}

{
  "model": "nano-banana-2.1",
  "prompt": "保持参考人物外观，将场景改为雨后街道",
  "aspect_ratio": "9:16",
  "outputs_per_prompt": 1,
  "asset_tasks": [
    "task_YOUR_FIRST_REFERENCE",
    "task_YOUR_SECOND_REFERENCE",
    "task_YOUR_THIRD_REFERENCE"
  ]
}

已开放的批量规格在后台拆成独立单图任务，每个子任务只提交一次。全部明确结束后，按实际交付张数结算；部分成功只扣成功图片的费用，全失败退整单款。未知提交保持核对，不退款后自动重做。下载成品列表中全部图片，不要只取第一张。查询或重复下载不再收费。

COINSEED · ASYNC JOBS

Veo 3.1 Lite

原生8秒720P，首帧、首尾帧和1–3图素材均支持横竖屏；可免费本地放大至1080P，¥0.40/条。

4/6秒仍需上游套餐支持并完成验收；Google原生超分尚待验收。

实时基础价：读取中…；附加服务与开放状态分别见本节完整规格表。

当前状态：核对开放状态…。以下说明接入合同；目录关闭或完整规格未开放时不可提交，不因示例存在而放行。

精确模型veo-3.1-lite。首帧/首尾帧使用frames，合同范围为4 / 6 / 8秒、横竖屏。多图素材使用ingredients和1–3张参考图，合同只允许8秒。

参考图必须是本人已确认完成的Coinseed素材；首帧必选，尾帧可选。生成分辨率720P，交付方式none/local/google_1080p以逐项报价与真实验收状态为准。单首帧、无超分的4/6/8秒交付会校验原生时长证据，不用裁剪结果冒充该规格。上游报价和账号暂不可用时任务保持安全拒绝或核对，不能自动回退到Omni。

{
  "model": "veo-3.1-lite",
  "prompt": "以首帧人物为主体，自然转头，镜头稳定",
  "seconds": 8,
  "orientation": "landscape",
  "input_mode": "frames",
  "asset_tasks": [
    "task_YOUR_FIRST_FRAME"
  ],
  "resolution": "720p",
  "upscale_mode": "none"
}

COINSEED · ASYNC JOBS

Veo 3.1 Fast

原生8秒720P，首帧、首尾帧和1–3图素材均支持横竖屏；可免费本地放大至1080P，¥0.64/条。

4/6秒仍需上游套餐支持并完成验收；Google原生超分尚待验收。

实时基础价：读取中…；附加服务与开放状态分别见本节完整规格表。

当前状态：核对开放状态…。以下说明接入合同；目录关闭或完整规格未开放时不可提交，不因示例存在而放行。

精确模型veo-3.1-fast。首帧/首尾帧使用frames，合同范围为4 / 6 / 8秒、横竖屏。多图素材使用ingredients和1–3张参考图，合同只允许8秒。

参考图必须是本人已确认完成的Coinseed素材；首帧必选，尾帧可选。生成分辨率720P，交付方式none/local/google_1080p以逐项报价与真实验收状态为准。单首帧、无超分的4/6/8秒交付会校验原生时长证据，不用裁剪结果冒充该规格。上游报价和账号暂不可用时任务保持安全拒绝或核对，不能自动回退到Omni。

{
  "model": "veo-3.1-fast",
  "prompt": "以首帧人物为主体，自然转头，镜头稳定",
  "seconds": 8,
  "orientation": "landscape",
  "input_mode": "frames",
  "asset_tasks": [
    "task_YOUR_FIRST_FRAME"
  ],
  "resolution": "720p",
  "upscale_mode": "none"
}

COINSEED · ASYNC JOBS

Veo 3.1 低优先级

实时基础价：读取中…；附加服务与开放状态分别见本节完整规格表。

当前状态：核对开放状态…。以下说明接入合同；目录关闭或完整规格未开放时不可提交，不因示例存在而放行。

精确模型veo-3.1-lite-low-priority。首帧/首尾帧使用frames，合同范围为4秒、横竖屏。当前低优先级只合同范围为4秒帧模式，不接受素材模式。

参考图必须是本人已确认完成的Coinseed素材；首帧必选，尾帧可选。低优先级合同仅含4秒帧模式；生成分辨率720P，交付方式none/local/google_1080p以逐项报价与真实验收状态为准。Low不承诺Lite/Fast单首帧4/6/8秒规格的原生时长证明。上游报价和账号暂不可用时任务保持安全拒绝或核对，不能自动回退到Omni。

{
  "model": "veo-3.1-lite-low-priority",
  "prompt": "以首帧人物为主体，自然转头，镜头稳定",
  "seconds": 4,
  "orientation": "landscape",
  "input_mode": "frames",
  "asset_tasks": [
    "task_YOUR_FIRST_FRAME"
  ],
  "resolution": "720p",
  "upscale_mode": "none"
}

COINSEED · ASYNC JOBS

Nano Banana Pro 图片

Nano Banana Pro支持五种比例，纯文字或1–3张有序参考图，每单1–4张，¥0.15/成功交付张。模型与权限独立管理，参考图不另收费。

实时基础价：读取中…；附加服务与开放状态分别见本节完整规格表。

当前状态：核对开放状态…。以下说明接入合同；目录关闭或完整规格未开放时不可提交，不因示例存在而放行。

Pro使用相同的比例、参考图和1–4张分单批量合同，model必须为nano-banana-pro。价格与权限独立管理。

{
  "model": "nano-banana-pro",
  "prompt": "精致陶瓷产品摄影",
  "aspect_ratio": "16:9",
  "outputs_per_prompt": 1,
  "asset_tasks": []
}

完整参数和部分成功结算规则见Nano通用说明。

COINSEED · ASYNC JOBS

Gemini TTS 配音

精确模型gemini-tts。去除首尾空白后输入1–120个Unicode字符；emoji按Unicode码点计数。选择30种系统音色之一，Speaker名称1–64字符，语气说明最多500字符。交付24kHz单声道PCM WAV，可在网页播放与下载。

POST/coinseed-generation/v1/jobs

{
  "model": "gemini-tts",
  "input": "欢迎来到Coinseed，开始你的创作。",
  "voice": "Kore",
  "voice_name": "Speaker",
  "instructions": "温和自然，正常语速"
}

此 Gemini TTS 使用异步统一任务接口，按次收费；不要与按字符结算的 MiniMax Speech 混用。Gemini TTS没有提供同步/v1/audio/speech兼容入口。实际音频时长受文字与语速影响；所选音色、Speaker与语气是请求参数，不承诺固定秒数。

系统音色

Achernar, Achird, Algenib, Algieba, Alnilam, Aoede, Autonoe, Callirrhoe, Charon, Despina, Enceladus, Erinome, Fenrir, Gacrux, Iapetus, Kore, Laomedeia, Leda, Orus, Puck, Pulcherrima, Rasalgethi, Sadachbia, Sadaltager, Schedar, Sulafat, Umbriel, Vindemiatrix, Zephyr, Zubenelgenubi

Omni语音参考组合开放后，已完成TTS作品才可作为该组合的voice_task，仅允许本人作品；上游媒体与账号由后台解析，不接受客户端UUID、URL或路径。

AUDIO · ASYNC JOBS

音乐生成与 WAV

网页选择“音频 → Suno V6配乐”，描述风格、情绪与乐器，可填写曲名和目标时长。纯音乐、无人声；每次通常返回两首MP3，0.99元/成功任务。完成后逐首试听/下载，需要WAV时在对应曲目旁转换，0.09元/首。

prompt最多1000字符，title最多80字符；duration可选10–360秒，实际时长允许少量偏差。未接入人声歌词、上传歌曲、续写或翻唱。文件保留14天，请及时下载。

生成配乐

POST /coinseed-music/v1/jobs，提交一次并保存task_id：

{"model":"kie-suno-v6","prompt":"温暖的钢琴和弦乐，轻柔，无人声","title":"清晨","duration":20}

GET同路径加/{task_id}查询，SUCCESS后读取/v1/tasks/{task_id}/artifacts，遍历全部附件并使用本人Key下载content_url。通常有track-0和track-1两首MP3，不要只下载第一首。

逐首转WAV

仍POST /coinseed-music/v1/jobs，source_task替换为本人的已完成原音乐任务：

{"model":"kie-suno-wav","source_task":"task_YOUR_MUSIC_ID","track_index":0}

第2首用track_index=1。WAV有自己的task_id，成功后从该任务的artifacts下载；原音乐的MP3保留。不能引用其他账号、未完成音乐或WAV任务代替原音乐。

查询、试听和重复下载免费；明确失败退还该单预占，结果未知时保留原编号查询，不重复POST。刷新后可从本人历史任务继续下载。Gemini/MiniMax配音保留原接口、声线和价格。

TRANSPARENT BILLING

价格、扣费与退款

本页正式金额实时读取 中央价目表。网页和 API 采用同一套正式价格；报价读取失败时，本页会显示不可用，不使用旧价格替代。

正式价格与开放规格目录版本（如20261017-muse-portrait-docs）与本页说明文本修订号独立，目录版本不代表本页文字版本。本次页面读取时间仅表示获取目录的时间，不是目录或文档更新时间。

• H3、Omni、Muse及Veo按各自规则计算输出秒数；H3参考视频、Omni视频编辑和Google超分还需计入已开放的附加项。
• 图片按实际合格交付张数结算；批量只在对应完整规格开放后可用。Gemini TTS按次，MiniMax Speech按供应商实际计费字符。
• M3按输入、输出、缓存读取token分别结算；Muse Spark已确认每次成功回复¥0.01，开放状态以上方实时目录为准；已开放且获本人账号与Key权限才可提交。SSE分片不重复计费。正式费率从目录读取，价格确认不等于服务已开放。
• 后台生成可能先冻结本单费用；原生对话/媒体可能按受限输入与输出上限预留额度，再按实际用量结算并退还差额。可用余额需足以完成预留，不能只够预计实际消耗。
• 确认失败退回相应未成功交付的预扣；批量部分成功按交付数量结算。网络超时、断线或“等待核对”不是确认失败，也不等于已退款。
• 冷启动与等待时间不单独收费；H3生成按名义所选秒数，独立AI超分按服务端核验帧数÷24计算，二者不可混算。
• 同一作品重复查询、预览和下载不重复收生成费；更改内容或主动再生成会产生新请求。
• 不得传入自定单价、usage、计费秒数等字段覆盖服务端核验。独立超分和视频参考先锁定来源媒体事实，再计算费用。
• 部分按秒任务整单金额四舍五入到人民币分；原生token/字符计费保留账户额度换算精度，不统一按分向上收费。最终以用量记录与余额变化为准。

COINSEED · ASYNC JOBS

生成任务提交、查询与作品下载

所有Coinseed生图、生视频、TTS都使用同一异步提交与查询流程；保存原任务号，不能因为超时重发生成POST。接口返回元数据支持不等于该规格已开放，最终以实时规格表、账号和Key权限为准。

curl --fail-with-body --silent --show-error \
  'https://api.coinseed.net/coinseed-generation/v1/jobs' \
  -H "Authorization: Bearer $COINSEED_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @media-request.json \
  --output submitted.json

保存返回的task_id，轮询GET /coinseed-generation/v1/jobs/{task_id}直到SUCCESS或明确FAILURE。UNKNOWN或需要核对的状态不要重做。成功后读取GET /v1/tasks/{task_id}/artifacts，下载本人任务返回的每个content_url。图片可能多张，TTS为audio/WAV，视频为video/MP4；以实际返回的MIME类型与文件名保存。

API下载携带本人API Key，网页登录使用本人会话和同源授权地址。含签名授权参数的完整作品地址可能允许持链接者下载，不要当作公共分享链接。确定失败退费，重复查询和下载不额外扣费；部分图片成功按已交付数量结算。

API BASICS

API 接入：鉴权与模型列表

BASEhttps://api.coinseed.net

使用 HTTPS，携带你自己的 API Key。按模型选择下表入口；开放状态和完整规格以实时目录及模型章节为准。异步入口返回task_id，在原POST路径后追加 /{task_id} 进行GET查询，再按下载章节取回作品；同步接口不按task_id轮询。

# 在本机或服务端设置；不要把真实 Key 提交到公开仓库
export COINSEED_API_KEY='YOUR_API_KEY'

curl --fail-with-body --silent --show-error \
  'https://api.coinseed.net/v1/models' \
  -H "Authorization: Bearer $COINSEED_API_KEY"

模型列表按账号和 Key 权限返回，其中 coinseed-asset 等是素材上传模型。可生成模型还需中央目录处于开放状态。MiniMax原生图片采用同步OpenAI兼容响应；Nano与Muse图片合同采用异步任务。使用SDK时仍需传本站允许的完整参数，不能仅因方法名相同而替换模型。

基本约定

• JSON 请求携带 Content-Type: application/json；上传使用 multipart，交给客户端生成 Content-Type 边界。
• 精确填写模型 ID 和枚举值。不要传本文参数表之外的宽高、步数、推理预算、回调地址等参数。
• 只有异步任务需要轮询；对话JSON/SSE和MiniMax同步媒体无需轮询task_id。异步轮询使用 GET。建议每 5–10 秒一次，根据业务需要设置轮询超时。
• 本版不提供公开 Webhook 契约，也不承诺客户端 Idempotency-Key 能替重复提交去重。
• 标准 HTTP 客户端可直接调用公开目录、生成API和余额接口，无需伪装浏览器 User-Agent。若收到403，请记录时间、路径、客户端版本和CF-Ray并联系客服；不要修改请求头掩盖问题，也不要重复POST生成。登录注册页适用独立的网页访问规则。

SUBMIT → POLL → DOWNLOAD

异步任务、状态与下载

本节适用于H3、Muse视频、Coinseed图片/视频/TTS及已开放的独立超分。对话和MiniMax同步媒体请按各自章节直接读取响应；它们不提供这里的task_id、后台历史和artifacts流程。

H3 视频及独立超分任务会按实际记录显示准备、核对、生成和交付进度。启动时的“总等待”“恢复等待”“实际安装”分别展示；没有真实安装记录时显示“未观察到”，不会用总等待代替安装耗时。阶段可能并行，不能把各阶段时间相加；这些时间不作为计费秒数。

显示“系统核对”或“需联系支持”时，请保留原任务编号，勿重复提交。启动阶段受阻不代表媒体任务已取消，也不表示可以重试。

提交回执

响应示例仅展示结构，不代表已完成。不要把“取得任务号”当作“已出片”。

{
  "task_id": "task_YOUR_TASK_ID",
  "status": "QUEUED",
  "progress": "0%",
  "artifacts_url": "/v1/tasks/task_YOUR_TASK_ID/artifacts"
}

GET/coinseed/v1/jobs/{task_id}

GET/coinseed-generation/v1/jobs/{task_id}

GET/coinseed-muse/v1/jobs/{task_id}

# H3 查询入口；Omni / Nano 改成 coinseed-generation；Muse 改成 coinseed-muse
curl --fail-with-body --silent --show-error   'https://api.coinseed.net/coinseed/v1/jobs/task_YOUR_TASK_ID'   -H "Authorization: Bearer $COINSEED_API_KEY"

获取成品列表

GET/v1/tasks/{task_id}/artifacts

curl --fail-with-body --silent --show-error \
  'https://api.coinseed.net/v1/tasks/task_YOUR_TASK_ID/artifacts' \
  -H "Authorization: Bearer $COINSEED_API_KEY"

{
  "task_id": "task_YOUR_TASK_ID",
  "artifacts": [
    {
      "key": "video",
      "type": "video",
      "mime_type": "video/mp4",
      "content_url": "/v1/tasks/task_YOUR_TASK_ID/artifacts/video/content"
    }
  ]
}

H3 / Omni / Muse 视频常用 key 为 video，Nano 图片常用 key 为 result-0；以本人任务返回的成品列表为准。完成前成品列表可能为空或返回未就绪，不要重新生成。

GET/v1/tasks/{task_id}/artifacts/{key}/content

curl --fail-with-body --silent --show-error \
  'https://api.coinseed.net/v1/tasks/task_YOUR_TASK_ID/artifacts/video/content' \
  -H "Authorization: Bearer $COINSEED_API_KEY" \
  --dump-header download.headers \
  --output video.mp4

下载接口也携带本人 API Key，支持 HEAD；视频支持 Range。API 下载不需要把 Key 放进 URL。网页使用有授权的同源成品地址，带签名的完整链接本身可能授权下载，不要公开分享。

完成后及时下载到自己的存储。当前不承诺作品永久保存；素材和作品的保留期限以平台后续公告为准。平台不支持用其他用户的任务号下载作品。

PYTHON · ONE ORDER

Python 完整示例

下面示例用 requests 提交一张 Nano 图片、保存任务号、轮询和下载。需要已开通的账号、足够余额和个人 API Key。只读重查可以由你的业务系统恢复；生成 POST 不自动重试。

python -m pip install requests

import os
from pathlib import Path
import time

import requests

BASE = "https://api.coinseed.net"
session = requests.Session()
session.headers.update({
    "Authorization": "Bearer " + os.environ["COINSEED_API_KEY"],
    "User-Agent": "coinseed-client-example/1.0",
})

# 只提交一次，不对 POST 使用自动重试。
try:
    response = session.post(BASE + "/coinseed-generation/v1/jobs", json={
        "model": "nano-banana-2.1",
        "prompt": "午后咖啡馆，蓝色陶瓷茶壶，写实摄影",
    }, timeout=(15, 120))
except requests.RequestException as exc:
    raise RuntimeError("提交结果未知：先核对本站任务记录，勿盲目重发") from exc

Path("submitted-response.json").write_text(response.text, encoding="utf-8")
if response.status_code >= 500 or response.status_code == 408:
    raise RuntimeError("已保存响应；提交结果待核对，勿盲目重发")
response.raise_for_status()
created = response.json()
task_id = created.get("task_id")
if not task_id:
    raise RuntimeError("未收到可靠任务号；保留响应并联系管理员")
print("任务号：", task_id)

# 客户端超时只停止等待，不会取消或判定服务端任务失败。
deadline = time.monotonic() + 30 * 60
while time.monotonic() < deadline:
    response = session.get(
        BASE + "/coinseed-generation/v1/jobs/" + task_id, timeout=(15, 60))
    response.raise_for_status()
    task = response.json()
    status = task.get("status")
    print(status, task.get("progress"))
    if status == "SUCCESS":
        break
    if status == "FAILURE":
        raise RuntimeError("任务确认失败，请核对退款记录")
    if status == "UNKNOWN":
        raise RuntimeError("任务待核对；保留任务号并联系管理员")
    time.sleep(8)
else:
    raise TimeoutError("停止轮询；任务可能仍在执行，稍后查询原任务号")

response = session.get(
    BASE + "/v1/tasks/" + task_id + "/artifacts", timeout=(15, 60))
response.raise_for_status()
items = response.json().get("artifacts", [])
if not items:
    raise RuntimeError("成品尚未就绪；稍后查询原任务，不重新生成")
artifact = items[0]
url = artifact.get("content_url", "")
expected_prefix = "/v1/tasks/" + task_id + "/artifacts/"
if not url.startswith(expected_prefix) or not url.endswith("/content"):
    raise RuntimeError("成品地址不符合本站同源路径，请核对响应")

with session.get(BASE + url, stream=True, timeout=(15, 120),
                 allow_redirects=False) as response:
    response.raise_for_status()
    if 300 <= response.status_code < 400:
        raise RuntimeError("下载发生重定向，请先核对；不把 Key 发往其他站点")
    mime = response.headers.get("Content-Type", "").split(";")[0].strip()
    suffix = {"image/jpeg": ".jpg", "image/png": ".png",
              "image/webp": ".webp", "video/mp4": ".mp4"}.get(mime, ".bin")
    output = Path(task_id + suffix)
    with output.open("wb") as file:
        for chunk in response.iter_content(1024 * 1024):
            if chunk:
                file.write(chunk)
print("已保存：", output)

改用 Omni 时，把请求 JSON 换成Omni 示例并保留查询路径。改用 Muse 时，使用Muse 示例，创建与查询路径均切换为 /coinseed-muse/v1/jobs。改用 H3 时，先上传参考图，再用 H3 JSON，同时把创建与查询路径切换为 /coinseed/v1/jobs。

WHEN SOMETHING FAILS

错误处理与售后

错误响应可能来自账号网关、任务插件或网站入口。先看 HTTP 状态和响应正文；不要只按中文提示文字写业务判断。以下为常见排查方向，具体业务错误码以实际响应为准。

联系管理员时提供这些信息

本站用户名或用户 ID、任务号（异步）或请求编号（同步/对话）、模型 ID、提交时间、所选时长、报错截图和原请求参数。充值问题补充闲鱼订单号与金额。请遮住密码、验证码、API Key 和临时授权下载地址。

LEARNED VIDEO UPSCALE

1080P AI超分

当前状态：核对开放状态…。正式价：读取中…。这是逐帧AI处理，与仅增加像素尺寸的免费普通缩放不同；只有下列完整输入已在目录开放且账号有权限时可提交。

四种输入均要求24fps、H.264 8bit MP4、一条AAC音轨，文件不设本站文件体积上限。768×1344的362帧H3原片可直接上传，不需裁剪尾帧。其他尺寸、横屏、帧数或无音轨暂未开放；不自动裁剪、插帧、改帧率或补音轨。输出保留帧数、方向与AAC音轨，不拉伸为固定16:9。

1. 上传：POST /v1/videos，multipart字段model=coinseed-ai1080-asset和file=@source.mp4。上传核验不收超分费。
2. 保存回执id，查询GET /coinseed-ai1080/v1/jobs/{id}，确认素材为本人且状态SUCCESS，核对服务端返回的宽高、frames、fps、目标尺寸和音轨。
3. 核价后仅提交一次POST /coinseed-ai1080/v1/jobs，请求体如下。不传手填时长、价格、usage或公网URL。
4. 查询原任务，成功后读取/v1/tasks/{task_id}/artifacts，用本人Key下载content；视频支持HEAD/Range。

{"model":"coinseed-upscale-1080p","asset_tasks":["task_MY_AI1080_UPLOAD"]}

费用 = max(实时最低费用，服务端帧数÷24×实时秒价)，整单四舍五入到分。362帧按约15.0833秒超分计费；该原片的H3生成订单仍按所选15秒收费。来源事实由服务端冻结，不能跨账号、跨平台直接复用素材ID；其他平台作品先下载再上传到本超分入口。本项1080P超分明确失败且未交付时，只退回该笔超分预占费用，不退回此前已成功交付的基础生成费；未知回执或结果核对中保留原单与该笔预占费用，不自动退款或重发，只查原单。

样本中的边缘改善较温和，细纹可能变平滑，也可能出现伪影；不保证每段视频更好，也不宣称模型原生1080P。逐帧处理可能排队，输出秒数不是等待时间。4秒/15秒样本约59/137秒首次查到成功，包含传输和轮询，仅作参考。

Coinseed的local是免费普通像素缩放，须该完整组合另行开放。独立2K/4K AI超分已开放，输入和素材入口不同，详见Coinseed 2K/4K与H3接续，不能直接换model混用原素材任务。

AI UPSCALE · AVAILABILITY GATED

超分服务：1080P / 2K / 4K

已开放的四种1080P完整输入、上传方式与实际帧计费见1080P AI超分。2K与4K的公开状态分别如下，不从1080P开放范围推定。

独立上传：24fps H.264 MP4、SDR 8bit yuv420p，25–384帧、短边至少270、像素数不超过1920×1080、宽高比不超过2.1；无音轨或单条AAC音轨。保持原帧数、比例和音轨，不自动转码不合规输入。2K/4K表示短边1440/2160。服务繁忙时进入准备队列；准备时间可能较久。等待时间不计入视频秒数。 完整接口和H3接续方式见本页Coinseed超分。

独立超分接口为 /coinseed-upscale/v1/jobs，配套上传模型为 coinseed-upscale-asset。必须先核验本人MP4的实际宽高、帧数、24fps与音轨，再计算实际帧数÷24×实时秒价，并应用该模型最低费用；不按H3生成时选择的整数秒代替原片时长。

普通1080P像素缩放与这些AI服务不同：普通缩放只调整尺寸，不能作为AI细节提升出售；收费AI超分效果依素材而异，也不承诺原生2K/4K拍摄质量。2K/4K不能复用AI1080或Coinseed素材任务号跨平台提交，未开放规格不能靠手填目标尺寸、usage或price绕过。

AVAILABILITY

尚未开放的服务与组合

Nano 2.1和Pro均已开放0–3张有序参考、每单1–4张。Veo Lite/Fast的原生8秒双帧、多图素材及Omni的已验组合见实时规格表。Omni语音参考、视频编辑与Google原生超分仍在接入验收；Veo低优先级当前未获上游模型配置开放。

开放范围会随验收更新，具体可提交规格查看当前能力表。已选择模型仍不可用时，请核对账号权限和API Key模型白名单。

FAQ

常见问题

CHAT · TEXT / FILES / IMAGES

对话：Muse Spark / MiniMax M3

仅muse-spark支持本节的Muse可选来源请求头，Python SDK使用extra_headers；MiniMax-M3不使用该头。

muse-spark：正在读取开放状态…

MiniMax-M3：正在读取开放状态…

模型ID区分大小写。

网页选择“对话”，使用Muse Spark或MiniMax M3。普通JSON与SSE共用POST /v1/chat/completions。支持文字长剧本、本地文件提取；M3另支持图片理解，Spark保持纯文字。图片理解不等于生图或配音输出；不执行工具、联网搜索或代码运行。

每次1–128条消息；基础角色为system/user/assistant，Spark另支持developer及文本工具历史，正文可用文字数组。所有正文合计最多1,048,576个Unicode字符，Spark文字JSON最多16MiB；M3单次JSON请求最多64MB（官方上限）。字符保护上限与上游token窗口不同，输入仍受实际上游窗口约束，不自动截断。M3默认及本站保护输出上限32,768 token，可指定1–32,768的较小值；Spark不设本站输出token上限。n固定1。

POST/v1/chat/completions

使用本人 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。下列请求只在模型、正式费率、账号权限均已开放后有效。

普通回复

{"model":"MiniMax-M3","messages":[{"role":"user","content":"请用一句话解释镜头推近。"}],"stream":false,"n":1,"max_completion_tokens":32768,"tools":[],"tool_choice":"none"}

完整HTTP响应中读取 choices[0].message.content 、 finish_reason 和 usage ；这是本次回答，不是异步任务号。调用方应自行保存文字与用量回执。Muse Spark调用时将model换为muse-spark，删除M3的max_completion_tokens可省略输出上限，或用max_tokens指定本次上限 ，按次合同限定整份输入合计最多1,048,576个Unicode字符、1–128条纯文本消息、 n=1 、不设本站输出token上限且不使用工具；开放状态以上方实时目录为准，已开放且获本人账号与Key权限才可提交。

SSE逐段回复

{"model":"MiniMax-M3","messages":[{"role":"user","content":"你好，请简单介绍你能帮我做什么。"}],"stream":true,"stream_options":{"include_usage":true},"n":1,"max_completion_tokens":32768,"tools":[],"tool_choice":"none"}

逐个解析SSE事件的 data: JSON，将 choices[0].delta.content 追加为文字。最终检查 finish_reason 和 data: [DONE]，收集 usage；仅连接结束、部分文字或HTTP200不足以证明完整交付。length表示达到输出限制，不能当成无限续写；续写是另一笔请求。

预留与实际计费

M3按服务端确认的输入、输出、缓存读取token分别结算；缓存命中的输入按对应缓存价计一次，不再重复算普通输入。正式费率：读取中…。发送前可能按本次受限上下文与最大输出预留额度；成功后按实际usage结算并退差，明确失败退回该请求的预扣。余额或Key剩余额度不足以预留时会先拒绝，不能只按预计短回答的费用判断能否发送。

Muse Spark已确认每次成功回复¥0.01，M3保留输入、输出与缓存读取token费率；上方直接读取正式目录。Muse Spark的开放状态以上方实时目录为准；只有目录已开放且本人账号与Key获权时才能提交。每次继续提问是新请求；同一回复的SSE分片不重复计费。usage缺失或为0不表示免费，也不自动开放。Muse的普通JSON或SSE均须有非空文字及 stop 或 length 合法终态，SSE还须完整结束标记；length 是达到调用者或上游的输出token上限，仍计1次，续写另计新回复。传输截断专指断流且缺少完整合法结束标记，不是正常的 length。网关未收到完整合法终态或结束标记而按失败处理时不收本次回复费，已预占额度退回；浏览器本地停止或断网不等于网关未完成，仍请核对后台用量，不自动重发。

网页对话只保留当前页面；切换账号会清除，刷新或关闭前用“下载对话”保存TXT。不提供跨设备历史或后台任务附件。聊天面板的停止操作不会取消另一个已提交的视频任务。

上传文件与图片理解

两模型可导入TXT、MD、JSON、CSV、TSV、SRT、VTT、文字PDF和DOCX正文。在浏览器本地提取文字，点击发送时提交提取内容；文件全文与已完成上下文共同计入输入额度。扫描/加密PDF不支持；DOCX内图片、外部链接和原文件不上传。不提供原生PDF/DOCX接口透传。

M3可另附最多4张本地PNG/JPEG/WebP图片，每张10MB（官方上限），内联data URL、detail=low，仅user消息可用。Spark不接受图片。API的max_tokens或max_completion_tokens均接受1–32,768整数，两者同时出现须相等；网关向M3发送max_completion_tokens。刷新或关闭前请下载TXT保存当前对话。

Muse Spark原生Responses（老曾来源）

POST /v1/responses 已通过普通账号公网JSON和SSE实测。模型使用 muse-spark，请求头指定 X-Coinseed-Provider: muse-laozeng，按完整文字回复收¥0.01。

{"model":"muse-spark","instructions":"用中文简短回答。","input":[{"role":"user","content":[{"type":"input_text","text":"解释关键帧。"}]}],"stream":false,"store":false}

普通JSON保留原生响应ID及output结构，完成条件为status: completed及非空output_text。流式设置stream: true，拼接response.output_text.delta，核对response.completed中的完整响应；不使用Chat接口的[DONE]作为条件。

支持文本数组、developer消息、instructions，以及function_call / function_call_output文本历史。Chat Completions也支持developer、文本内容数组和客户端提供的工具历史。每次传入所需完整文字上下文；不使用previous_response_id续接，不提供图片理解、音频或实际工具执行。Responses可选max_output_tokens，未指定时由上游决定；usage为0不表示免费。已有原请求和用量可核对，不自动重发。

NATIVE MEDIA · LOCAL PREVIEW

MiniMax同步图片与配音

image-01：读取状态… · 读取价格…

image-01-live：读取状态… · 读取价格…

speech-2.8-turbo：读取状态… · 读取价格…

speech-2.8-hd：读取状态… · 读取价格…

四个模型分别管理价格、权限和已验收完整规格。以下是本站受限接口用法；实时目录没有列出的比例、音色或输入方式不能提交。正式费率与开放状态分别读取实时目录；待普通账号验收时保留已确认价格，验收通过并开放后显示实际可用规格，不提前收单。

Image 01 / Live：文字生图

POST/v1/images/generations

{"model":"image-01","prompt":"白色背景上的蓝色杯子","n":1,"aspect_ratio":"1:1","response_format":"b64_json","prompt_optimizer":false}

成功后解码 data[0].b64_json 为图片，按实际格式保存，不把Base64字符串当成图片网址。网页只接收经过校验的内嵌图片，不跟随外部下载URL。每单最多一张，图片交付需有效解码；原图像素以实际结果为准。

当前不开放参考图与编辑。subject_reference、图片URL、掩码、多图等未允许字段会被明确拒绝，不会静默丢弃后按普通文生图收费。不要把Muse单图编辑的字段用于MiniMax图片模型。

Speech 2.8 Turbo / HD：系统音色配音

POST/v1/audio/speech

{"model":"speech-2.8-turbo","input":"你好，欢迎来到创作台。","voice":"male-qn-qingse","speed":1,"response_format":"mp3","metadata":{"output_format":"hex","audio_setting":{"format":"mp3","sample_rate":32000,"bitrate":128000,"channel":1}}}

成功响应直接是MP3二进制，可保存为 speech.mp3；不是JSON、hex文本或异步任务。网关在服务端转换供应商hex，网页只接收同源音频。当前交付为32kHz、单声道、128kbps；不开放克隆、音色设计、参考音频或自定义标记。

预扣、实际字符与退款

图片按实际合格交付张数结算。MiniMax配音先按输入长度的保守字符上限预留额度，再使用供应商 usage_characters 的实际计费字符结算并退差；账户余额和Key额度都必须足够预留。汉字通常计2个计费字符，标点等以实际回执为准，不能用网页Unicode字数直接替代。实测“你好，欢迎来到创作台。”为11个Unicode字符，上游计费20字符；这是计量示例，不是固定报价。

明确生成失败、未完成音频或无效媒体会退回本次预扣；客户端断线或未收到文件本身不等于供应商失败。停止接收只关闭本地连接，上游可能继续；请先核对用量记录和原请求时间，不自动重发。JSON请求最多32KiB；未通过权限或参数校验的请求不会因网页重试自动提交。

Gemini TTS仍是独立的异步WAV服务，使用 /coinseed-generation/v1/jobs，不能将其模型ID填到本同步MP3接口。完整开发者说明见Markdown API文档。

仅image-01可自定义宽高：每边512–2048整数且为8的倍数，成对传width/height并省略aspect_ratio。例如{"model":"image-01","prompt":"蓝色陶瓷杯","n":1,"width":800,"height":1200,"response_format":"b64_json","prompt_optimizer":false}。实际交付须精确匹配尺寸，仍按0.05元/张收费；image-01-live不支持此方式。

固定H3档位素材与接续

POST /v1/videos，model=coinseed-h3-preset-asset，file=参考图.png。然后提交：

POST /coinseed-h3-presets/v1/jobs
{"model":"h3-turbo","prompt":"一个连续自然镜头","seconds":6,"orientation":"portrait","asset_tasks":["task_本人固定档位图片号"],"upscale_mode":"2k"}

GET /coinseed-h3-presets/v1/jobs/{task_id}查询。旧标准H3素材仍用coinseed-asset，不可跨入口混用。

H3 · ACCEPTED PROFILES

H3固定档与音频 / 多图

只开放实时目录列出的完整组合，不能把不同方式、时长、方向和素材数量自由拼接。下方能力可在网页选择，API同样核验权限和规范化素材元数据。

四个固定单图档

参考图先用POST /v1/videos、model=coinseed-h3-preset-asset上传，再POST /coinseed-h3-presets/v1/jobs；GET同路径加/{task_id}查询。参数固定，不能覆写采样器等设置。6秒档实际约6.583秒，轻量4秒档约4.458秒，基础生成仍按名义档位收费。已验2K/4K接续见超分章节：2K ¥0.04/实际秒、最低¥0.20；4K ¥0.08/实际秒、最低¥0.40，基础生成费另计，并保留原片。

参考音频与视频原声

普通H3图片、视频和音频使用coinseed-asset上传并核对reference_media，生成仍用POST /coinseed/v1/jobs。独立音频字段reference_audio_tasks为audio1/audio2/audio3对象，仅引用本人已完成的音频上传任务；use_reference_video_audio=true启用原片声音。启用原声时原声为<Audio 1>，独立槽位依次为<Audio 2>、<Audio 3>、<Audio 4>；否则从<Audio 1>开始。独立音频每段分别向上取整，0.03元/输入秒；视频原声按核验音轨时长单独向上取整。可参考音频不等于承诺克隆音色或逐字复现。

有序多图与max参考精度

H3加速h3-custom1、6秒竖屏：2 / 3 / 9张有序768×1344图片，额外图0.05元/张，含生成共0.53 / 0.58 / 0.88元；必须匹配目录冻结的每张图片尺寸。单张4000×4962图片可设ref_image_size=max，附加费0元，生成0.48元。图片先通过coinseed-asset上传，再用原POST /coinseed/v1/jobs生成；多图/max不可叠加视频、音频、FL2VA或超分。

质量档文字/首帧/首尾帧另见FL2VA章节。所有任务通过/v1/tasks/{task_id}/artifacts读取本人附件，查询和重复下载免费；明确失败退还相应预占，未知状态保留原单查询，不重复提交。

任务重试、退款与进度说明

Omni单首帧6秒横屏720p、无超分：排队超过90秒且有完整未开始证据、上游允许换通道时，可在原任务内转空闲通道一次；任务号与预占不变。切换结果未知不重复操作，已开始任务不适用。

retry.phase=blocked 表示上游账号未就绪，或当前有其他任务占用；任务尚未开始生成。原任务和预占保留，恢复后继续；请勿重复提交，长时间未恢复请联系客服。

明确未提交或被拒绝的临时故障，后台最多尝试3次，间隔15秒、45秒。同一订单只预占一次费用；成功只结算一次，最终失败退回预占。

网页会显示正在自动重试、需要修改输入、上游账号暂不可用或结果正在核对。结果未知时只核对原任务，保留预占费用；请勿重复提交。

API查询原任务时读取 message 与 retry，包括 phase、reason_code、attempt、max_attempts、next_retry_at、retry_after_seconds、can_retry、action、charge_status。只有终态临时故障显示可重新提交；参数或内容问题需要修改，账号或服务问题按提示稍后再试或联系客服。

HTTP 503 本身不能证明未受理。没有取得任务号时，请先核对本人历史记录；不要自动重发POST。

Muse 1080P

选择目录中已开放的横屏1080P组合，API 使用 resolution: "1080p"。上游须返回合格1080P文件，仍为¥0.05/秒。