豆包 Doubao 大模型 API 接口

豆包大模型是字节跳动推出的自研大模型。经过字节跳动内部 50+ 业务场景实践验证,提供高质量的语言模型与多模态模型矩阵,以优质模型效果与丰富的模型组合为企业打造丰富的业务体验。

接口地址

POST https://wcode.net/api/gpt/v1/chat/completions

此 API 接口兼容 OpenAI 的接口规范,也就是可以直接使用 OpenAI 的 SDK 来调用各个模型。仅需替换以下两项配置:

  1. BASE_URL 替换为 https://wcode.net/api/gpt/v1
  2. API_KEY 替换为从 https://wcode.net/get-apikey 获取到的 API KEY

即可开始使用 OpenAI SDK 调用 通义千问系列豆包系列DeepSeek系列文心一言系列混元系列......等各个模型。

请求方法

POST

快速开始(请求示例)

(注:以下请求示例中的 API_KEY 需要替换后再发起请求。 获取 API_KEY 入口:https://wcode.net/get-apikey

curl --request POST 'https://wcode.net/api/gpt/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
    "model": "doubao-1.5-lite-32k",
    "messages": [
        {
            "role": "user",
            "content": "你好,请介绍一下你自己"
        }
    ]
}'

请求头(Request Headers)

Header 备注 示例 相关链接
Authorization Bearer API_KEY 格式:Bearer + 空格 + API_KEY Bearer sk-..... 获取 API_KEY 入口:https://wcode.net/get-apikey
Content-Type application/json 固定为 application/json

请求参数

🚀 model | ✅️必填 | string | 模型ID,可选 model 模型列表(部分):

模型ID 模型名称 每 1000 tokens 费用 更新日期
doubao-1.5-lite-32k Doubao-1.5-lite-32k 0.0008 2025-01-22 ❇️最近更新
doubao-1.5-pro-256k Doubao-1.5-pro-256k 0.0115 2025-01-22 ❇️最近更新
doubao-1.5-pro-32k Doubao-1.5-pro-32k 0.0025 2025-01-22 ❇️最近更新
doubao-1.5-vision-pro-32k Doubao-1.5-vision-pro-32k 0.0115 2025-01-22 ❇️最近更新
doubao-pro-32k Doubao-pro 0.003 2024-12-15
doubao-pro-256k Doubao-pro-256k 0.0115 2024-11-15
doubao-vision-pro-32k Doubao-vision-pro-32k 0.0115 2024-10-28
doubao-vision-lite-32k Doubao-vision-lite-32k 0.0058 2024-10-15
doubao-lite-128k Doubao-lite-128k 0.0013 2024-08-28
doubao-lite-32k Doubao-lite 0.0009 2024-08-28
doubao-pro-128k Doubao-pro-128k 0.0115 2024-06-28

🚀 messages | ✅️必填 | array | 由历史对话组成的消息列表。array 中的每个元素形式通常为 {"role": 角色, "content": 内容}。角色当前可选值为:systemuserassistant

messages[0]中支持 rolesystem

一般情况下,userassistant 需要交替出现,且 messages 中最后一个元素的 roleuser


🚀 stream | 选填 | boolean | 默认值 false | 是否流式输出。

false(默认值):模型生成完所有内容后一次性返回结果。

true:返回符合 SSE 协议的响应,边生成边输出,即每生成一部分内容就立即输出一个片段(chunk),最后以一条 data: [DONE] 消息结束。


🚀 max_tokens | 选填 | int | 允许模型生成的最大 tokens 数。

应用场景:max_tokens 参数适用于需要限制字数(如生成摘要、关键词)、控制成本或减少响应时间的场景。


🚀 temperature | 选填 | float | 默认值 1 | 采样温度,用于控制模型生成文本的多样性。取值范围: [0, 1]。当取值为 0 时模型仅考虑对数概率最大的一个 token。temperature 越高,生成的文本更多样,反之,生成的文本更确定。


🚀 top_p | 选填 | float | 默认值 0.7 | 核采样概率阈值,用于控制模型生成文本的多样性。取值范围:[0, 1]。当取值为 0 时模型仅考虑对数概率最大的一个 token。top_p 越高,生成的文本更多样。反之,生成的文本更确定。

由于 temperature 与 top_p 均可以控制生成文本的多样性,因此建议您只设置其中一个值。


