玺芮算力 API 文档

快速开始

1. 在 console.shinloo.com 注册并创建 API Key（sk-sl-…）。
2. 把工具指向下方的 base URL。
3. 发送你的第一个请求。

curl 试试（OpenAI 兼容）：

随时用 GET /v1/models 查询你的 Key 实时模型列表——目录始终最新且按 Key 生效。

你的接入信息

登录后这里会自动显示你自己的 Key、接入地址和余额，直接复制就行，不需要手填。

注册领 ¥10 · 管理我的 Key · 在线出图 · 在线出视频

协议与端点

三种线上格式共用同一 Key 与同一余额。请求体与响应与上游 API 字节级兼容——把官方 SDK 指向对应 base URL 即可。

• Chat Completions — Chat Completions 格式消息、函数调用、SSE 流式。适合 OpenAI 兼容 SDK、Cherry Studio 及多数工具。
• 深度求索 Messages — x-api-key 头 + anthropic-version。DeepSeek Code 与 深度求索 SDK 使用。
• Responses — 面向 Agent 的现代协议，编程工具/扩展使用。

图像生成

文生图，按张计费，和文本接口同一把 Key。三档模型，先用便宜的试稿，定稿再出高清。

提交一张图——同步返回任务号，通常 10~30 秒出图：

取结果：GET /v1/images/tasks/{task_id}，status 变成 succeeded 后返回 image_url（带签名，可直接展示或下载）；GET /v1/images/models 查可用模型，GET /v1/images/catalog 查实时价格。

Python 最小示例：

视频生成

视频生成支持万相 3.0（含 Prime）、万相 2.6（文生 / 图生）、HappyHorse 1.1 文生。与对话模型使用同一个 API 密钥、同一个余额。

• 网页版：打开 /video，粘贴密钥、描述画面即可生成。
• 接口调用：POST /v1/video/generations，参数 {model, prompt, resolution, duration} → 返回 task_id；轮询 GET /v1/video/tasks/{task_id}，status = succeeded 时取 video_url 即为成片。
• 模型：wan3.0-video、wan3.0-video-prime、wan2.6-t2v、wan2.6-i2v、happyhorse-1.1-t2v、（参考生视频，上游按次计费）。
• 价格（每 5 秒）：万相 3.0 480P ¥1.50 / 720P ¥3.00 / 1080P ¥6.00；万相 3.0 Prime 480P ¥2.25 / 720P ¥4.50 / 1080P ¥9.00；万相 2.6 720P ¥3.00 / 1080P ¥5.00；HappyHorse 1.1 480P ¥2.25 / 720P ¥4.50 / 1080P ¥6.00。任务受理时扣费，生成失败自动退回。
• 注意：生成通常 1–3 分钟；成片链接为临时地址，请及时下载。

工具配置

计费与 token

• 额度永不过期。微信支付或支付宝在线充值（最低 ¥100，也可自定义金额）：在套餐页选套餐 → 扫码付款 → 额度自动到账，通常 1 分钟内，无需提交订单号。
• 新账号注册（完成邮箱验证）即送 ¥10 测试额度，买额度前先验证网关质量。
• 按请求计量：输入、输出、缓存读取、思考 token 四类。流式与非流式同价。
• 零售价：全线按各厂商公布的官方原价计价，无隐藏倍率、无先涨后折。价格长期稳定，不随活动波动。
• 控制台可查余额与每 Key 用量；服务端用 GET /v1/balance 查询余额。
• 发票。企业客户可开增值税发票（普通发票 / 专用发票），按实际消费金额开具，抬头须与实名主体一致；把抬头、税号发给客服，7 个工作日内开出。未消费的充值余额不开票，可直接申请退款。

视觉模型

qwen3.8-max、qwen3.8-flash、minimax-m3 等支持图片理解：识别截图、读文档、OCR、分析照片。与对话模型共用同一个 API 密钥和余额。

• 调用格式（OpenAI 兼容）：

  POST /v1/chat/completions
  {
    "model": "qwen3.8-max",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "描述这张图"},
        {"type": "image_url", "image_url": {"url": "https://example.com/pic.jpg"}}
      ]
    }]
  }

• 价格：与同型号的文本调用同价（如 qwen3.8-max ¥12.00 / ¥36.00 每百万 tokens）。图片按 image tokens 计费，视尺寸约 100–1400 tokens 一张。
• 图片来源：可公开访问的 URL，或 base64 内联（data:image/png;base64,...）。

提示词怎么写

一条好提示词的骨架：主体 + 细节材质 + 环境背景 + 光线 + 镜头视角 + 风格 + 画质。中文、英文都行，越具体越可控；抽象的词模型听不懂 —— 你要写的是“看得见的东西”。

视频比图片多一层「时间与运动」，所以要写清楚镜头怎么动、主体怎么动：

• 镜头：缓推 / 缓拉 / 横移 / 环绕 / 固定机位，写一个就够。
• 动作：写一条主线动作（“女孩从左侧走入画面，抬手接住一片落叶”），不要写三件事。
• 一段 5 秒只讲一件事；想讲多件事就拆成多段，生成后拼。
• 图生视频：描述“接下来发生什么”（“画面中的猫慢慢眨眼，尾巴轻轻摆动”），不要重复描述画面里已有的东西。

通用技巧：① 先写 20~40 字主干，出图满意后再往上加细节；② 先出 1K 试稿，定稿再出 2K/4K，省钱；③ 想换风格只改风格那一段，别整套重写；④ 同一条提示词连出几张，挑最好的一张。

常见坑：① 画面里要出现的文字、logo，模型经常写错字，能不写就不写；② 别写互相矛盾的指令（既“极简”又“堆满细节”）；③ 不要指定真实名人的长相；④ 人群、手部细节最容易崩，能用远景就别用特写；⑤ 提示词不是越长越好，堆砌会互相稀释。

错误码与限流

Key 默认有保守的每分钟请求限制，可在控制台逐 Key 调整。上游中断时网关返回 5xx 而 GET /v1/models 与 /healthz 保持正常——以此判断问题在上游而非你的 Key。