把 AI 生成能力接到你的程序里

请求头

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

• Key 被吊销 / 不存在 → HTTP 401
• Key 有效但余额不足 → HTTP 402
• 触发每用户速率限制 → HTTP 429

计费模型

• 定价基准：USD（上游原价以 USD 为基准存储），全局加价倍率 MARKUP = 1.3
• 结算货币：账户结算货币（默认 CNY，可选 USD / EUR），扣费时按最新汇率从 USD 换算到账户币种，结果保留 4 位小数
• 响应字段始终返回 service + tier（不暴露上游 model 名）；currency 始终为账户结算货币
• 文本（gemini3）：按响应中的 promptTokenCount + candidatesTokenCount + thoughtsTokenCount 实际 token 计费
• 文本（deepseek）：按响应中的 usage.prompt_tokens + usage.completion_tokens 实际 token 计费，命中 prompt_cache_hit_tokens 部分按上游缓存命中价计费
• 图片（nanobanana / wan27）：按实际成功返回的图片张数结算
• 提交时先 冻结 预估额度，结束后按实际用量 结算并返还差额，失败或取消会回滚冻结额度

服务标识与档位（service + tier）

每个接口对外只暴露 URL 路径里的 服务标识（gemini3 / deepseek / nanobanana / wan27 / g2i2v-qd / i2vpro / flat-lay / wan27-video / happyhorse / happyhorse-ref / happyhorse-edit / rh-i2v / rhart-vs / voice-clone / gesture-dance / outfit-dance / first-last-frame）；服务下的不同档位（速度 / 质量）通过请求体的 tier 字段指定。deepseek 同时提供 OpenAI 兼容端点，使用 model 字段（仅 deepseek-v4-flash / deepseek-v4-pro）。

兼容性：所有接口仍接受旧的 model 字段（值为上游真实 model 名或老别名），新接入推荐 tier。

POST/api/v1/openapi/gemini3/generate

Gemini 3 文本 / 思考生成。透传 contents / generationConfig / tools / systemInstruction，响应附加 service / tier / _billing 字段，不暴露上游 model 名。

curl -X POST https://www.jlike.com/api/v1/openapi/gemini3/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "fast",
    "contents": [{"role":"user","parts":[{"text":"用一句话解释相对论"}]}]
  }'

POST/api/v1/openapi/deepseek/generate
POST/api/v1/openapi/deepseek/chat/completions

DeepSeek V4 文本 / 推理生成。提供两条等价端点：原生路径使用 tier 并包一层平台 success 包装；OpenAI 兼容路径使用 model 字段、响应保持 OpenAI Chat Completions 同形（不包 success），便于直接接入 OpenAI 风格 SDK。两条路径走同一套鉴权和计费。本轮不支持流式：两个端点对 stream=true 都直接返回 HTTP 400。

仅这两个 model 名可用；不支持 deepseek-chat / deepseek-reasoner / deepseek-coder 或任何旧别名，传入即返回 HTTP 400。

# 原生端点（jlike 风格）
curl -X POST https://www.jlike.com/api/v1/openapi/deepseek/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "fast",
    "messages": [{"role":"user","content":"用一句话解释相对论"}],
    "max_tokens": 512
  }'

# OpenAI 兼容端点
curl -X POST https://www.jlike.com/api/v1/openapi/deepseek/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role":"user","content":"Reply with: pong"}],
    "max_tokens": 64
  }'

⚠ pro 档当前处于上游 75% 折扣促销期（至 2026-05-31 15:59 UTC），到期后回归基础价。详细价格与字段定义见 openapi-reference.md。

POST/api/v1/openapi/nanobanana/generate

Nano Banana 图片生成。同步返回结果图片，响应中的图片内容为 base64 PNG。响应字段包含 service + tier，不暴露上游 model 名。

参考图三选一（均可选）：image_file_ids（推荐，传 /openapi/files/upload 返回的 file_id 数组）/ image_urls（http(s) URL 数组，服务端拉取）/ images（纯 base64 数组，legacy）。lite 只支持 1K，其余 tier 支持更高分辨率（详见 openapi-reference.md）。

