admin 管理员组

文章数量: 887021

接口文档

概述

本接口提供了对接OpenAI ChatGPT的功能,允许开发者通过API与ChatGPT模型进行交互,实现自然语言理解和生成。此接口需要使用POST方法请求,并且需要提供有效的API密钥和输入数据以确保请求的成功。

API基础信息

  • API Endpoint: https://api.openai/v1/engines/davinci-codex/completions
  • 请求方法: POST
  • 认证方式: Bearer Token

请求头

头字段值类型描述
AuthorizationstringBearer后接API密钥
Content-Typestring应设置为application/json

请求参数

请求体需以JSON格式发送,以下参数包含在请求体中:

参数名必选类型说明
promptstring要发送给模型的提示,即用户的输入
max_tokensint生成的最大令牌数,默认为256
temperaturefloat控制输出的确定性,默认为1
top_pfloat控制采样的创造性,默认为1
nint要生成的完成数量,默认为1
stopstring/array生成停止的序列
frequency_penaltyfloat频率惩罚,控制重复,默认为0
presence_penaltyfloat存在惩罚,控制新颖性,默认为0

返回值

返回JSON格式的数据。包含模型生成的文本。

示例

请求示例:

json

POST /v1/engines/davinci-codex/completions HTTP/1.1
Host: api.openai
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "prompt": "Translate the following English text to French: 'Hello, how are you?'",
  "max_tokens": 60,
  "temperature": 0.5
}

返回示例:

json

{
  "id": "cmpl-2c3hrnT08cFPRgVJF3a8h2Fb",
  "object": "text_completion",
  "created": 1589478378,
  "model": "davinci-codex",
  "choices": [
    {
      "text": "Bonjour, comment ça va?",
      "index": 0,
      "logprobs": null,
      "finish_reason": "length"
    }
  ]
}

注意事项

  • 需要注册OpenAI账户并获取API密钥才能使用此接口。
  • 请确保API密钥保密,不要在客户端直接暴露密钥。
  • 根据使用的模型和所生成的令牌数量,使用此接口可能会产生费用。请参考OpenAI的定价策略以获取详细信息。
  • OpenAI提供的API可能会有使用限制,例如请求频率限制,请遵守相关规定。
  • 返回的数据结构可能随OpenAI API的更新而变化,请以实际返回为准。

本文标签: 文档 详细 OpenAI ChatGpt api