Doubao Seed โ
Endpoint: https://mmu.vod-qcloud.com/v1Authentication: VOD ApiToken / Bearer
Doubao Seed is a text generation / chat model; some versions (such as st-2.0-mini and st-2.1-pro) also accept image input. It is called through an OpenAI-compatible API, supporting the Chat Completions, Responses, and Messages protocols with JSON / SSE streaming responses, plus a role-play version, st-character.
Basic Information โ
| Item | Value |
|---|---|
| Call endpoint | https://mmu.vod-qcloud.com |
| Authentication | VOD Application-issued ApiToken / Bearer |
| Output | Text / Structured response |
| Response mode | JSON / SSE |
Supported Protocols โ
| Spec | Path | Target |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | All models below |
| Responses | POST /v1/responses | All models below |
| Messages | POST /v1/messages | All models below |
The model IDs below use the corresponding spec. Authentication and common fields follow API Reference.
Sampling Options โ
Commonly applies to all models listed in this document.
| Parameter | Setting |
|---|---|
temperature | Configurable |
top_p | Configurable |
temperature specifies the sampling temperature, and top_p specifies the cumulative probability range. Adjust centered on one method.
Per-Version Reasoning Settings โ
| Model ID | Configuration | Disable |
|---|---|---|
st-evolving | thinking_enabled | false |
st-character | Reasoning text not returned | โ |
st-2.1-turbo | thinking_enabled | false |
st-2.1-pro | thinking_enabled | false |
st-2.0-mini | thinking_enabled | false |
Based on Chat Completions. Reasoning content is read from reasoning_content, and the final answer from content. Do not pass a disable option to versions that cannot be disabled.
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
model | Required | String | A model ID from the per-version options table |
messages | Required | Array | Conversation input for Chat Completions / Messages |
input | Required | String / Array | Input for Responses. Used instead of messages |
max_tokens | Optional | Integer | Generation limit for Chat Completions / Messages. Required in Messages |
max_output_tokens | Optional | Integer | Generation limit for Responses |
stream | Optional | Boolean | true: SSE / false: JSON |
Request Examples โ
Chat Completions โ
{
"model": "st-2.1-pro",
"messages": [
{
"role": "user",
"content": "Reply with exactly OK and nothing else."
}
],
"max_tokens": 2048,
"stream": false,
"reasoning_effort": "low"
}Response โ
{
"id": "01a0de40-f4c7-718f-b783-0ff8d844ecd3",
"object": "chat.completion",
"model": "doubao-seed-2-1-pro-260628",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "OK",
"reasoning_content": "\nGot it,Content will be written as required.\n"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 56,
"prompt_tokens_details": {
"audio_tokens": 0,
"cached_tokens": 0
},
"prompt_cached_tokens_details": {
"audio_tokens": 0
},
"completion_tokens": 25,
"completion_tokens_details": {
"accepted_prediction_tokens": 0,
"audio_tokens": 0,
"reasoning_tokens": 24,
"rejected_prediction_tokens": 0
},
"total_tokens": 81
}
}Responses โ
{
"model": "st-evolving",
"input": "Reply with exactly OK and nothing else.",
"max_output_tokens": 512,
"stream": false
}Response โ
{
"id": "resp_021790434702899d58e3edad71566bed3cb03770f22004fdcafa8",
"object": "response",
"model": "doubao-seed-evolving",
"status": "completed",
"output": [
{
"id": "rs_02179043470320000000000000000000000ffffac15109049bfd5",
"type": "reasoning",
"summary": [
{
"type": "summary_text",
"text": "We need obey user says exactly OK and nothing else. \n\nConflicting requirements between the developer and user have been found, and the exact user-specified \"OK\" will be output without markdown."
}
],
"status": "completed",
"encrypted_content": "djFq21LcuC8TJbMv6ktgbFidTtXlsGSviuQwPZD2htygvafMpYDXfKJMtIqPif6FPKUcXFBVTI9arUt64rhOPJ8Jx6fzdwwpxqsMov5In3488e2cpkkbm4NpPU8DvZg/JjGDw0BFionPsDAc2ylVhLhv6OH6fQrhMRPL3z7PN+Ew8wfzLDKX5qSOGHDsGE5Dw2SsH2PAi6pf8hIHHPQKzWxvUkeqSpoKQOpWeb9XJMj4oE3wFQzLmbym1k+guJtAIZDDFNuT0pGobmBDnX/u6rw2uVXoq4V/fOQnmHM3weSnY9mjt8pacfRMAqEvQzNULxvdXnfODxDY9Z4xOgpz5E8t9qeZ0G4uVeR3BVp9xvMK8mZvTx07Zu/p+AGVBU1DUdVXboiMXWMWHsrb6M8+EpU5kYqEyTpAg94bpOAgR6zK40s="
},
{
"type": "message",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "OK"
}
],
"status": "completed",
"id": "msg_02179043470547100000000000000000000ffffac151090e43667"
}
],
"usage": {
"input_tokens": 54,
"output_tokens": 63,
"total_tokens": 117,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens_details": {
"reasoning_tokens": 62
}
}
}Messages โ
{
"model": "st-evolving",
"messages": [
{
"role": "user",
"content": "Reply with exactly OK and nothing else."
}
],
"max_tokens": 512,
"stream": false
}Response โ
{
"id": "01a0de35-0701-76af-97a6-0d541d743ca5",
"model": "doubao-seed-evolving",
"type": "message",
"role": "assistant",
"content": [
{
"text": "OK",
"type": "text"
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 54,
"output_tokens": 271
}
}Special Settings โ
st-2.0-mini, st-2.1-pro, st-2.1-turbo, st-character, and st-evolving are identifiers used in model of the request. Image input is passed to the messages of st-2.0-mini and st-2.1-pro as a image_url Part.
Reasoning is enabled with thinking_enabled, and its intensity is specified with reasoning_effort. The settings allowed per model follow the table below. Reasoning content and the final answer are distinguished by reasoning_content and content.