Appearance
快速开始
1. 创建账户和 API Key
打开 登录页面,可使用 Google 登录,或用邮箱验证码登录;邮箱首次验证成功时会自动创建账号。登录控制台后,在“API 密钥”中创建独立密钥。建议一个应用使用一个 Key,并设置合理额度和有效期。完整 Key 只会在创建时展示,请妥善保存。
新注册用户初始额度为 0。需在账户获得有效额度后才能调用收费模型。
2. 配置基础地址
OpenAI 兼容客户端使用:
text
https://selfapi.org/v1鉴权请求头:
http
Authorization: Bearer sk-你的SelfAPI密钥3. 查询可用模型
bash
curl https://selfapi.org/v1/models \
-H "Authorization: Bearer $SELFAPI_API_KEY"请使用接口实际返回的模型 ID。不要把网页展示名自行改写为模型 ID。
4. 发起最小请求
bash
curl https://selfapi.org/v1/chat/completions \
-H "Authorization: Bearer $SELFAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-flash",
"messages": [{"role": "user", "content": "Reply with OK"}],
"max_tokens": 16,
"stream": false
}'5. 上生产前
- 设置 30–120 秒客户端超时,并按业务容忍度调整。
- 仅对
429、500、502、503、504做有限次数指数退避。 - 为重复提交或异步任务设计幂等键,避免重复扣费。
- 记录 SelfAPI 返回的请求标识、HTTP 状态码、模型名和发生时间,不要记录完整 Key。
- 先用小额度密钥做灰度验证,再提高额度。
