一、30 秒速览

一句话：一个地址、一把钥匙，文本走 /v1/chat/completions、图像视频走 /v1/videos，覆盖全部 49 个模型。

二、快速开始（3 步，约 5 分钟）

第 1 步 · 注册并登录

浏览器打开 http://40.81.18.119，注册并登录账号。

第 2 步 · 创建 API Key

登录后进入 「令牌」 页面 → 点 「添加令牌」 → 名称随意填写 → 其余保持默认 → 提交。
页面会生成一串 Key，形如 sk-xxxxxxxxxxxxxxxx。

⚠️ Key 只在创建时完整显示一次，请立即复制保存。
如果泄露，回到「令牌」页面删除并重新创建即可。

第 3 步 · 发起第一次调用

把下面命令中的 sk-你的Key 换成真实 Key，整段复制到终端执行：

curl http://40.81.18.119/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"cf-deepseek-v4-flash\",\"messages\":[{\"role\":\"user\",\"content\":\"你好，做个自我介绍\"}]}"

看到返回的 JSON 里有 choices 内容，就说明接入成功了。

三、接口约定

3.1 服务地址

http://40.81.18.119/v1

目前仅提供 HTTP 协议，暂未提供 HTTPS 域名。如果你的开发环境或 SDK 强制要求 HTTPS，请联系我们。

3.2 鉴权

每次请求都必须在请求头中携带 API Key：

Authorization: Bearer sk-你的Key

3.3 统一端点

端点选择取决于模型类型，请按下表对号入座（选错端点会返回「不支持此 API 路径」）：

💡 虽然图像/视频模型也归在「视频」端点下，但这是统一的任务提交入口——服务端会根据 model 参数自动路由，你不需要关心底层是出图还是出片。

请求体格式：

{
  "model": "模型名称",
  "messages": [
    { "role": "user", "content": "你的提示词" }
  ]
}

此外，本服务也开放 OpenAI 标准专项端点（图像 / 视频 / 语音），完整清单见 3.4。但统一入口 POST /v1/chat/completions 最稳妥，推荐优先使用。

3.4 可用端点总表

下表是本服务实际开放的全部端点（均已实测可用）：

