快速开始

1. 创建 API Key

登录控制台 → API 密钥 → 创建密钥。密钥只在创建时完整显示一次，请立即保存到安全的位置，例如环境变量 LINK42_API_KEY；不要写进前端代码或提交到代码仓库。

创建时可以限定这把密钥能调用的模型、来源 IP 和消费上限；不需要时保持默认即可，详见本页末尾的“进阶设置”。

2. 网关地址与鉴权

数据面地址为 https://www.link42.ai。支持自定义 Base URL 的客户端填写下表对应协议的地址，客户端会自行补上接口路径。标准协议使用 Authorization: Bearer 头；Anthropic SDK 的 x-api-key 与 Gemini SDK 的 x-goog-api-key 同样被接受。

3. 第一次调用

POST/v1/chat/completions

下面的示例使用目录中当前可用的文本模型 glm-5-3-flash。想换模型时，先用同一把密钥请求 GET https://www.link42.ai/v1/models，把 model 换成返回结果中的另一个 id。

curl https://www.link42.ai/v1/chat/completions \
  -H "Authorization: Bearer $LINK42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5-3-flash",
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

import os
from openai import OpenAI

client = OpenAI(base_url="https://www.link42.ai/v1", api_key=os.environ["LINK42_API_KEY"])
response = client.chat.completions.create(
    model="glm-5-3-flash",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://www.link42.ai/v1", apiKey: process.env.LINK42_API_KEY });
const response = await client.chat.completions.create({
  model: "glm-5-3-flash",
  messages: [{ role: "user", content: "用一句话介绍你自己" }],
});
console.log(response.choices[0].message.content);

• 以官方接入价为基准：账号模型专属、账号默认、模型默认折扣依次取第一个已设置的值；均未设置按原价。0 折免费，10 折原价，不叠加分组或服务档位倍率。提交时冻结价格与折扣，历史账单不重新计价。
• 响应头 X-Request-Id 是排障凭据，联系支持时请附上。

下一步

文本对话请看 OpenAI Chat Completions 或 Anthropic Messages；图片生成看 Images；视频生成是异步任务，看“视频任务”；在 Claude Code、Codex、Cursor 等工具里使用，看“AI 编程工具接入”。

进阶设置

每把密钥可以单独设置指定模型名单（allowed_models）、模型类别授权（allowed_model_groups）、来源 IP 白名单、总/日/月消费上限、RPM/TPM/并发限制、过期时间与启停状态。这些消费上限属于该密钥本身。路由分组（group_id）是另外的路由约束，并不是指定模型授权的唯一方式，也不改变新请求的模型售价。

新建密钥以 sk- 开头，使用 standard_v1 兼容档案；从旧系统迁移的 ak- 密钥保留 legacy_v1 档案，行为逐字兼容旧接口。旧 /v1/messages 与 /v1beta/models/... 路径仍兼容；Gemini SDK 的自定义地址支持取决于版本和运行模式。从旧系统迁移请看“私有协议兼容层”。