Skip to content

快速开始 ​

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。
  • 先用小额度密钥做灰度验证,再提高额度。

客户支持:syndredyoung@gmail.com · 请勿将 API Key 写入前端代码或公开仓库