⚠️ 除上表之外的路径一律不可用（例如 /v2/videos/generations、/xai/v1/videos、/qwen/api/v1/...、/suno/*）。

⚠️ 图像 / 视频模型请走 /v1/videos，不要走 /v1/chat/completions——尤其是 as- 开头的模型，其上游只开放这一个端点，走错会直接报错。

✅ 全部 49 个模型均已实测可用。任务查询（轮询结果）不计费，可放心轮询等待。
这些是服务商内部的原始接口，直接调用会返回网页而不是数据。请勿参考其他平台的文档照搬。

3.5 通用请求头

四、支持模型一览（49 个）

4.1 文本 / 多模态对话（21 个）

4.2 图像生成（6 个）

4.3 视频生成（17 个）

4.4 语音（5 个）

语音类端点：文本转语音用 POST /v1/audio/speech，语音转文字 / 翻译用 POST /v1/audio/transcriptions（表单上传音频文件）。

五、调用示例

以下示例均可直接复制使用，只需把 sk-你的Key 替换为真实 Key。

5.1 文本对话

curl

curl http://40.81.18.119/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"cf-deepseek-v4-flash\",\"messages\":[{\"role\":\"user\",\"content\":\"用三句话介绍一下杭州\"}]}"

Python（OpenAI 官方 SDK）

from openai import OpenAI

client = OpenAI(
    base_url="http://40.81.18.119/v1",
    api_key="sk-你的Key",
)

resp = client.chat.completions.create(
    model="cf-deepseek-v4-flash",
    messages=[{"role": "user", "content": "用三句话介绍一下杭州"}],
)
print(resp.choices[0].message.content)

流式输出：加上 "stream": true 即可逐字返回。

5.2 图像生成

图像与视频统一走 POST /v1/videos（服务端按 model 自动路由）。

curl http://40.81.18.119/v1/videos \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"as-gemini-3-pro-image\",\"prompt\":\"一只戴墨镜的柴犬，赛博朋克风格\",\"resolution\":\"1K\"}"

⚠️ 参数名按前缀区分：as- 系列必须用 resolution，传 size 会报错；
cf- 系列用 size。记不清时直接省略该参数，服务端会按 1K 计价。

如果你更习惯 OpenAI 标准写法，cf- 系图像模型也支持 POST /v1/images/generations；但 as- 系只支持 /v1/videos。

5.3 视频生成

curl http://40.81.18.119/v1/videos \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"as-seedance-2.0\",\"prompt\":\"夕阳下的海边，一只金毛犬在沙滩上奔跑，电影感镜头\",\"resolution\":\"720P\",\"seconds\":5}"

关于等待时间：视频是长任务，一次请求通常需要 30 秒到几分钟。

• 请把客户端超时设置为 ≥ 600 秒；
• cf- 系为同步返回，地址直接出现在响应里；
• as- 系为异步任务，响应只给任务标识 id，需轮询取结果（见下）。

如何取回结果（as- 系必读）

提交任务后，用返回的 id 轮询查询：

curl http://40.81.18.119/v1/videos/task_xxxxxxxx \
  -H "Authorization: Bearer sk-你的Key"

处理完成后返回：

{
  "id": "task_xxxxxxxx",
  "status": "completed",
  "progress": 100,
  "url": "https://…/result.png",
  "video_url": "https://…/result.png"
}

💡 轮询查询不产生任何费用，可以按 2–5 秒间隔轮询；建议设置最长等待 15 分钟。

💡 刚变成 completed 的瞬间，图片地址可能还没就绪；若第一次下载失败，隔几秒重试一次即可。

图生视频：把参考图以图片地址形式提供（image / 参考图参数），具体写法请参考各模型说明。

5.4 语音合成与识别

文本转语音

curl http://40.81.18.119/v1/audio/speech \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"cf-tts-1\",\"input\":\"你好，欢迎使用 zimu简画 API 服务\",\"voice\":\"alloy\"}"

语音转文字

curl http://40.81.18.119/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-你的Key" \
  -F "model=cf-whisper-1" \
  -F "file=@你的音频文件.mp3"

六、计费规则

6.1 计价方式

6.2 价格查询

实时价格请见定价页：http://40.81.18.119/pricing

页面上每个模型都标注了对外价格与计价单位，例如：

• ¥0.494 秒起 —— 每秒 0.494 元起（规格越高价格越高）
• ¥0.078 张起 —— 每张 0.078 元起（1K 最便宜，4K 最贵）
• ¥1.950 条 —— 每条 1.950 元

6.3 缺省值规则

为避免调用失败，以下参数可以省略，系统按默认规则计费：

强烈建议：图像和视频调用时显式填写 size / resolution / seconds，这样价格可预期，避免争议。

6.4 计价单位与精度

• 本服务直接以人民币金额计费，单位 元（¥），不折算为其他积分单位。
• 金额精度：保留小数点后 3 位，第 4 位向上取整。
• 例：原值 0.1040 元 → 计 0.104 元
• 例：原值 0.1044 元 → 计 0.105 元
• 定价页展示的价格即最终计费价，无额外换算或隐藏费用。
• 只有真正产生 AI 生成结果的调用才计费；调用失败（如参数错误、上游异常）不扣费。
• 查询类请求（如轮询任务状态 GET /v1/videos/{id}）不计费。

6.5 余额校验（先校验、后生成）

发起生成请求时，系统会先校验账户余额，余额不足会直接返回 402，不会消耗资源、也不会产生费用。

{
  "error": {
    "message": "Insufficient balance. Current ¥0.000, this request needs about ¥0.078. Please ask the administrator to top up.",
    "type": "insufficient_quota",
    "code": "insufficient_balance"
  },
  "balance": 0,
  "required": 0.078
}

返回里的 balance 是当前余额、required 是本次请求所需金额。充值后即可直接重试，无需换 Key。

金额为预估（图像/视频按本次规格精确计算，文本按请求长度保守估算）。实际扣费以生成结果为准。

6.6 余额底线与欠费上限

1. 余额是底线：账户余额不足以覆盖本次预估费用时，请求不会被放行（返回 402），

也就不会消耗上游资源、不会产生任何费用。余额为 0 时，所有请求一律拒绝。

1. 并发不会突破余额：同时发起多笔请求时，已放行但尚未完成的请求会先占用相应额度，

因此实际能同时跑的任务数由余额决定（例如余额 ¥0.20、单笔 ¥0.078 → 最多同时 2 笔，其余返回 402）。

1. 欠费上限 ¥0.5：仅文本类接口可能出现"预估不足"（按 Token 计费，请求前算不出真实用量）。

这种情况下单账户余额最多扣到 -¥0.5，超过部分不再收取。
欠费后需充值才能继续调用。

图像 / 视频类按规格精确预估，不会欠费。

七、错误码

错误返回示例（401）

{
  "error": {
    "code": "",
    "message": "Invalid token (request id: 202609110400041108714008268d9d6mMoAmUwE)",
    "type": "new_api_error"
  }
}

每次错误返回都带 request id，反馈问题时请一并提供，便于我们定位。

八、常见问题

Q1：可以用 OpenAI 官方 SDK 吗？
可以。只需把 base_url 改成 http://40.81.18.119/v1，api_key 换成你的 Key，其余代码不用改。

Q2：可以在 Cherry Studio / NextChat / 沉浸式翻译等客户端里用吗？
可以。这些客户端都支持自定义 OpenAI 兼容接口，填入上面的地址和 Key 即可。

Q3：图像和视频该用哪个端点？
用 POST /v1/videos，参数用 prompt（不是 messages）。服务端会按 model 自动路由到出图或出片。as- 开头的模型只支持这个端点，用 chat/completions 会报错。

Q3-1：报「无可用渠道」或「不支持此 API 路径」怎么办？
前者通常是 model 名称拼写不符；后者是端点选错了（图像/视频误用了 chat/completions）。请对照第 3.4 节表格选择端点。

Q4：视频要等多久？
通常 30 秒到几分钟。建议把超时设置为 600 秒以上。

Q5：怎么查看用量和余额？
登录站点，在「日志」中可查看每次调用的消耗，在「钱包」中可查看余额。

Q6：价格为什么有 3 位小数？
本服务按金额精确计费（保留 3 位小数、第 4 位向上取整），因此你看到的价格就是实际计费价，不会再有任何换算。

Q7：报 401 怎么办？
依次检查：① Key 是否复制完整（前后无空格）；② 请求头是否为 Authorization: Bearer sk-xxx；③ Key 是否已在「令牌」页面被删除或禁用。

Q8：模型名可以简写吗？
不可以。model 字段必须与文档中的名称完全一致，包括前缀和连字符。

九、注意事项

1. 模型名称请原样复制。名称中的前缀与连接符是系统标识的一部分，改动会导致 404 模型不存在。
2. Key 妥善保管。不要写入前端代码、不要提交到公开仓库；泄露后立即在「令牌」页面删除重建。
3. 建议显式指定规格参数（size / resolution / seconds），价格可预期。
4. 长任务请设置充足超时（视频建议 ≥ 600 秒）。
5. 本服务目前为 HTTP 协议，暂未提供 HTTPS 域名。

文档版本 v1.5 · 更新日期 2026-09-11 · 如需补充或修正，请联系服务管理员