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"
}'