Appearance
快速开始
本指南将带你从零开始接入 Polar API,全程约 3 分钟。
获取 API Key
步骤 1:注册账号
打开注册页 https://api.nymph.asia/register,支持两种方式:
- 邮箱注册:填写邮箱(需接收验证码)、用户名和密码完成注册
- GitHub 登录:点击「GitHub」按钮一键授权登录,无需邮箱验证
已经注册过?
直接打开 https://api.nymph.asia/login 登录即可,跳到步骤 2。
步骤 2:进入令牌管理
登录后点击右上角头像,在菜单中选择「令牌管理」(或直接访问 https://api.nymph.asia/tokens)。
步骤 3:添加新令牌
点击「添加令牌」按钮,在弹窗中配置:
| 配置项 | 说明 |
|---|---|
| 名称 | 自定义,建议写用途,如 cherry-studio |
| 无限额度 | 建议开启。不开启时若令牌额度扣完会报「余额不足」 |
| 可用分组 | 一般保持默认即可;部分用户可选择 jd、vip 等分组(详见模型一览) |
配置完成后点击「提交」。
步骤 4:复制密钥
令牌创建后,点击密钥右侧的「复制」图标,得到 sk- 开头的密钥。密钥只在创建时完整展示一次,请妥善保存。
注意事项
- 请勿将 API Key 泄露给他人,它等同于你的账户余额使用权
- 如果 Key 泄露,请立即在控制台删除该令牌并重新创建
- 建议为不同用途创建不同令牌,便于单独管理、单独停用
接口信息
| 配置项 | 值 |
|---|---|
| API 地址 | https://api.nymph.asia/v1 |
| API Key | 你在控制台获取的 sk- 密钥 |
| 支持的协议 | OpenAI、Anthropic、Gemini(详见 API 文档) |
立即测试
拿到密钥后,最快的验证方式是直接调用一次接口:
bash
curl https://api.nymph.asia/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的密钥" \
-d '{
"model": "gemini-3-flash-preview",
"messages": [{"role": "user", "content": "你好,介绍一下你自己"}]
}'bash
curl https://api.nymph.asia/v1/messages \
-H "Content-Type: application/json" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: sk-你的密钥" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好,介绍一下你自己"}]
}'bash
curl "https://api.nymph.asia/v1beta/models/gemini-3-flash-preview:generateContent?key=sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"contents": [{"parts": [{"text": "你好,介绍一下你自己"}]}]}'python
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://api.nymph.asia/v1"
)
resp = client.chat.completions.create(
model="gemini-3-flash-preview",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)javascript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的密钥",
baseURL: "https://api.nymph.asia/v1",
});
const resp = await client.chat.completions.create({
model: "gemini-3-flash-preview",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);