🚀 frequency_penalty | 选填 | float | 默认值 0 | 频率惩罚系数。如果值为正,会根据新 token 在文本中的出现频率对其进行惩罚,从而降低模型逐字重复的可能性。取值范围为 [-2.0, 2.0]

适用场景:

较高的 frequency_penalty 适用于要求多样性、趣味性或创造性的场景,如创意写作或头脑风暴。

较低的 frequency_penalty 适用于要求一致性或专业术语的场景,如技术文档或其他正式文档。


🚀 presence_penalty | 选填 | float | 默认值 0 | 存在惩罚系数。如果值为正,会根据新 token 到目前为止是否出现在文本中对其进行惩罚,从而增加模型谈论新主题的可能性。取值范围为 [-2.0, 2.0]


🚀 stop | 选填 | string 或 array | 模型遇到 stop 字段所指定的字符串时将停止继续生成,这个词语本身不会输出。最多支持 4 个字符串。

参数示例:["季节", "天气"]


🚀 logprobs | 选填 | boolean | 默认值 false | 是否返回输出 tokens 的对数概率。


🚀 top_logprobs | 选填 | int | 默认值 0 | 指定每个输出 token 位置最有可能返回的 token 数量,每个 token 都有关联的对数概率。仅当 logprobs: true 时可以设置 top_logprobs 参数,取值范围为 [0, 20]


🚀 logit_bias | 选填 | object | 调整指定 token 在模型输出内容中出现的概率,使模型生成的内容更加符合特定的偏好。

返回参数

不同模型返回参数可能存在差异,请以实际返回为准。

返回参数 数据类型 说明
id string 系统生成的标识本次调用的id。
model string 本次调用的模型名。
choices array 模型生成内容的详情。
choices[i].finish_reason string 结束标志。
choices[i].message object 模型生成的消息。
choices[i].message.role string 生成消息的角色。
choices[i].message.content string 生成消息的内容。
choices[i].index int 生成的结果序列编号。
created int 请求被创建时的时间戳。
usage object 请求所消耗的 tokens 数据。
usage.prompt_tokens int 用户输入转换成 token 后的数量。
usage.completion_tokens int 模型生成回复转换为 token 后的数量。
usage.total_tokens int prompt_tokens 与 completion_tokens 的总和。

响应头(Response Headers)

Header 说明 示例 相关链接
X-Account-Balance API_KEY 余额(元) 123.0165 API_KEY 费用充值入口:https://wcode.net/apikey-recharge

Python 代码示例(Requests,doubao-1.5-lite-32k)

import requests
import json

url = "https://wcode.net/api/gpt/v1/chat/completions"

payload = json.dumps({
  "model": "doubao-1.5-lite-32k",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "你好"
    }
  ]
})

headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer API_KEY'     # TODO: 这里的 API_KEY 需要替换,获取 API_KEY 入口:https://wcode.net/get-apikey
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Java 代码示例(OkHttp,doubao-1.5-lite-32k)

OkHttpClient client = new OkHttpClient().newBuilder().build();

MediaType mediaType = MediaType.parse("application/json");

RequestBody body = RequestBody.create(mediaType, "{\"model\":\"doubao-1.5-lite-32k\",\"messages\":[{\"role\":\"system\",\"content\":\"You are a helpful assistant.\"},{\"role\":\"user\",\"content\":\"你好\"}]}");

Request request = new Request.Builder()
  .url("https://wcode.net/api/gpt/v1/chat/completions")
  .method("POST", body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Bearer API_KEY")     // TODO: 这里的 API_KEY 需要替换,获取 API_KEY 入口:https://wcode.net/get-apikey
  .build();

Response response = client.newCall(request).execute();

PHP 代码示例(Guzzle,doubao-1.5-lite-32k)

<?php

$client = new Client();

$headers = [
  'Content-Type' => 'application/json',
  'Authorization' => 'Bearer API_KEY'     // TODO: 这里的 API_KEY 需要替换,获取 API_KEY 入口:https://wcode.net/get-apikey
];

$body = '{
  "model": "doubao-1.5-lite-32k",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "你好"
    }
  ]
}';

$request = new Request('POST', 'https://wcode.net/api/gpt/v1/chat/completions', $headers, $body);

$res = $client->sendAsync($request)->wait();

echo $res->getBody();

...其他编程语言可参考下方 curl http 请求示例进行调用

请求示例 1(doubao-1.5-lite-32k)

curl --request POST 'https://wcode.net/api/gpt/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
    "model": "doubao-1.5-lite-32k",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "你好"
        }
    ]
}'

