API 调用约定
Base URL 与鉴权
text
BASE_URL=https://api.ruikon.com
API_KEY=sk-替换为你的密钥通用请求头:
http
Authorization: Bearer sk-替换为你的密钥
Content-Type: application/jsonGemini 原生接口也支持 x-goog-api-key。/api/v1 是网页端用户和管理员控制接口,不是普通模型调用地址。
路由速查
| 能力 | 路径 |
|---|---|
| OpenAI Chat Completions | POST /v1/chat/completions |
| OpenAI Responses | POST /v1/responses |
| 模型列表 | GET /v1/models |
| Anthropic Messages | POST /v1/messages |
| Gemini 原生 | POST /v1beta/models/{model}:generateContent |
| OpenAI 生图 | POST /v1/images/generations |
| OpenAI 生图编辑 | POST /v1/images/edits |
| Grok 视频创建 | POST /v1/videos 或 /v1/videos/generations |
| Grok 视频状态 | GET /v1/videos/{request_id} |
| Grok 视频内容 | GET /v1/videos/{request_id}/content |
| Grok TTS | POST /v1/tts |
| Grok STT | POST /v1/stt |
| Grok Realtime | GET /v1/realtime(WebSocket) |
| Seedance 视频创建 | POST /v1/video/generate |
| Seedance 任务查询 | GET /v1/video/tasks/{task_id} |
模型和分组
模型必须是 API Key 当前分组允许的模型:
bash
curl "$BASE_URL/v1/models" -H "Authorization: Bearer $API_KEY"
curl "$BASE_URL/v1beta/models" -H "Authorization: Bearer $API_KEY"流式、超时与重试
- 文本流式响应使用 SSE,读取
data:行直到[DONE]。 - 图片可能超过 30 秒,客户端不要使用固定 30 秒超时。
- Seedance 创建接口返回任务后,应轮询任务状态,不要重复提交创建请求。
- 收到 429 时优先遵循
Retry-After,再进行指数退避。