API 文档

欢迎使用豆包AI API。您可以使用我们的API将强大的AI能力集成到您的应用程序中。

基本URL: https://api.doubao-ai.com/v1

认证

所有API请求都需要在HTTP头中包含API密钥。

Authorization: Bearer YOUR_API_KEY

对话生成 (Chat Completions)

创建一个对话补全,支持多轮对话。

请求参数

参数名 类型 必选 描述
model string 模型ID,例如 doubao-pro-v1
messages array 包含对话历史的消息列表
temperature float 采样温度,0-2之间,默认0.7

示例代码

curl https://api.doubao-ai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DB_API_KEY" \
  -d '{
    "model": "doubao-pro-v1",
    "messages": [
      {"role": "system", "content": "你是一个有用的助手。"},
      {"role": "user", "content": "你好!"}
    ]
  }'
import os
from doubao import DoubaoClient

client = DoubaoClient(api_key=os.environ.get("DB_API_KEY"))

completion = client.chat.completions.create(
  model="doubao-pro-v1",
  messages=[
    {"role": "system", "content": "你是一个有用的助手。"},
    {"role": "user", "content": "你好!"}
  ]
)

print(completion.choices[0].message.content)
import Doubao from "doubao-ai";

const doubao = new Doubao({ apiKey: process.env.DB_API_KEY });

const completion = await doubao.chat.completions.create({
  model: "doubao-pro-v1",
  messages: [
    { role: "system", content: "你是一个有用的助手。" },
    { role: "user", content: "你好!" },
  ],
});

console.log(completion.choices[0].message.content);

文生图 (Image Generation)

根据文本提示生成图像。

请求参数

参数名 类型 必选 描述
prompt string 图像描述文本
size string 图像尺寸,如 1024x1024
curl https://api.doubao-ai.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DB_API_KEY" \
  -d '{
    "prompt": "A futuristic city skyline at sunset",
    "size": "1024x1024"
  }'