curl --request POST \
  --url https://api.powertokens.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "dola-seed-2-1-turbo-260628",
  "messages": [
    {
      "role": "system",
      "content": "你是一个简洁、准确的中文助手。"
    },
    {
      "role": "user",
      "content": "请用三句话总结一下 RAG 的核心流程。"
    }
  ],
  "temperature": 0.3,
  "max_completion_tokens": 1024,
  "stream": false
}
'

{
  "id": "chatcmpl_bp_123",
  "object": "chat.completion",
  "created": 1742342400,
  "model": "dola-seed-2-1-turbo-260628",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "RAG 的核心流程通常分为检索、增强和生成三步。系统先把用户问题转换为向量并检索相关知识片段，再把检索结果与原问题一起拼接进提示词。最后模型基于增强后的上下文生成答案，从而降低幻觉并提升事实性。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 98,
    "total_tokens": 221
  }
}

{
  "error": {
    "message": "messages is required",
    "type": "invalid_request_error",
    "param": "messages",
    "code": "bad_request_body"
  }
}

{
  "error": {
    "message": "无效的令牌",
    "type": "api_error",
    "code": "access_denied",
    "param": ""
  }
}

{
  "error": {
    "message": "当前账户额度不足，请稍后重试",
    "type": "api_error",
    "code": "insufficient_user_quota",
    "param": ""
  }
}

{
  "error": {
    "message": "服务内部处理失败，请稍后重试",
    "type": "api_error",
    "code": "gen_relay_info_failed",
    "param": ""
  }
}

字节

dola-seed-2-1-turbo-260628 对话补全

调用 BytePlus chat completions 能力。

支持模型包括 dola-seed-2-1-turbo-260628。

本文档公开字段：model、messages、stream、stream_options.include_usage、stream_options.chunk_include_usage、max_completion_tokens、response_format、frequency_penalty、presence_penalty、temperature、top_p、tools、parallel_tool_calls、tool_choice。messages[].content 支持纯文本；assistant 消息支持 tool_calls。

POST

chat

completions

curl --request POST \
  --url https://api.powertokens.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "dola-seed-2-1-turbo-260628",
  "messages": [
    {
      "role": "system",
      "content": "你是一个简洁、准确的中文助手。"
    },
    {
      "role": "user",
      "content": "请用三句话总结一下 RAG 的核心流程。"
    }
  ],
  "temperature": 0.3,
  "max_completion_tokens": 1024,
  "stream": false
}
'

{
  "id": "chatcmpl_bp_123",
  "object": "chat.completion",
  "created": 1742342400,
  "model": "dola-seed-2-1-turbo-260628",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "RAG 的核心流程通常分为检索、增强和生成三步。系统先把用户问题转换为向量并检索相关知识片段，再把检索结果与原问题一起拼接进提示词。最后模型基于增强后的上下文生成答案，从而降低幻觉并提升事实性。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 98,
    "total_tokens": 221
  }
}

{
  "error": {
    "message": "messages is required",
    "type": "invalid_request_error",
    "param": "messages",
    "code": "bad_request_body"
  }
}

{
  "error": {
    "message": "无效的令牌",
    "type": "api_error",
    "code": "access_denied",
    "param": ""
  }
}

{
  "error": {
    "message": "当前账户额度不足，请稍后重试",
    "type": "api_error",
    "code": "insufficient_user_quota",
    "param": ""
  }
}

{
  "error": {
    "message": "服务内部处理失败，请稍后重试",
    "type": "api_error",
    "code": "gen_relay_info_failed",
    "param": ""
  }
}

授权

Authorization

string

header

必填

在请求头中传入 Authorization: Bearer <token>。

请求体

application/json

BytePlus chat completions 请求体。

model

enum<string>

必填

模型名称。支持的 BytePlus 对话模型包括 dola-seed-2-1-turbo-260628

可用选项:

dola-seed-2-1-turbo-260628

示例:

"dola-seed-2-1-turbo-260628"

messages

object[]

必填

消息列表。当前文档公开 system、user、assistant、tool 四种角色。messages[].content 支持纯文本。

Minimum array length: 1

Show child attributes

stream

boolean

默认值:true

是否启用流式输出。为 true 时响应内容类型为 text/event-stream。

stream_options

object

流式响应附加选项。仅在 stream=true 时生效。

Show child attributes

max_completion_tokens

integer

模型回答最大长度，单位 token。

response_format

object

控制回答格式（Beta）。

Show child attributes

frequency_penalty

number

默认值:0

频率惩罚。值越高，越抑制重复表达。

必填范围: -2 <= x <= 2

presence_penalty

number

默认值:0

存在惩罚。值越高，越鼓励模型引入新话题。

必填范围: -2 <= x <= 2

temperature

number

默认值:1

采样温度。越低越稳定，越高越发散。

必填范围: 0 <= x <= 2

top_p

number

默认值:0.95

核采样参数。通常与 temperature 二选一调优。

必填范围: 0 <= x <= 1

tools

object[]

可供模型调用的函数工具定义列表。

Show child attributes

parallel_tool_calls

boolean

是否允许模型并行发起多个工具调用。

tool_choice

工具调用策略。可以是字符串模式，也可以是指定具体函数的对象。

可用选项:

none,

auto,

required

响应

调用成功。非流式模式返回 JSON；流式模式返回 SSE 事件流。

BytePlus chat completions 成功响应。

string

响应 ID。

object

string

对象类型，例如 chat.completion。

created

integer

Unix 时间戳。

model

string

实际使用的模型名称。

choices

object[]

Show child attributes

usage

object

Token 用量统计。

Show child attributes

聊天模型

图像模型

视频模型

音频模型

资产库

dola-seed-2-1-turbo-260628 对话补全

授权

请求体

响应