跳转到主要内容
本指南将引导您完成首次调用 API 所需的一切：获取密钥、安装 SDK、运行文本聊天和生成图像。

​
步骤 1 — 获取您的 API 密钥

1

打开控制台

访问https://aiapi.xiaoliu.fun/。
2

创建一个帐户

注册新账号或登录（如果您已有账号）。
3

导航至 API 令牌

点击控制台侧边栏中的**“令牌管理” 。**
4

添加令牌

点击创建新令牌，为其指定一个名称，然后点击确认。
5

复制并保存密钥

复制出现的密钥并将其保存在安全的地方。

​
步骤 2 — 安装 OpenAI SDK

api与 OpenAI SDK 完全兼容，因此您无需单独的软件包。 
pip install openai

​
步骤 3 — 进行第一次聊天

替换sk-your-api-key-here为您在步骤 1 中保存的密钥。 
import openai

client = openai.OpenAI(
    api_key="sk-your-api-key-here",
    base_url="https://aiapi.xiaoliu.fun/v1",
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "你好"}
    ],
)

print(response.choices[0].message.content)

​
步骤 4 — 生成第一张图片

支持通过标准的 OpenAI 图像 API 生成图像。 
import openai

client = openai.OpenAI(
    api_key="sk-your-api-key-here",
    base_url="https://aiapi.xiaoliu.fun/v1",
)

response = client.images.generate(
    model="qh-draw-x1-pro",
    prompt="一只可爱的小猫在花园里玩耍,油画风格,高质量,超详细",
    size="720x1280",
)

print(response.data[0].url)

​
下一步

验证

如何使用环境变量保护API密钥

模型广场

浏览所有模型

API 参考

浏览完整API文档

教程

连接到常用工具和平台

​
常见问题解答

使用标准 HTTP 状态码。您最常遇到的状态码有：
报错原因方案
401 UnauthorizedAPI密钥无效或缺失请确认密钥正确且使用了Bearer前缀
429 Too Many Requests超出速率限制添加重试逻辑，减少请求次数
500 Internal Server Error服务器端错误稍等片刻后重试请求
与 OpenAI API 标准完全兼容，因此任何拥有 OpenAI SDK 或可以发出 HTTP 请求的语言都可以开箱即用：
  • Python — 使用openai库（推荐）
  • JavaScript / TypeScript — 使用openainpm 包（推荐）
  • Java、Go、PHP、Ruby、C# ——使用它们各自与OpenAI兼容的SDK
  • 可以使用任何语言——使用标准 HTTP 客户端直接调用 REST API。
以下几种策略可以帮助您控制 API 支出：
  • 选择合适的型号——较轻的型号比旗舰型号价格更低。
  • 设置max_tokens——限制每次响应的长度，以避免输出过长。
  • 使用流式传输——如果内容足够多，使用流式传输可以提前结束响应。