curl -X POST https://www.jlike.com/api/v1/openapi/nanobanana/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "pro",
    "prompt": "赛博朋克风格的猫，霓虹灯招牌下",
    "size": "2K",
    "aspect_ratio": "16:9",
    "n": 1
  }'

POST/api/v1/openapi/wan27/generate
GET/api/v1/openapi/wan27/task/{task_uuid}

Wan 2.7 图片生成（异步）。提交后立即返回 task_uuid，建议每 3 秒轮询一次。终态结果会缓存到数据库，重复查询不会再次扣费。

参考图三选一（均可选）：image_file_ids（推荐，传 /openapi/files/upload 返回的 file_id 数组）/ image_urls（http(s) URL 数组）/ images（纯 base64 数组，legacy）。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/wan27/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"tier":"pro","prompt":"astronaut on mars","size":"2K","aspect_ratio":"16:9","n":1}'

# 轮询
curl https://www.jlike.com/api/v1/openapi/wan27/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ 4K 仅 pro tier 可用，且不能带参考图、不能开启顺序图。上游返回的图片 URL 通常约 24 小时有效，请尽快下载。

POST/api/v1/openapi/g2i2v-qd/generate
GET/api/v1/openapi/g2i2v-qd/task/{task_uuid}

G2I2vQd 图生图（异步）。输入提示词 + 1–10 张参考图，输出一张高质量编辑/合成图。上游 RunningHub 标准模型 rhart-image-g-2/image-to-image。提交后立即返回 task_uuid，建议每 5–10 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/g2i2v-qd/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "在马克杯正中央加一个精致几何风格狐狸 Logo，下方印 Wild Fox，保留原图光影与陶瓷质感不变。",
    "image_urls": ["https://example.com/cup.png"],
    "resolution": "2k"
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/g2i2v-qd/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ * image_urls 与 image_file_ids 至少给一组，合计 ≤ 10 张，单图 ≤ 30 MB。base64 入参服务端会先转上传到 RunningHub 再调用上游；图片 URL 约 24 小时有效，请尽快下载。

POST/api/v1/openapi/i2vpro/generate
GET/api/v1/openapi/i2vpro/task/{task_uuid}

I2vPro 图像编辑（异步）。输入提示词 + 1–10 张参考图，输出一张精修编辑后的图片。上游 RunningHub 标准模型 rhart-image-n-pro/edit。提交后立即返回 task_uuid，建议每 5–10 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/i2vpro/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "基于原图风格，将主角替换为年迈慈祥的猴子奶奶，穿着格子围裙做晚餐，厨房环境保持不变。",
    "image_urls": ["https://example.com/grandma.jpg"],
    "aspect_ratio": "3:4",
    "resolution": "2k"
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/i2vpro/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ * image_urls 与 image_file_ids 至少给一组，合计 ≤ 10 张，单图 ≤ 10 MB。base64 入参服务端会先转上传到 RunningHub 再调用上游；图片 URL 约 24 小时有效，请尽快下载。

POST/api/v1/openapi/flat-lay/generate
GET/api/v1/openapi/flat-lay/task/{task_uuid}

FlatLay 平铺拼图（异步）。输入一张单品图（如一条裙子），上游自动分析其品类/风格/颜色/季节，从商品库里配齐互补单品（鞋、包、配饰、项链等），生成一张俯拍「平铺拼图」效果图（含诗意文案与可选品牌名）。提交后立即返回 task_uuid，建议每 3–5 秒轮询一次（上游侧有约 30 秒节流，终态最多延迟约 30 秒可见）。终态结果缓存，重复查询不会再次扣费。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/flat-lay/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://cdn.example.com/dress.jpg","lang":"zh","brand_label":"FaFa"}'

# 轮询
curl https://www.jlike.com/api/v1/openapi/flat-lay/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

