豆包 Doubao 系列大模型 API 接口

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

此文档为标准版 API 接口文档，可直接用于项目开发和系统调用。如果标准版 API 接口无法满足您的需求，需要定制开发 API 接口，请联系我们的 IT 技术支持工程师：

详细信息

定制开发服务流程：沟通需求✅ → 确认技术方案✅ → 沟通费用与工期✅ → 开发&测试✅ → 验收交付✅ → 维护升级✅

🎯接口地址

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）

🎯请求参数

🚀 model | ✅️必填 | string | 模型ID，可选 model 模型列表（部分）：

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

仅messages[0]中支持 role 为 system。

一般情况下，user 和 assistant 需要交替出现，且 messages 中最后一个元素的 role 为 user。

🚀 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 在模型输出内容中出现的概率，使模型生成的内容更加符合特定的偏好。

🎯返回参数

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

🎯响应头（Response Headers）

🎯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
    }
}

以上文档为标准版 API 接口文档，可直接用于项目开发和系统调用。如果标准版 API 接口无法满足您的需求，需要定制开发 API 接口，请扫码联系我们的 IT 技术支持工程师：

（沟通需求✅ → 确认技术方案✅ → 沟通费用与工期✅ → 开发&测试✅ → 验收交付✅ → 维护升级✅）