提出请求

您可以将以下命令粘贴到您的终端中,以运行您的第一个 API 请求。请务必将$OPENAI_API_KEY替换为您的秘密 API 密钥。如果您使用的是旧版用户密钥并且有多个项目,则还需要指定 Project ID。为了提高安全性,我们建议改用基于项目的密钥。source

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

此请求查询gpt-4o-minimodel(在后台指向gpt-4o-mini模型变量) 以完成以提示“Say this is a test”开头的文本。您应该会收到类似于以下内容的响应:source

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
    "id": "chatcmpl-abc123",
    "object": "chat.completion",
    "created": 1677858242,
    "model": "gpt-4o-mini",
    "usage": {
        "prompt_tokens": 13,
        "completion_tokens": 7,
        "total_tokens": 20,
        "completion_tokens_details": {
            "reasoning_tokens": 0,
            "accepted_prediction_tokens": 0,
            "rejected_prediction_tokens": 0
        }
    },
    "choices": [
        {
            "message": {
                "role": "assistant",
                "content": "\n\nThis is a test!"
            },
            "logprobs": null,
            "finish_reason": "stop",
            "index": 0
        }
    ]
}

现在,您已经生成了第一个聊天完成,让我们分解响应对象。我们可以看到finish_reasonstop这意味着 API 返回了模型生成的完整聊天完成,而不会遇到任何限制。在选择列表中,我们只生成了一条消息,但你可以设置n参数生成多个消息选项。source