成功后响应字段 image_url 为拼图结果 URL（已转存至本平台 OSS，presigned，按 files.download_url_ttl 有效）；上游临时托管 URL 不对外暴露。

⚠ 失败错误码：UPSTREAM_ERROR（上游分析失败 / 配不齐互补单品 / 渲染失败或超时）、oss_copy_failed（上游出图成功但本平台转存 OSS 失败）。

POST/api/v1/openapi/happyhorse/generate
GET/api/v1/openapi/happyhorse/task/{task_uuid}

HappyHorse 图生视频（异步）。以首帧图片为基础，通过文本描述引导生成物理真实、运动流畅的视频。上游 DashScope happyhorse-1.0-i2v。提交后立即返回 task_uuid，建议每 10–15 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/happyhorse/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "pro",
    "prompt": "一只猫在草地上奔跑",
    "image_url": "https://example.com/first_frame.png",
    "duration": 5
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/happyhorse/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ 建议先用 /openapi/files/upload 拿到 public_url 再填入 image_url。输出视频宽高比自动跟随首帧图片。视频 URL 约 24 小时有效，请尽快下载。

POST/api/v1/openapi/happyhorse-ref/generate
GET/api/v1/openapi/happyhorse-ref/task/{task_uuid}

HappyHorse 参考生视频（异步）。传入多张参考图像，通过文本描述（使用 [Image 1]、[Image 2] 指代参考图）将图像中的主体角色融合生成流畅视频。上游 DashScope happyhorse-1.0-r2v。提交后立即返回 task_uuid，建议每 10–15 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/happyhorse-ref/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "pro",
    "prompt": "[Image 1]中的女孩缓缓走向[Image 2]中的城堡",
    "image_urls": [
      "https://example.com/girl.png",
      "https://example.com/castle.png"
    ],
    "ratio": "16:9",
    "duration": 5
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/happyhorse-ref/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ 建议先用 /openapi/files/upload 拿到 public_url 再填入 image_urls。prompt 中用 [Image N] 指代参考图时，需注明图中的具体对象。视频 URL 约 24 小时有效，请尽快下载。

POST/api/v1/openapi/happyhorse-edit/generate
GET/api/v1/openapi/happyhorse-edit/task/{task_uuid}

HappyHorse 视频编辑（异步）。输入视频 + 可选参考图 + 文本编辑指令，完成风格变换、局部替换等编辑任务。上游 DashScope happyhorse-1.0-video-edit。输出时长 = min(输入时长, 15 秒)。提交后立即返回 task_uuid，建议每 10–15 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

计费说明：上游计费秒数 = 输入视频时长 + 输出视频时长（均向上取整），提交时按最大 30 秒预冻结，完成后按实际用量结算并返还差额。

# 提交（视频 + 参考图编辑）
curl -X POST https://www.jlike.com/api/v1/openapi/happyhorse-edit/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "hd",
    "prompt": "让视频中的角色穿上图片中的条纹毛衣",
    "video_url": "https://example.com/input.mp4",
    "image_urls": ["https://example.com/sweater.png"]
  }'

# 提交（纯指令编辑，无参考图）
curl -X POST https://www.jlike.com/api/v1/openapi/happyhorse-edit/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "pro",
    "prompt": "将视频转换为赛博朋克风格",
    "video_url": "https://example.com/input.mp4",
    "audio_setting": "origin"
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/happyhorse-edit/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ 建议先用 /openapi/files/upload 拿到 public_url 再填入 video_url / image_urls。输入视频超过 15 秒时自动截取前 15 秒。视频 URL 约 24 小时有效，请尽快下载。

POST/api/v1/openapi/gesture-dance/generate
GET/api/v1/openapi/gesture-dance/task/{task_uuid}

手势舞视频生成（异步）。输入人像图 + 驱动手势视频，输出手势驱动后的人像视频。上游 RunningHub。提交后立即返回 task_uuid，建议每 5–10 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/gesture-dance/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "pro",
    "image_url": "https://example.com/portrait.png",
    "video_url": "https://example.com/gesture.mp4",
    "max_duration_sec": 10
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/gesture-dance/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ 建议先用 /openapi/files/upload 拿到 public_url 再填入此处。视频 URL 约 24 小时有效，请尽快下载。

