Gemini 对话（OpenAI 兼容） - 数字先锋API文档

# Gemini 对话（OpenAI 兼容） API 文档

## 1. 接口说明

本平台Gemini 统一提供 OpenAI 兼容 Chat 接口，所有对话模型均通过以下地址调用：

```http
POST /v1/chat/completions
```

### Base URL
```text
https://api.cxsee.com
```

完整地址：
```text
https://api.cxsee.com/v1/chat/completions
```

---

## 2. 认证方式

请求头必须携带 API Key：

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

---

## 3. 支持模型

当前已验证示例模型：

- `gemini-3-flash-preview`
- （可扩展）其他 chat 模型以平台实际上线列表为准

---

## 4. 请求参数

### 请求体（标准）
```json
{
  "model": "gemini-3-flash-preview",
  "messages": [
    { "role": "user", "content": "你好，介绍下自己" }
  ]
}
```

### 字段说明

- `model` *(必填)*：模型名称
- `messages` *(必填)*：对话消息数组
  - `role`: `system | user | assistant`
  - `content`: 消息文本
- `temperature` *(选填)*：采样温度
- `max_tokens` *(选填)*：最大输出 token
- `stream` *(选填)*：是否流式返回（`true/false`）

---

## 5. 调用示例

### 5.1 基础对话（非流式）
```bash
curl -X POST "https://api.cxsee.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-flash-preview",
    "messages": [
      {"role": "user", "content": "你好，介绍下自己"}
    ]
  }'
```

### 5.2 带 system 角色
```bash
curl -X POST "https://api.cxsee.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-flash-preview",
    "messages": [
      {"role": "system", "content": "你是一个简洁的中文助手"},
      {"role": "user", "content": "用三句话介绍人工智能"}
    ],
    "temperature": 0.7
  }'
```

---

## 6. 成功响应示例（与你测试一致）

```json
{
  "id": "chatcmpl-xxxx",
  "object": "chat.completion",
  "created": 1774036451,
  "model": "gemini-3-flash-preview",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 6,
    "completion_tokens": 692,
    "total_tokens": 698
  }
}
```

---

## 7. 错误码

- `400`：参数错误
- `401`：认证失败（API Key 无效）
- `403`：无模型权限
- `404`：接口不存在
- `429`：限流
- `500/502/503`：服务异常

---

## 8. 对接建议

1. 生产环境务必设置请求超时与重试。
2. 建议记录 `id`（如 `chatcmpl-xxx`）用于问题排查。
3. 严禁在前端暴露真实 API Key。
4. 建议按模型配置请求频率限制和 token 配额。

---

上一篇：个人设置下一篇：千问（Qwen）绘画