快速开始

PRIMAL API 兼容 OpenAI 调用方式，替换 base URL 与 API Key 即可接入。

发起一次对话

curl https://primalsg.com/v1/chat/completions \
  -H "Authorization: Bearer $PRIMAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vendor/model","messages":[{"role":"user","content":"你好"}],"max_tokens":256}'

流式请求增加 "stream":true，服务会自动向上游请求 usage 用于精确结算。

Embeddings 与多模态接口

支持 POST /v1/embeddings、POST /v1/images/generations、POST /v1/audio/speech 和 POST /v1/rerank。请求体需包含已上架的 model，并确保管理员已将该模型映射到支持此接口的渠道。

curl https://primalsg.com/v1/embeddings \
  -H "Authorization: Bearer $PRIMAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vendor/embedding-model","input":"你好"}'

API Key

登录控制台后在密钥管理中创建、禁用或轮换密钥。不要在前端页面暴露生产密钥。

限流与计费

用户和 API Key 均可设置 RPM 与每日消费上限，密钥还可设总限额、有效期和启停状态。请求先预扣，成功后按 usage 结算，失败自动退回预扣。

常见错误码

400 请求或模型无效；401 API Key 无效/停用/过期；402 余额或限额不足；429 超出 RPM；502/503 上游不可用或无支持该模型的渠道。