快速上手

几分钟拿到你的 Zhen AI API Key

一个账号、一把密钥,调通所有前沿模型。下面是从注册到第一个流式 token 的最短路径。

1. 注册账号

几秒钟搞定 —— 新账号自带免费试用额度,无需信用卡。

2. 登录控制台

租户、密钥、用量分析和账单,全部在控制台一处管理。

3. 创建密钥

在「密钥」页面生成。完整密钥只展示一次,请及时妥善保存。

4. 调用 API

把任意兼容 OpenAI / Anthropic / Gemini 的 SDK 指向 Zhen AI 端点即可 —— 代码零改动。

5. 查看用量与账单

实时跟踪请求数、token 与消费,随业务增长随时充值或升级套餐。

统一端点

无缝替换的鉴权方式

所有密钥都用标准 Bearer 头鉴权。同一把密钥可用于 OpenAI、Anthropic、Gemini 三种请求格式 —— 你写哪个模型名,Zhen AI 就路由到哪个上游。

  • Authorization: Bearer sk-...
  • 流式与非流式响应均支持
  • 改一下 model 字段就能换厂商 —— 其余代码一行都不用动
request.sh
curl https://api.zhenx.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.2",
    "messages": [{"role":"user","content":"Hi"}],
    "stream": true
  }'
视频 API

用 API key 直接生成 Seedance 2 视频

向 www.zhenx.ai 的 POST /v1/videos 提交 Seedance 2.0 或 Wan 3.0 Prime 任务（model 为 seedance-2.0 / wan3.0-prime），按与工作台相同的每秒单价从 Metered credit 扣费。轮询任务状态，7 天内下载成片 —— 文件归你保存，站内不会展示。

  • 在 key 的模型白名单里勾选 seedance-2.0 和/或 wan3.0-prime —— 未限制模型的 key 不能生成视频。
  • 生成前 Metered credit 余额须不少于 $2.00；若本次任务会让余额低于 $2.00，请求会被拒绝（HTTP 402）。请在 Billing → Metered credit 充值 $5 或以上。
  • 成片仅对你的 key 可见，7 天后自动删除；GET …/content 流式下载（支持 Range），DELETE 可提前删除。

视频 API 只在 www.zhenx.ai 上提供；api.zhenx.ai 是聊天中转域名，不提供 /v1/videos。

video.sh
# submit (202 → {"id": "gen_...", "status": "queued", ...})
curl https://www.zhenx.ai/v1/videos \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "a koi fish leaping out of an ink-wash river",
    "resolution": "720p", "duration": 10, "ratio": "16:9"
  }'

# poll until "status": "completed"
curl https://www.zhenx.ai/v1/videos/gen_... \
  -H "Authorization: Bearer sk-..."

# download within 7 days
curl -L -o clip.mp4 https://www.zhenx.ai/v1/videos/gen_.../content \
  -H "Authorization: Bearer sk-..."

分步说明

  1. 1. 充值 Metered credit

    登录 → Billing → Metered credit。最低充值 $5（支付宝/微信 ¥40）。视频按量从这个钱包扣费，套餐不覆盖。

  2. 2. 创建勾选了 seedance-2.0 的 key

    Keys → Create key。在「Video models」一组里勾选 seedance-2.0，点 Create，复制只显示一次的 sk- key。白名单为空的 key 能调所有聊天模型，但**不能**生成视频——视频权限只来自这一个勾。已有 key 不能修改，请新建一把。

  3. 3. 提交任务

    POST https://www.zhenx.ai/v1/videos，带 model、prompt、resolution、duration 和 ratio。seedance-2.0：720p / 1080p / 4k，5 / 10 / 12 / 15 秒；wan3.0-prime：480p / 720p / 1080p，5–30 秒，ratio 可为 adaptive，另可选 negative_prompt、prompt_extend 与 frame_mode "frames"（参考图作为首尾帧）。返回 202，含任务 id、精确价格和剩余余额。此时价格已从钱包预扣。

  4. 4. 轮询，7 天内下载

    GET /v1/videos/{id} 直到 status 为 completed，再 GET /v1/videos/{id}/content 流式下载 MP4（支持 Range）。任务失败全额退回。DELETE /v1/videos/{id} 可提前删除成片。

价格 = 分辨率每秒单价 × 时长（秒），四舍五入到分，提交前即可确定——202 响应与控制台 Billing → Metered credit 卡片显示的是同一组数字。可选参数：generate_audio、seed、reference_images（先用 POST /v1/videos/uploads 上传，multipart 字段 `file`）。

可能遇到的响应

402 insufficient_metered_credit余额低于 $2，或本次任务会让余额低于 $2。响应里有 balance_usd、estimated_cost_usd、required_usd（能让任务跑起来的充值额）和 topup_url。
403 model_not_allowed这把 key 没有勾 seedance-2.0。请新建一把勾选了它的 key。
429 rate_limited单 key 同时超过 3 条任务在跑，或一分钟内提交超过 10 次。
422 content_rejected上游内容审核拒绝了提示词或参考图，不扣费。
410 content_expired成片已离开存储——过了 7 天或你已删除。请自行保存副本。
推理强度控制

模型思考多深，由你决定

推理型模型接受可选的 reasoning_effort 字段。真 AI 原样透传给上游模型 —— 我们不塞默认值、不封顶、也不改写你传的内容，答案质量、延迟与花费之间怎么取舍完全由你掌握。

可用取值

none
完全不推理 —— 最快也最省。适合简短的事实性回答、信息抽取和格式化。
low
简短思考。日常对话和简单工具调用的合理档位。
medium
面向多步问题的均衡深度。
high
面向复杂分析、方案规划和长链 agent 循环的深度推理。
max
模型能提供的最深档位。最慢，消耗的输出 token 也最多。
reasoning.sh
curl https://api.zhenx.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.2",
    "messages": [{"role":"user","content":"Plan this migration"}],
    "reasoning_effort": "high",
    "stream": true
  }'
  • 不传这个字段，模型就用它自己的默认档位。
  • 推理 token 按输出 token 计费，档位越高花得越多 —— 请按需调高，不要默认拉满。
  • 不具备推理能力的模型会忽略该字段。上表以外的取值会被上游以 400 拒绝。

准备好开始了吗?