> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yelinai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# API接入快速开始
> 三步完成 API 接入：注册并充值、获取 API 密钥、完成首次调用。
## 开始之前
**账户用途说明**
注册账号用于 API 技术接入测试与企业系统集成。
新账号获得的测试额度（\$0.5）仅用于：
* API 接口连通性验证
* 开发调试与技术测试
* 系统集成前的功能验证
不适用于生产环境或面向公众的内容交付服务。
你可以在 5 分钟内完成接入。本指南会帮助你：
* 用一个统一的 API 调用 200+ AI 模型
* 兼容 OpenAI SDK，只需要修改 `base_url`
## 第一步：注册并充值
### 注册账号
1. 打开注册页面：点击 **Console**，然后完成注册。
2. 注册后进入控制台，确认你已获得 \$0.5 测试额度。
### 充值
充值说明：
* 测试额度可用于验证接口连通性
* 充值秒到账，无需等待
如果你需要更高额度或企业服务，请通过邮箱或 Telegram 联系我们。
## 第二步：获取 API 密钥
### 两种方式获取密钥
* **使用默认密钥**：最快，直接复制使用
* **创建新密钥**：适合区分不同项目/环境
安全提醒：
* 密钥只显示一次，请妥善保存
* 不要提交到 GitHub 等公开仓库
* 建议使用环境变量存储
## 第三步：完成首次调用
### 测试方法
你可以任选一种方式测试：
* **Playground**：在控制台直接发起请求
* **命令行**：使用 `curl` 或你的 SDK 示例
### 接入配置信息
你只需要准备三项信息：
1. `API Key`
2. `base_url`: `https://api.yelinai.com/v1`
3. `model`
最佳实践：使用环境变量存储 API 密钥。
#### Python（OpenAI SDK）
```python theme={"system"}
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("YELIN_API_KEY"),
base_url="https://api.yelinai.com/v1",
)
resp = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
```
#### cURL
```bash theme={"system"}
curl https://api.yelinai.com/v1/chat/completions \
-H "Authorization: Bearer $YELIN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [{"role": "user", "content": "你好"}]
}'
```
提示：保存好你的 API 密钥，并定期在控制台查看使用日志。每笔请求都有记录，你可以据此优化成本。
## 下一步
先按文档跑通一个最小示例。
查看当前可用模型、价格与能力。
用 OpenAI SDK 方式完成接入。
了解如何排查调用问题与查看日志。
## 常见问题速查
不需要。你只需要一个 YeLIn AI 账号，就可以通过统一接口调用支持的模型。
支持支付宝、微信扫码支付，以及企业对公转账。
用于接口连通性验证与开发调试。不要用于生产或面向公众的内容交付。