心流 API

Appearance

快速开始 ​

两条路径，选你习惯的方式。都需要先注册账号。

获取 API Key ​

  1. 访问 iliu.ai 注册账号（需要邮箱验证码激活）
  2. 登录后台 → 令牌 → 添加令牌
  3. 复制生成的 Key（格式 sk-xxxxxxxx）

💡 API Key 就像一把钥匙，用来证明你的身份和使用权限。请勿分享给他人，泄漏立即在后台删除该 Token。

🖥️ 我不会编程 ​

本平台自带体验中心，注册后即可直接使用，无需安装任何软件。

登录后台 → 进入 体验中心，选择模型，输入内容，直接开始对话。支持文本对话、图片生成、视频生成。

💡 如果你是开发者，需要将 AI 集成到自己的产品中，请参考下方「我会编程」部分。

💻 我会编程 ​

1. 直接调用 API ​

bash
curl https://iliu.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"model":"gpt-5.1","messages":[{"role":"user","content":"你好"}]}'

Python（pip install openai）：

python
from openai import OpenAI

client = OpenAI(base_url="https://iliu.ai/v1", api_key="sk-xxxxxxxx")
resp = client.chat.completions.create(
    model="gpt-5.1",
    messages=[{"role":"user","content":"你好"}]
)
print(resp.choices[0].message.content)

Node.js（npm install openai）：

javascript
import OpenAI from "openai";
const client = new OpenAI({ 
  baseURL: "https://iliu.ai/v1", 
  apiKey: "sk-xxxxxxxx" 
});
const resp = await client.chat.completions.create({ 
  model: "gpt-5.1", 
  messages: [{role:"user", content:"你好"}] 
});
console.log(resp.choices[0].message.content);

成功响应：

json
{
  "id": "msg_3d2d24e3d67d4b20a462cff019e01c17",
  "model": "gpt-5.1",
  "object": "chat.completion",
  "choices": [{
    "message": {"role":"assistant","content":"你好！有什么可以帮助你的？"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens":13,"completion_tokens":8,"total_tokens":21}
}

💡 gpt-5.1 默认在 default 分组可用。如需切换模型，替换 model 字段即可（如 claude-opus-4-7 / gemini-3-pro-preview / deepseek-v4-pro）。海外环境可将 cdn.wusag.com 换为 api.xinliu.one。

2. 查看可用模型 ​

bash
curl https://iliu.ai/v1/models -H "Authorization: Bearer $API_KEY"

返回你当前 Key 可用的完整模型清单，包括 model_type（对话/图像/视频）、tags、supported_endpoint_types 等元信息。

3. 通用配置 ​

所有兼容 OpenAI 的 SDK 和工具，只需改两处：

配置项值
Base URLhttps://iliu.ai/v1
API Keysk-xxxxxxxx

💡 详细的 SDK 接入教程 / 桌面客户端配置（Cherry Studio、NextChat、Cursor、Continue、Dify 等）见「各种插件/软件使用教程」文件夹。

三种 API 协议 ​

心流对外暴露三种主流协议，可按你熟悉的选：

协议端点适用模型
OpenAI 兼容（最常用）POST /v1/chat/completions全部 47 个对话模型
Anthropic 原生POST /v1/messagesClaude 4.x 全系
Gemini 原生POST /v1beta/models/{model}:generateContentGemini 2.x / 3.x 全系

📖 详见「语言大模型」文件夹下三种协议的端点文档。

排错 ​

错误原因解决
401 未提供令牌Header 缺失或格式错误检查 Authorization: Bearer sk-xxx
401 令牌无效Key 已失效后台重新生成
402 余额不足额度耗尽后台充值
404 模型不存在分组不含此模型调 GET /v1/models 确认可用列表
429 频率限制并发过高降低频率或联系客服
503 上游不可用临时异常换 api.xinliu.one 线路，等几分钟重试

🔍 No available channel for model xxx under group xxx — 你的分组不包含该模型，联系客服切换分组。

下一步 ​

  • 📖 API 端点文档 — 每个接口的完整参数、示例、返回响应
  • 📊 后台「模型价格」 — 查看实时定价、分组倍率、模型清单
  • 📢 GET /api/status — 查看系统公告与线路状态
  • 🎯 「使用教程」 — SDK、桌面客户端、工作流、编辑器一键接入
  • ❓ 「帮助中心」 — 常见问题、错误码大全、账户与计费