POST/api/v1/openapi/selfie-video/generate
GET/api/v1/openapi/selfie-video/task/{task_uuid}

手机自拍视频生成（异步）。输入人像图 + 中文动作提示词，输出固定 5 秒的自拍风格视频：手机始终遮住面部五官、按提示词做指定动作、保留原图衣服材质与色彩。上游 RunningHub AI App。提交后立即返回 task_uuid，建议每 5–10 秒轮询。终态结果缓存，重复查询不会再次扣费。

上游 nodeInfoList 的其余参数（分辨率档位、长宽比、加密方式、BGM 等）均由服务端按推荐默认值固定，不暴露给调用方。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/selfie-video/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/portrait.png",
    "prompt": "女子手持手机自拍，手机全程挡住脸和五官，空闲手比耶；随后叉腰；最后从上到下摸身上的衣服。保持衣服材质、形状、色彩、细节不变。固定镜头。"
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/selfie-video/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ 视频 URL 约 24 小时有效，请尽快下载或转存。

POST/api/v1/openapi/outfit-dance/generate
GET/api/v1/openapi/outfit-dance/task/{task_uuid}

跳舞换装视频生成（异步）。输入人像图 + 驱动视频，输出换装后的舞蹈视频。上游 DashScope wan2.2-animate-move。提交后立即返回 task_uuid，建议每 5–10 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/outfit-dance/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "hd",
    "image_url": "https://example.com/portrait.png",
    "video_url": "https://example.com/dance.mp4",
    "max_duration_sec": 15
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/outfit-dance/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ 建议先用 /openapi/files/upload 拿到 public_url 再填入此处。视频 URL 约 24 小时有效，请尽快下载。

POST/api/v1/openapi/first-last-frame/generate
GET/api/v1/openapi/first-last-frame/task/{task_uuid}

官方首尾帧视频生成（异步）。输入首帧图 + 尾帧图 + 动作文字描述，输出插值视频。上游 RunningHub ComfyUI 工作流。提交后立即返回 task_uuid，建议每 5–10 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/first-last-frame/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "std",
    "prompt": "女生慢慢的走来",
    "start_image_url": "https://example.com/first_frame.png",
    "end_image_url": "https://example.com/last_frame.png"
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/first-last-frame/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ workflow 输出时长固定，计费按固定 5 秒预冻结。视频 URL 约 24 小时有效，请尽快下载。

POST/api/v1/openapi/wan27-video/generate
GET/api/v1/openapi/wan27-video/task/{task_uuid}

万相 2.7 图生视频（异步）。支持多模态输入（文本 / 图像 / 音频 / 视频），可完成首帧生视频、首尾帧生视频、视频续写三大任务。上游 DashScope wan2.7-i2v。提交后立即返回 task_uuid，建议每 10–15 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

素材组合（media 数组）——仅支持以下组合，其他组合返回 400：

# 首帧生视频
curl -X POST https://www.jlike.com/api/v1/openapi/wan27-video/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "hd",
    "prompt": "一只小猫在草地上奔跑",
    "media": [
      {"type": "first_frame", "url": "https://example.com/first.png"}
    ],
    "duration": 5
  }'

# 首尾帧生视频
curl -X POST https://www.jlike.com/api/v1/openapi/wan27-video/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "pro",
    "prompt": "女生慢慢地走来",
    "media": [
      {"type": "first_frame", "url": "https://example.com/first.png"},
      {"type": "last_frame", "url": "https://example.com/last.png"}
    ],
    "duration": 10
  }'

# 视频续写
curl -X POST https://www.jlike.com/api/v1/openapi/wan27-video/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "hd",
    "prompt": "女孩出门后背着书包走在街上",
    "media": [
      {"type": "first_clip", "url": "https://example.com/clip.mp4"}
    ],
    "duration": 15
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/wan27-video/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ 建议先用 /openapi/files/upload 拿到 public_url 再填入 media[].url。视频 URL 约 24 小时有效，请尽快下载。时长向上取整计费（如 2.1 秒按 3 秒计）。

