Skip to content

API 调用约定

Base URL 与鉴权

text
BASE_URL=https://api.ruikon.com
API_KEY=sk-替换为你的密钥

通用请求头:

http
Authorization: Bearer sk-替换为你的密钥
Content-Type: application/json

Gemini 原生接口也支持 x-goog-api-key/api/v1 是网页端用户和管理员控制接口,不是普通模型调用地址。

路由速查

能力路径
OpenAI Chat CompletionsPOST /v1/chat/completions
OpenAI ResponsesPOST /v1/responses
模型列表GET /v1/models
Anthropic MessagesPOST /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 TTSPOST /v1/tts
Grok STTPOST /v1/stt
Grok RealtimeGET /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,再进行指数退避。

继续阅读

瑞科 API 文档