Making requests

You can paste the command below into your terminal to run your first API request. Make sure to replace $OPENAI_API_KEY with your secret API key.

1 curl https://api.openai.com/v1/chat/completions \
2   -H 'Content-Type: application/json' \
3   -H 'Authorization: Bearer YOUR_API_KEY' \
4   -d '{
5   "model": "gpt-3.5-turbo",
6   "messages": [{"role": "user", "content": "Say this is a test!"}],
7   "temperature": 0.7
8 }'

This request queries the gpt-3.5-turbo model to complete the text starting with a prompt of "Say this is a test". You should get a response back that resembles the following:

1 {
2    "id":"chatcmpl-abc123",
3    "object":"chat.completion",
4    "created":1677858242,
5    "model":"gpt-3.5-turbo-0301",
6    "usage":{
7       "prompt_tokens":13,
8       "completion_tokens":7,
9       "total_tokens":20
10    },
11    "choices":[
12       {
13          "message":{
14             "role":"assistant",
15             "content":"\n\nThis is a test!"
16          },
17          "finish_reason":"stop",
18          "index":0
19       }
20    ]
21 }

Now you've generated your first chat completion. We can see the finish_reason is stop which means the API returned the full completion generated by the model. In the above request, we only generated a single message but you can set the n parameter to generate multiple messages choices.