> ## Documentation Index
> Fetch the complete documentation index at: https://docs-vip.apigo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI 基础对话示例

> 兼容型 OpenAI 基础聊天接入示例。

## 推荐 endpoint

* [OpenAI /v1/chat/completions](/api-reference/endpoints/openai/chat-completions)

## 最小请求

```json theme={null}
{
  "model": "gpt-4.1",
  "messages": [
    { "role": "system", "content": "You are a concise assistant." },
    { "role": "user", "content": "用三句话介绍 ApiGo。" }
  ],
  "temperature": 0.7
}
```

## cURL 示例

```bash theme={null}
curl https://api-vip.apigo.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUR API KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1",
    "messages": [
      { "role": "system", "content": "You are a concise assistant." },
      { "role": "user", "content": "用三句话介绍 ApiGo。" }
    ],
    "temperature": 0.7
  }'
```

## Python 示例

```python theme={null}
from openai import OpenAI

client = OpenAI(
    base_url="https://api-vip.apigo.ai/v1",
    api_key="<YOUR API KEY>",
)

response = client.chat.completions.create(
    model="gpt-4.1",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "用三句话介绍 ApiGo。"},
    ],
    temperature=0.7,
)

print(response.choices[0].message.content)
```

## Node.js 示例

```js theme={null}
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api-vip.apigo.ai/v1",
  apiKey: process.env.YOUR API KEY,
});

const response = await client.chat.completions.create({
  model: "gpt-4.1",
  messages: [
    { role: "system", content: "You are a concise assistant." },
    { role: "user", content: "用三句话介绍 ApiGo。" }
  ],
  temperature: 0.7,
});

console.log(response.choices[0].message.content);
```

## 最佳实践

* 兼容旧 SDK 或前端聊天组件时，优先从 `chat.completions` 起步
* `system` 指令尽量固定在服务端，不要让前端随意覆盖
* 先把多轮上下文、重试和超时放到网关统一处理，再考虑切到 `responses`