接入智流万象

快速上手

推荐先完成一次最小闭环：创建 Key、复制 Key、调用模型、查看用量。确认链路可用后， 再根据业务场景调整模型范围、预算和有效期。

核心概念

平台围绕“模型目录、平台 Key、预算周期、用量审计”组织能力。理解这些概念后， 用户可以清楚知道一次调用为什么能通过、花了多少钱，以及后续在哪里排查。

请求地址

业务侧调用平台统一入口，不需要直接维护上游模型供应商地址。正式域名以控制台展示为准； 本地开发时可以使用 Java 网关暴露的本地地址。

鉴权方式

所有模型调用都需要在请求头中传入平台 Key。平台会根据该 Key 判断用户身份、 Key 状态、可用模型范围、预算余额和有效期。

对话接口

对话接口兼容 OpenAI Chat Completions。常见参数包括 model、messages、temperature 和 stream。 调用成功后，响应中会包含模型输出和本次请求的 tokens 用量。

curl https://api.zhiliuwanxiang.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-platform-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      { "role": "user", "content": "用一句话介绍智流万象" }
    ],
    "temperature": 0.3,
    "stream": false
  }'

请求参数

响应示例

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "model": "deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "智流万象提供统一的大模型 API 网关，并追踪每一次调用的用量与费用。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 32,
    "total_tokens": 50
  }
}

流式输出

当客户端需要边生成边展示内容时，可以将 stream 设置为 true。若客户端或调试工具暂不支持流式响应， 请显式传入 stream: false，使用普通 JSON 响应。

curl https://api.zhiliuwanxiang.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-platform-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      { "role": "user", "content": "写一个三点式产品介绍" }
    ],
    "stream": true
  }'

模型列表

使用当前 Key 查询可访问模型。返回结果会受到 Key 的模型范围、状态、预算和有效期影响。 这也是排查“模型不可用”的第一步。

curl https://api.zhiliuwanxiang.com/v1/models \
  -H "Authorization: Bearer sk-your-platform-key"

创建 Key

在控制台的 Key 与用量模块创建平台 Key。创建成功后，完整 Key 应第一时间保存； 后续列表通常只展示脱敏值，避免凭证泄露。

1. 1. 点击“创建 Key”，填写名称和备注。
2. 2. 按需展开高级配置，设置模型范围、预算、预算刷新周期和有效期。
3. 3. 创建成功后复制完整 Key，并在业务服务中使用。

Key 配置

Key 配置用于控制可调用范围和费用边界。建议按照业务用途创建不同 Key， 例如开发调试、生产服务、部门项目、员工个人工具等。

用量查询

控制台会聚合展示费用、tokens、请求次数、模型拆分和小时趋势。当前用户只能查看自己名下的 Key 与用量； 后续团队版本会扩展到团队、部门、成员和项目维度。

预算刷新

预算用于限制 Key 在当前周期内的最大消费。刷新周期决定额度何时进入下一轮统计。 若未设置预算上限，Key 不会因为预算耗尽而被平台拦截，但仍会记录费用和 tokens。

错误码

接口错误通常分为鉴权失败、权限不足、预算或限流触发、上游服务异常四类。排查时先确认 Key， 再确认模型范围和预算状态。

接入建议

• • 按业务场景拆分 Key，避免所有调用共用一把 Key。
• • 为生产 Key 设置预算上限和有效期，降低异常调用风险。
• • 用 /v1/models 校验当前 Key 可访问模型，减少模型名配置错误。
• • 将请求 ID、业务用户 ID 或项目 ID 写入业务日志，方便和平台用量明细对账。
• • 对长回答、批量任务和工具调用场景设置合理超时，避免客户端提前断开。

常见问题