ChatCompletions 格式

根据对话历史创建模型响应。支持流式和非流式响应。兼容 OpenAI Chat Completions API。

字段	值
Base URL	`https://token.easyapi.com/v1`
认证	Authorization: Bearer `API_KEY`
示例模型	`gpt-4`
格式	OpenAI Chat Completions 兼容
计费	按量计费

注意：完整路径为 POST /v1/chat/completions。OpenAI SDK 的 base_url 需填写完整路径（含 /v1）。

示例模型

下文均以 gpt-4（GPT-4）为例；更换其他模型时，请替换 model 参数，并参考控制台模型说明调整 size、quality 等字段。

创建聊天补全

POSThttps://token.easyapi.com/v1/chat/completions

根据对话历史创建模型响应，兼容 OpenAI Chat Completions API，支持流式与非流式。

请求参数

名称	位置	类型	必选	说明
`Authorization`	header	string	是	EasyAPI API Key。格式：Bearer `API_KEY`
`Content-Type`	header	string	是	请求体格式，固定 application/json

请求体

名称	类型	必选	说明
`model`	string	是	模型 ID
`messages`	array<object>	是	对话消息列表
`temperature`	number	否	采样温度，默认 1，范围 0–2
`top_p`	number	否	核采样参数，默认 1，范围 0–1
`n`	integer	否	生成数量，默认 1，范围 ≥ 1
`stream`	boolean	否	是否流式响应，默认 false
`stream_options`	object	否	流式响应附加选项
`stop`	string \| array<string>	否	停止序列，字符串或字符串数组
`max_tokens`	integer	否	最大生成 Token 数
`max_completion_tokens`	integer	否	最大补全 Token 数
`presence_penalty`	number	否	存在惩罚，默认 0，范围 -2–2
`frequency_penalty`	number	否	频率惩罚，默认 0，范围 -2–2
`logit_bias`	object	否	调整指定 token 出现概率
`user`	string	否	终端用户标识，便于滥用监测
`tools`	array<object>	否	可调用的工具定义列表
`tool_choice`	string \| object	否	工具选择策略，字符串或对象
`response_format`	object	否	响应格式，如 JSON Schema
`seed`	integer	否	随机种子，用于尽量复现结果
`reasoning_effort`	string	否	medium
`modalities`	array<string>	否	输出模态，如 text、audio
`audio`	object	否	音频输出相关配置

示例

{
  "model": "gpt-4",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "Hello!"
    }
  ],
  "temperature": 0.7,
  "stream": false
}

响应示例

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1718452800,
  "model": "gpt-4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 12,
    "total_tokens": 32,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 20,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 12,
      "audio_tokens": 0,
      "reasoning_tokens": 0
    }
  },
  "system_fingerprint": "fp_abc123"
}