三种方式接入 LINK42
开发项目用 SDK，Agent 用 Skill，现成工具直接填写接口地址与模型 ID。三种方式共用同一账户、密钥和美元账本。
按使用场景选择
SDK
在 Node.js 或 Python 服务端开发。私密保存一把 LINK42 Key；SDK 处理请求、任务与素材上传。
Agent Skill
把安装提示词交给支持 Skill 的 Agent。首次私密授权 Key 后，它自动发现模型 ID 和参数。
直接 API
给兼容工具或自己的 HTTP 客户端填写接口 Base URL、Key 和准确的已授权模型 ID。
- 网页登录会话不能代替 API Key。三种方式都不能绕过模型授权、来源 IP、预算和美元钱包；安装 Skill 不收费，实际模型调用可能收费。
1. 开发项目：使用 SDK
官网提供 Node.js 20+ 与 Python 3.10+ 的第一方安装包，无需第三方商店。把 Key 存在服务端安全环境中；先通过 models.list 查看当前 Key 可用的模型 ID，再调用对应资源。付费 POST 不会自动重试。
npm install https://www.link42.ai/downloads/sdk/link42-sdk-0.1.6.tgzpython -m pip install https://www.link42.ai/downloads/sdk/link42-0.1.6-py3-none-any.whl2. 交给 Agent：安装 Skill
把安装提示词发给支持 Skill 的 Agent。安装器会校验官网 ZIP，安装时不需要 Key。首次使用时，只在宿主安全环境授权自己的 Key，不要发在对话中；未指定型号时，Agent 比较通过参数校验的授权模型之美元预估价。最低预估价不代表画质或上游实时可用，付费生成仍按你的任务和预算授权。
3. 现成工具：直接填写接口与模型 ID
GET/v1/models
支持自定义 OpenAI 兼容供应商的工具，填写 Base URL：https://www.link42.ai/v1；API Key：自己的 LINK42 Key；模型 ID：GET /v1/models 返回的准确 id。不要填写网页数字 ID、展示名称或上游厂商密钥。部分工具有专属协议或写死的厂商功能，只能兼容它实际开放的接口。
表格中的 Base URL 可直接复制：Anthropic 客户端自动追加 /v1/messages；Gemini REST 再拼接 /v1beta/models/{model}:generateContent。Gemini SDK 是否支持自定义地址取决于版本与运行模式。
| 工具所用协议 | Base URL | 模型字段 |
|---|---|---|
| OpenAI 兼容 | https://www.link42.ai/v1 | GET /v1/models 返回的 data[].id |
| Anthropic Messages | https://www.link42.ai/anthropic | 已授权的文本模型 ID |
| Gemini generateContent REST | https://www.link42.ai/gemini | 已授权的模型 ID |
curl https://www.link42.ai/v1/models -H "Authorization: Bearer $LINK42_API_KEY"
# Replace MODEL_ID with one exact data[].id from the response.
curl https://www.link42.ai/v1/chat/completions \
-H "Authorization: Bearer $LINK42_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"MODEL_ID","messages":[{"role":"user","content":"Hello"}]}'按模型任务选择接口
模型 ID 以当前 Key 可见的目录为准。模型上架不代表支持所有协议或参数；先核对模态与能力。异步任务返回任务 ID，后续查询原任务，不要重复提交付费请求。
| 任务 | 接口 | 模型要求 |
|---|---|---|
| 文本与受支持的视觉理解 | POST /v1/chat/completions 或 /v1/responses | 已授权、支持所需输入的文本模型 |
| 图片生成 | POST /v1/images/generations | 已授权图片模型及其支持的尺寸、张数 |
| 异步图片 | POST /v1/images/generations/async；GET /v1/images/tasks/{id} | 已授权图片模型；保存任务 ID |
| 视频生成 | POST /v1/videos；GET /v1/videos/{id} | 已授权视频模型及其支持的素材、时长、分辨率 |
| 向量 | POST /v1/embeddings | 当前确有上架且已授权的向量模型 |