接入文档
网关兼容 OpenAI Chat Completions。下面的地址来自环境变量。
快速开始
基础地址是 https://infapi.cc/v1。先在 令牌页 创建密钥,再把它放到 Authorization: Bearer 头里。
下面用目录中的 Pareto 26.9 作为例子。换成任意文本模型即可。
cURL
curl https://infapi.cc/v1/chat/completions \
-H "Authorization: Bearer $INFAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"unbiased/pareto-26.9","messages":[{"role":"user","content":"用三句话介绍你自己。"}],"temperature":0.7,"max_tokens":512}'鉴权
除了本站用来展示目录的公开价格接口,OpenAI 兼容接口都需要密钥。不要把密钥写进仓库。浏览器里的试验场只把密钥存在 localStorage。
Header
Authorization: Bearer $INFAPI_API_KEY
Content-Type: application/json模型列表
GET /v1/models 返回当前密钥能调用的模型,需要鉴权。响应是 OpenAI 的 list 形状,模型 ID 与目录页一致。
cURL
curl https://infapi.cc/v1/models \
-H "Authorization: Bearer $INFAPI_API_KEY"JSON
{
"object": "list",
"data": [
{
"id": "<model-id>",
"object": "model",
"owned_by": "<author>"
}
]
}每个模型支持哪些参数,以模型详情上的参数列表为准。公开价格接口 GET /api/pricing 不需要密钥,本站用它判断模型是否已接入。 模型详情
对话补全
POST /v1/chat/completions。model 用目录里的完整 ID。messages 是 role / content 数组。stream 设为 true 时,响应是 SSE,数据行以 data: [DONE] 结束。
也可以用官方 OpenAI SDK,把 base_url 指到 https://infapi.cc/v1。部分模型另外支持 POST /v1/images/generations,试验场目前只覆盖对话接口。
参数
下面是目录里实际出现过的参数,以及有多少模型声明支持。没有列出的字段不要假设可用。
| 参数 | 说明 | 模型数 |
|---|---|---|
max_tokens输出上限 | 最多生成多少 token。达到上限会截断。 | 485 |
response_format响应格式 | 例如 json_object 或 json_schema,用于约束输出形状。 | 415 |
tools工具 | 传入函数工具定义,模型可以返回 tool_calls。 | 393 |
structured_outputs结构化输出 | 按 JSON Schema 生成可解析的结构。 | 386 |
tool_choice工具选择 | 控制是否调用工具:auto、none,或指定某个函数。 | 385 |
temperature温度 | 采样温度。越低越稳定,越高越发散。常见范围 0 到 2。 | 379 |
seed随机种子 | 固定种子有助于复现采样结果,不保证字节级一致。 | 371 |
top_p核采样 | 只在累计概率达到 top_p 的 token 里采样。 | 359 |
include_reasoning返回推理 | 是否在响应里带上推理摘要。 | 334 |
reasoning推理 | 打开或配置模型的推理过程。具体字段因模型而异。 | 334 |
stop停止词 | 生成到这些字符串时停止。可以是字符串或字符串数组。 | 296 |
frequency_penalty频率惩罚 | 按 token 已出现的次数降低它再次出现的概率。 | 239 |
presence_penalty存在惩罚 | 只要 token 出现过就降低它再次出现的概率。 | 223 |
reasoning_effort推理强度 | 调节推理花多少计算,常见取值 low、medium、high。 | 208 |
top_kTop-K | 只从概率最高的 K 个 token 里采样。 | 205 |
logprobs对数概率 | 返回每个输出 token 的对数概率。 | 149 |
top_logprobs候选对数概率 | 每个位置额外返回概率最高的若干候选。 | 149 |
repetition_penalty重复惩罚 | 对已经生成过的内容施加重复惩罚,常见于开源模型。 | 146 |
logit_biasLogit 偏置 | 按 token id 加减分,用来鼓励或禁止某些 token。 | 133 |
min_p最小概率 | 丢掉概率低于该阈值的 token。 | 108 |
verbosity详略 | 提示模型回答更简略或更详细。 | 98 |
max_completion_tokens补全上限 | 与 max_tokens 类似,部分新模型改用这个字段限制输出长度。 | 79 |
web_search_options网页搜索 | 让支持搜索的模型在回答前检索网页。 | 19 |
top_aTop-A | 按相对概率动态收窄候选 token。 | 15 |
parallel_tool_calls并行工具 | 是否允许同一轮返回多个工具调用。 | 14 |
prediction预测输出 | 提供预计会原样出现的文本,以降低延迟或费用。 | 12 |
计费与错误
- 一把密钥可以调用目录里的全部模型,按每个模型自己的标价计费。
- 目录价格按公开标价展示。Token 价格换算成每百万 tokens,图像和搜索按次或按张。
- 标成动态计价的路由模型没有固定单价,实际费用取决于被转到哪个模型。
- 401 表示密钥缺失或无效。模型 ID 不存在或当前未上架时,调用会失败。
- 429 是限流或额度用尽。响应体里的 message 会说明原因。