接入文档
OpenAI 兼容 · base_url https://neyino.com/ai/v1 · 1 N = ¥7.3 ≈ $1 · 免费模型不限量(限速 30 次/分) · 默认模型 z-ai/glm-5.3-flash(不传 model 时自动使用) · 模型广场
快速开始
from openai import OpenAI
client = OpenAI(base_url="https://neyino.com/ai/v1", api_key="nyi-你的Key")
resp = client.chat.completions.create(
model="z-ai/glm-5.3-flash",
messages=[{"role": "user", "content": "你好"}],
stream=True, # 推荐开启,避免长回复被 CDN 断开
)
for chunk in resp:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Node.js / TypeScript 示例
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://neyino.com/ai/v1",
apiKey: "nyi-你的Key",
});
const res = await client.chat.completions.create({
model: "z-ai/glm-5.3-flash",
messages: [{ role: "user", content: "你好" }],
stream: true,
});
for await (const chunk of res) process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
curl 冒烟测试
curl -N https://neyino.com/ai/v1/chat/completions \
-H "Authorization: Bearer nyi-你的Key" \
-H "Content-Type: application/json" \
-d '{"model":"z-ai/glm-5.3-flash","stream":true,"messages":[{"role":"user","content":"你好"}]}'
获取模型列表(含全部动态模型)
curl https://neyino.com/ai/v1/models -H "Authorization: Bearer nyi-你的Key"
当前免费池(分门别类)
以下精选免费模型按能力分组,全部 $0 不限量(限速 30 次/分);池子随上游轮换自动更新(下架自动摘除、恢复自动回归)。
通用
nvidia/nemotron-3.5-super-vl:free
旗舰
nvidia/nemotron-3-ultra-550b-a55b:free
轻快
nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free · nvidia/nemotron-3.5-lightning:free
代码
recursive/flint-v1.0:free
自动路由
openrouter/free
另有 openrouter/free:自动路由器,每次从整个免费池随机挑选模型回答(池内候选以模型广场「免费」筛选为准)。
实际应答模型可通过响应头 X-Neyino-Upstream-Model(或流式 finish 块的 neyino_upstream_model 字段)查看。
会话记忆(永久记忆)
请求体加 thread_id(1-64 位字母数字下划线横线),同 Key 隔离;全部历史永久保存,超长会话自动压缩为长期记忆摘要。
{"model": "z-ai/glm-5.3-flash", "thread_id": "my-chat-1",
"messages": [{"role": "user", "content": "我叫小明"}]}
# 下次请求用同一个 thread_id,AI 仍记得你叫小明
流式事件(SSE)
请求体加 stream: true,响应为 text/event-stream:
data: {"choices":[{"delta":{"content":"你"}}]}
data: {"choices":[{"delta":{"content":"好"}}]}
data: {"choices":[{"delta":{},"finish_reason":"stop"}],
"neyino_upstream_model":"z-ai/glm-5.3-flash"}
data: [DONE]
delta.content:增量文本,逐块拼接渲染neyino_upstream_model(finish 块):实际应答的上游模型;也可读响应头X-Neyino-Upstream-Modeldata: [DONE]:流结束信号
深度模式
自动审查并修订答案,质量更高,token 消耗约 2 倍。
{"model": "deepseek/deepseek-chat", "deep": true,
"messages": [{"role": "user", "content": "分析分布式推理的可行性"}]}
计费说明
- 1 N = ¥7.3 ≈ $1;付费模型按输入/输出 tokens 扣 N,预检不足返回 402;付费模型价格与 OpenRouter 官网实时一致(成本价,平台利润来自充值差价)
- 免费模型不扣 N、不限量,限速 30 次/分钟(超出返回 429)
- 模型 ID 采用主流厂商命名(如
openai/gpt-6.1-sol),任意目录内模型首次调用即自动开通 - 非流式请求超过 100 秒会被 CDN 断开,长回复请使用
stream=true
错误码
| 状态码 | 含义 | 处置 |
|---|---|---|
401 | API 密钥无效或已过期 | 到 API 页重新创建 nyi- 密钥 |
402 | N 余额不足(付费模型预检) | 充值或改用免费池模型 |
404 | 模型不存在 | 核对 model 与模型广场一致(区分大小写) |
429 | 触发限流(免费池或上游) | 退避后重试;付费模型 429 通常为上游透传 |
502/503 | 上游异常或熔断中 | 稍后重试;持续失败可在广场换同档模型 |
限流
- 免费池:30 次/分钟/密钥;触发 429 请退避重试
- 付费模型:不限制本站并发,上游供应商的限流(429)原样透传
- 流式请求与普通请求共享同一限流计数;建议客户端指数退避(0.5s 起)
常见问题
如何计费?支持哪些支付方式?
免费模型真的免费吗?
一个 Key 可以同时并发请求吗?
如何确认实际应答的上游模型?
X-Neyino-Upstream-Model,或流式 finish 块的 neyino_upstream_model 字段。会话记忆会上传我的内容吗?
thread_id 的请求内容会存入你的账号下用于多轮记忆(不用于训练);不传 thread_id 则不落任何会话历史。机器可读版本:llms.txt(站点与 API 摘要) · llms.txt (EN) · 更新 Atom feed · sitemap