上手教程：聊聊怎么用阁下AI的API
最近有不少朋友问起怎么接阁下AI的API，正好我自己也折腾过一阵，把一些经验整理出来，应该对刚接触的朋友有帮助。
第一步：先拿到钥匙（API Key）
- 去官网（gexia.com）注册个账号，这个过程挺快的
- 登录之后，在页面里找找「开发者中心」或者「API服务」的入口
- 点「创建API Key」，起个自己能记住的名字（比如“测试用”），复制好生成的那串字符（长得像 sk-xxxx），这个页面关了可就看不到了，记得第一时间保存
第二步：简单配置一下
- 接口地址：
https://api.gexia.com/v1 - 认证方式：需要在请求头里带上你的密钥
- 建议装个
python-dotenv，把密钥存在环境变量里，别直接写死在代码里
安装（Python为例）
pip install openai
# 或者用 requests 也行
pip install requests python-dotenv
第三步：开始调用
方法一：用官方SDK（最省事）
import openai
# 配置你的密钥和地址
openai.api_key = "你的密钥"
openai.api_base = "https://api.gexia.com/v1"
# 发请求
response = openai.chat.completions.create(
model="nano-banana-pro", # 选个模型
messages=[
{"role": "user", "content": "写一首短诗"}
],
temperature=0.7, # 数值越高回答越随机
max_tokens=200
)
print(response.choices[0].message.content)
方法二：直接用 requests 发请求
import requests
import json
url = "https://api.gexia.com/v1/chat/completions"
headers = {
"Authorization": "Bearer 你的密钥",
"Content-Type": "application/json"
}
data = {
"model": "nano-banana-pro",
"messages": [{"role": "user", "content": "你好"}]
}
r = requests.post(url, headers=headers, json=data)
print(r.json())
几个常用接口：
- 对话：
/v1/chat/completions - 模型列表：
/v1/models（可以看看有哪些能用）
几个实用小提醒
- 密钥安全：千万别把密钥传到公开仓库，用环境变量最稳妥
- 流式输出：需要生成长文本时，建议开
stream=True，体验会好很多 - 控制长度：根据需要设
max_tokens，避免不必要的消耗 - 错误处理：代码里加个 try-catch，网络问题或者密钥失效时能有个提醒
try:
# 你的调用代码
except Exception as e:
print(f"出错了：{e}")
你可能想知道
- 收费：一般按 token 数算（输入+输出），新注册通常有免费额度可以试试水
- 模型：不同模型能力侧重点不太一样，可以多试试哪个更适合你的需求
- 限制：会有频率限制，避免刷接口，正常用基本碰不到
最后
其实接起来挺简单的，三步：拿密钥、配环境、调接口。而且因为它和 OpenAI 的接口格式兼容，很多现成的代码或项目改个地址就能用，省了不少事。
如果在用的过程中碰到问题，官方文档写得挺全的，或者多搜搜，大部分坑前人都踩过了。
希望能帮到你。用 API 的过程就像搭积木，慢慢拼凑出自己想要的功能，其实挺有意思的。
