快速接入指南

本文面向 API 使用者，介绍如何在你的应用或工作流中接入 OSP API。

---

第一步：获取 API Key

1. 登录你的 OSP API 管理后台
2. 进入「用户」→「API Key」页面
3. 点击「生成新密钥」，复制保存

⚠️ API Key 只显示一次，请妥善保管

---

第二步：发送第一个请求

OSP API 兼容 OpenAI API 格式，以 /v1/chat/completions 为例：

curl -X POST https://api.osp.io/v1/chat/completions \
  -H "Authorization: Bearer 你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [{"role": "user", "content": "你好"}]
  }'

响应示例：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！有什么可以帮你的？"
    },
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 9, "completion_tokens": 20, "total_tokens": 29}
}

---

第三步：切换模型

只需修改请求中的 model 字段：

模型	model 参数	厂商
GPT-4	gpt-4	OpenAI
GPT-4o	gpt-4o	OpenAI
Claude 3.5 Sonnet	claude-3-5-sonnet	Anthropic
Gemini Pro	gemini-pro	Google
讯飞星火	spark-3.5	讯飞

---

常用模型

模型	用途	厂商
gpt-4 / gpt-4o	对话、代码、写作	OpenAI
claude-3-5-sonnet	分析、长文本	Anthropic
gemini-pro	多模态、推理	Google
midjourney	图片生成	Midjourney
suno-ai	音乐生成	Suno
gpt-4o-mini	高速对话	OpenAI
o1-mini	高速推理	OpenAI

---

计费说明

• Token 计费：按输入 + 输出的 token 总数计费
• 通道差价：不同模型厂商价格不同
• 用量查询：管理后台「数据看板」可查看各模型消耗明细

---

遇到问题？

• 查看 API 文档
• 联系你的 OSP API 管理员