Reference · API
OpenAI Chat Completions API
Send multi-turn messages; get assistant replies. Use **server-side** only.
Send multi-turn messages; get assistant replies. Use **server-side** only.
Endpoint
POST https://api.openai.com/v1/chat/completionsCore request fields
| Field | Purpose |
|-------|---------|
| `model` | e.g. `gpt-4o-mini`, `gpt-4o` |
| `messages` | `{role, content}` array — system, user, assistant |
| `temperature` | 0–2 creativity |
| `max_tokens` | Cap output length |
| `stream` | `true` for token streaming |
Minimal Python
from openai import OpenAI
client = OpenAI()
resp = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "system", "content": "You are concise."},
{"role": "user", "content": "Explain RAG in one sentence."},
],
)
print(resp.choices[0].message.content)Messages shape
[
{"role": "system", "content": "Rules and persona"},
{"role": "user", "content": "Question"},
{"role": "assistant", "content": "Prior reply"},
{"role": "user", "content": "Follow-up"}
]Related
- How-to: streaming
- Lesson: LLM API hello
- Glossary: OpenAI API