API 文档
标准 OpenAI 兼容接口。订阅任意套餐后,在账户页创建 API Key 即可使用。
接入信息
- Base URL
https://ranni.dev/api/v1- 鉴权
Authorization: Bearer rn-…- 可用接口
- POST /chat/completions(支持流式)、GET /models
模型
DeepSeek-V4-Flash-0731(也接受 deepseek-v4-flash) · 上下文 1M · 最大输出 384KDeepSeek-V4-Pro-0813(也接受 deepseek-v4-pro) · 上下文 1M · 最大输出 384KcURL 示例
curl https://ranni.dev/api/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer rn-你的Key" \
-d '{
"model": "DeepSeek-V4-Flash-0731",
"messages": [{"role": "user", "content": "你好"}],
"stream": true
}'OpenAI SDK(Python)
from openai import OpenAI
client = OpenAI(
api_key="rn-你的Key",
base_url="https://ranni.dev/api/v1",
)
resp = client.chat.completions.create(
model="DeepSeek-V4-Pro-0813",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)计费说明
- 按 DeepSeek 官方牌价 1:1 扣减额度,无加价。
- 输入按缓存命中 / 未命中分别计价,输出单独计价。
- 高峰(UTC 01:00–04:00、06:00–10:00)与低谷两套价格,低谷减半。
- 余额为 0 时接口返回 402(insufficient_credits)。
- 额度当期有效,账期结束不滚存。