Skip to content

Doubao Seed โ€‹

Updated

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 โ€‹

ItemValue
Call endpointhttps://mmu.vod-qcloud.com
AuthenticationVOD Application-issued ApiToken / Bearer
OutputText / Structured response
Response modeJSON / SSE

Supported Protocols โ€‹

SpecPathTarget
Chat CompletionsPOST /v1/chat/completionsAll models below
ResponsesPOST /v1/responsesAll models below
MessagesPOST /v1/messagesAll 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.

ParameterSetting
temperatureConfigurable
top_pConfigurable

temperature specifies the sampling temperature, and top_p specifies the cumulative probability range. Adjust centered on one method.

Per-Version Reasoning Settings โ€‹

Model IDConfigurationDisable
st-evolvingthinking_enabledfalse
st-characterReasoning text not returnedโ€”
st-2.1-turbothinking_enabledfalse
st-2.1-prothinking_enabledfalse
st-2.0-minithinking_enabledfalse

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 โ€‹

ParameterRequiredTypeDescription
modelRequiredStringA model ID from the per-version options table
messagesRequiredArrayConversation input for Chat Completions / Messages
inputRequiredString / ArrayInput for Responses. Used instead of messages
max_tokensOptionalIntegerGeneration limit for Chat Completions / Messages. Required in Messages
max_output_tokensOptionalIntegerGeneration limit for Responses
streamOptionalBooleantrue: SSE / false: JSON

Request Examples โ€‹

Chat Completions โ€‹

json
{
  "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 โ€‹

json
{
  "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 โ€‹

json
{
  "model": "st-evolving",
  "input": "Reply with exactly OK and nothing else.",
  "max_output_tokens": 512,
  "stream": false
}

Response โ€‹

json
{
  "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 โ€‹

json
{
  "model": "st-evolving",
  "messages": [
    {
      "role": "user",
      "content": "Reply with exactly OK and nothing else."
    }
  ],
  "max_tokens": 512,
  "stream": false
}

Response โ€‹

json
{
  "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.

Built with VitePress ยท Deployed on Tencent EdgeOne Pages