POST/api/v1/openapi/rh-i2v/generate
GET/api/v1/openapi/rh-i2v/task/{task_uuid}

RunningHub 图生视频（异步）。输入参考图 + 提示词，生成 3–5 秒短视频。上游 RunningHub ComfyUI 工作流。提交后立即返回 task_uuid，建议每 5–10 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/rh-i2v/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.png",
    "prompt": "女生缓缓转头微笑",
    "duration": 5
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/rh-i2v/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ 建议先用 /openapi/files/upload 拿到 public_url 再填入 image_url。视频 URL 约 24 小时有效，请尽快下载。

POST/api/v1/openapi/rhart-vs/generate
GET/api/v1/openapi/rhart-vs/task/{task_uuid}

RhartVs 图生视频（异步）。输入单张参考图 + 提示词，生成 10 秒或 15 秒动态视频。上游 RunningHub 标准模型 rhart-video-s/image-to-video。提交后立即返回 task_uuid，建议每 10–15 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/rhart-vs/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "0–2秒：狸花猫翘着二郎腿斜眼笑；2–5秒：哈士奇一愣；5–10秒：哈士奇瞬间石化，全场爆笑收尾。",
    "image_url": "https://example.com/podcast.png",
    "duration": 10,
    "aspect_ratio": "9:16",
    "storyboard": false
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/rhart-vs/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ * image_url 与 image_file_id 至少给一个，单图 ≤ 50 MB。base64 入参服务端会先转上传到 RunningHub 再调用上游；视频 URL 约 24 小时有效，请尽快下载。

POST/api/v1/openapi/voice-clone/generate
GET/api/v1/openapi/voice-clone/task/{task_uuid}

声音克隆 TTS（异步）。输入参考音频 + 要合成的文字，输出克隆参考音色朗读该文字的音频。上游 RunningHub ComfyUI 工作流。提交后立即返回 task_uuid，建议每 5–10 秒轮询一次。终态结果缓存，重复查询不会再次扣费。

计费时长按 ceil(prompt 字符数 / 3) 估算（最低 1 秒），freeze 与 confirm 用同一估算值，所以可从 prompt 长度直接预估费用。100 字 ≈ 34 秒 ≈ ¥0.34。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/voice-clone/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://example.com/ref.m4a",
    "prompt": "大家好啊，欢迎使用共享剪贴板的声音克隆能力。"
  }'

# 轮询
curl https://www.jlike.com/api/v1/openapi/voice-clone/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ 若没有公网可达的参考音频，可先用 /openapi/files/upload（purpose=audio）拿到 public_url 再传入。输出音频 URL 约 24 小时有效，请尽快下载。

POST/api/v1/openapi/files/upload
GET/api/v1/openapi/files/{file_id}/url
DELETE/api/v1/openapi/files/{file_id}

临时文件托管。将本地图片/视频/音频上传到 OSS，返回 presigned 公网 URL（默认有效期 2 小时），供需要公网 URL 入参的端点使用。上传与重新获取下载 URL 都会按文件大小计费，响应中返回 cost 和 currency。

成功响应：

{
  "success": true,
  "file_id": 123,
  "public_url": "https://oss.../openapi/temp/...",
  "expires_at": 1714920000,
  "size_bytes": 1048576,
  "mime_type": "image/png",
  "purpose": "image",
  "cost": 0.02,
  "currency": "CNY"
}

NanoBanana / Wan 2.7 的 image_file_ids 字段可直接传此处返回的 file_id。若 public_url 过期，可调用 GET /api/v1/openapi/files/{file_id}/url 重新获取；该操作同样按文件大小计费。OSS 设有 openapi/temp/ 前缀 1 天生命周期自动清理。

{
  "success": false,
  "error": "错误描述",
  "error_code": "INVALID_PARAMS"
}