模型对话调用（Completions）

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Authorization

string

必需

示例值:

Bearer {{token}}

Body 参数application/json

model

string

模型

可选

可取值：spark-general-1.5: 基础模型v1.5版本; spark-general-2.0: 基础模型v2.0版本; spark-interface-1.0: 交互模型（支持技能），需配合plugins字段使用

uid

string

用户id，一个代表你的最终用户的唯一标识符

可选

字符串最大长度为32

auditing

string

内容审核的场景策略

可选

可取值： default

domain

string

需要使用的领域

可选

可取值： general

temperature

核采样阈值

可选

最小值是0.1，最大值是1

top_k

从k个中随机选择一个（非等概率）

可选

最小值是1，最大值是6

max_tokens

回答的tokens的最大长度

可选

最小值是1，最大值是4096;基础模型v2.0版本的最大值是8192

stream

boolean

是否支持流式

可选

plugins

array[string]

插件

可选

当model为'spark-interface-1.0'时，该字段生效，用于指定可用技能，当前数组可填值：'天气'、'菜谱'

location

object

位置

可选

在使用某些技能时会生效

latitude

number

纬度

可选

GPS坐标纬度

longitude

number

经度

可选

GPS坐标经度

messages

array [object {2}]

会话和提问

必需

需要自行拼接对话历史信息，数组最后是最新的用户提问

role

string

角色

必需

可取值： user，assistant ；其中user表示用户的提问，assistant表示AI的回复 ; 若当前message为messages数组的最后一个元素，role的值需为字符串'user'

content

string

文本内容

必需

该角色的对话内容

示例

{
  "temperature": 0.5,
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "广州有什么东西玩，十个字内回复"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v1/chat/completions' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "temperature": 0.5,
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "广州有什么东西玩，十个字内回复"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

choices

array [object {3}]

必需

finish_reason

null

可选

index

integer

可选

message

object

可选

created

integer

必需

id

string

必需

object

string

必需

usage

object

必需

completion_tokens

integer

必需

prompt_tokens

integer

必需

question_tokens

integer

必需

total_tokens

integer

必需

{
  "choices": [
    {
      "finish_reason": null,
      "index": 0,
      "message": {
        "content": "广州有很多值得玩的地方，比如珠江夜游、白云山、荔枝湾等。此外，广州还有丰富的美食文化和购物场所，例如北京路步行街和天河城购物中心。",
        "role": "assistant"
      }
    }
  ],
  "created": 1683804700,
  "id": "cht000d6b4f@dx1880a94b87ab894540",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 44,
    "prompt_tokens": 8,
    "question_tokens": 7,
    "total_tokens": 52
  }
}