聊天接口 - API2D

请求参数

Header 参数

Content-Type

string

必需

默认值:

application/json

Authorization

string

必需

Bearer 你的forwardKey/customKey/API Token

默认值:

Bearer fk....

Body 参数application/json

model

enum<string>

必需

枚举值:

gemini-2.0-flashgemini-2.0-flash-lite-preview-02-05gemini-2.0-flash-litegemini-2.5-pro-preview-03-25gemini-2.5-pro-exp-03-25

messages

array [object {2}]

必需

<= 1 items

role

string

必需

content

string

必需

safe_mode

boolean

可选

默认为 false，为 true 时会尝试让 GPT 自己审查内容，不输出违规结果。由于 GPT 的调性，效果好坏比较随机。总的来说对暴力、色情内容效果较好，政治类效果一般。开启后会每次访问会增加约 1P 的消耗

默认值:

false

moderation

boolean

可选

默认为 false，为 true 时会调用文本安全接口对内容进行判定，并将审核结果添加到返回值中的 moderation 字段，开发者可以根据值自行判断如何处理。审核输出的详细解释：https://cloud.tencent.com/document/product/1124/51860 开启后每 9000 字符会增加 10P 的消耗

默认值:

false

moderation_stop

boolean

可选

默认为 false，在 moderation 为 true 且自身也为 true 时，如果审核结果不是 Pass，将自动进行内容拦截，对流也生效

默认值:

false

stream

boolean

可选

流方式返回，兼容官方参数，但因为有计费和审核逻辑，比官方流慢。

默认值:

false

max_tokens

integer

可选

如果不指定，每次请求会预先冻结模型支持的最大个数 Token，如果是 3.5 也就是 41P ，在请求完成后按 usage 字段多退少补。如果账户余额少于 41P 就会报错，此时可以指定 max_tokens，这样就会按 max_tokens 来冻结

示例

{
    "model": "gemini-2.0-flash",
    "messages": [
        {
            "role": "string",
            "content": "string"
        }
    ],
    "safe_mode": "false",
    "moderation": "false",
    "moderation_stop": "false",
    "stream": "false",
    "max_tokens": 0
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://oa.api2d.net/v1/chat/completions' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "gemini-2.0-flash",
    "messages": [
        {
            "role": "string",
            "content": "string"
        }
    ],
    "safe_mode": "false",
    "moderation": "false",
    "moderation_stop": "false",
    "stream": "false",
    "max_tokens": 0
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}