API Documentation
Welcome to the Doubao AI API. You can use our API to integrate powerful AI capabilities into your applications.
Base URL:
https://api.doubao-ai.com/v1
Authentication
All API requests require an API key in the HTTP header.
Authorization: Bearer YOUR_API_KEY
Chat Completions
Create a chat completion, supporting multi-turn conversations.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | Model ID, e.g., doubao-pro-v1 |
| messages | array | Yes | List of messages containing conversation history |
| temperature | float | No | Sampling temperature, between 0 and 2, default is 0.7 |
Example Code
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": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"}
]
}'
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": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"}
]
)
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: "You are a helpful assistant." },
{ role: "user", content: "Hello!" },
],
});
console.log(completion.choices[0].message.content);
Image Generation
Generate images based on text prompts.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Yes | Image description text |
| size | string | No | Image size, e.g., 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"
}'