响应示例 1(doubao-1.5-lite-32k)

{
    "id": "021734706666426999645dcddb1336731c3539e403e8f78ab8ab1",
    "object": "chat.completion",
    "created": 1734706667,
    "model": "doubao-1-5-lite-32k-250115",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "你好呀!有什么事或者想聊点什么都可以跟我说哦~ "
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 20,
        "completion_tokens": 19,
        "total_tokens": 39,
        "prompt_tokens_details": {
            "cached_tokens": 0
        }
    }
}

请求示例 1.1(多轮对话,doubao-1.5-lite-32k)

curl --request POST 'https://wcode.net/api/gpt/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
    "model": "doubao-1.5-lite-32k",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "你好"
        },
        {
            "role": "assistant",
            "content": "你好!有什么可以帮助你的吗?"
        },
        {
            "role": "user",
            "content": "什么是AGI?"
        }
    ]
}'

响应示例 1.1(多轮对话,doubao-1.5-lite-32k)

{
    "id": "0217375623918610483de816384f34bb323cca2af05ed5d29a77d",
    "object": "chat.completion",
    "created": 1737562392,
    "model": "doubao-1-5-lite-32k-250115",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "AGI即通用人工智能(Artificial General Intelligence)。\n\n通用人工智能旨在创造具备一般智能能力的机器,使其能够像人类一样灵活地理解、学习、推理和解决各种类型的问题,而不仅仅局限于特定领域或任务。与狭义的人工智能(如针对特定图像识别、语言翻译等单一功能的系统)不同,AGI追求的是具有广泛适用性和接近人类智能水平的智能体。\n\n目前,实现真正的AGI仍是人工智能领域极具挑战性的目标,众多科研团队和企业都在积极探索相关技术和方法。 "
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 44,
        "completion_tokens": 121,
        "total_tokens": 165,
        "prompt_tokens_details": {
            "cached_tokens": 0
        }
    }
}

请求示例 2(doubao-1.5-lite-32k,流式输出)

curl --request POST 'https://wcode.net/api/gpt/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
    "model": "doubao-1.5-lite-32k",
    "stream": true,
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "你好"
        }
    ]
}'

响应示例 2(doubao-1.5-lite-32k,流式输出)

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"你"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"好"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"!"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"有"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"什么"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"我"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"可以"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"帮助"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"你的"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"吗"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"?"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"无论是"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"关于"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"知识"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"问答"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"、"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"聊天"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"交流"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":","},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"还是"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"其他"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"方面"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"的"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"问题"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":","},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"都"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"可以"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"随时"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"问"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"我"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"哦"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":"。"},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":" "},"finish_reason":null}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":"stop"}]}

data: {"id":"02173756245220236d9fb6272718bcfbc0a7d4c06d13c5b72d305","object":"chat.completion.chunk","created":1737562452,"model":"doubao-1-5-lite-32k-250115","choices":[],"usage":{"prompt_tokens":20,"completion_tokens":33,"total_tokens":53,"prompt_tokens_details":{"cached_tokens":0}}}

data: [DONE]

请求示例 3(图片理解,doubao-1.5-vision-pro-32k)

curl --request POST 'https://wcode.net/api/gpt/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
    "model": "doubao-1.5-vision-pro-32k",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "这张图片展示的画面是什么?"
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://zdkjdemo.oss-cn-shanghai.aliyuncs.com/dog_playing_with_sticks.jpg"
                    }
                }
            ]
        }
    ]
}'

响应示例 3

{
    "id": "021737561590679320f9aadc50dbf6687c3b1e9f9e54ac6e6bf9f",
    "object": "chat.completion",
    "created": 1737561593,
    "model": "doubao-1-5-vision-pro-32k-250115",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "这张图片展示了一只棕白相间的狗,它正趴在一片葱郁的绿色草地上,专注地啃咬着一根长长的树枝。背景模糊,隐约可见一些树木,营造出一种宁静的户外自然氛围。狗的姿态显得悠闲自在,享受着与自然亲近的时光。整个画面给人一种轻松愉快的感觉,突显了宠物在自然环境中的快乐与自由。"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 874,
        "completion_tokens": 84,
        "total_tokens": 958,
        "prompt_tokens_details": {
            "cached_tokens": 0
        }
    }
}

异常响应示例

{
    "error": {
        "message": "Invalid API-KEY",
        "type": "invalid_request_error",
        "param": null,
        "code": null
    }
}