StarMagicStarMagic
English
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
Integration Guide
Doubao Seed 2.0 - 快速开始Doubao Seed 2.0 - 完整参数文档Doubao Seed 2.0 Responses API - 快速开始Doubao Seed 2.0 Responses API - 完整参数文档
StarMagicStarMagic
English
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
TextDoubaoDoubao.Seed.2.0

Doubao Seed 2.0 - Quick Start

  • Call Doubao Seed 2.0 series models using OpenAI SDK format
  • Synchronous processing mode, returns chat content in real time
  • Minimized parameters for quick start
  • Supported models: doubao-seed-2.0-pro, doubao-seed-2.0-lite, doubao-seed-2.0-mini, doubao-seed-2.0-code
  • 💡 Need more features? See Full Parameter Documentation
<Note> **BaseURL**: The default BaseURL is `https://api.starmagic.ai`, which has better support for text models and long-lived connections. `https://api.starmagic.ai` is the primary endpoint for multimodal services and serves as a fallback address for text models. </Note>

Authorization

AuthorizationstringheaderRequired

##All APIs require Bearer Token authentication## **Get API Key:** Visit the [API Key Management Page](https://starmagic.ai/app/api-keys) to get your API Key **Add to request header:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

Request body

application/json
modelenum<doubao-seed-2.0-pro | doubao-seed-2.0-lite | doubao-seed-2.0-mini | doubao-seed-2.0-code>Required

Chat model name - `doubao-seed-2.0-pro`: Flagship, strongest overall capability, ideal for complex reasoning and high-quality generation - `doubao-seed-2.0-lite`: Lightweight, faster speed, cost-effective - `doubao-seed-2.0-mini`: Ultra-fast, quickest response, suitable for simple tasks - `doubao-seed-2.0-code`: Code-specialized, optimized for code generation and understanding

"doubao-seed-2.0-pro"
messagesobject[]Required

Chat message list

[
  {
    "role": "user",
    "content": "Hello, introduce the new features of Doubao Seed 2.0"
  }
]

Response

application/json
成功

Response body

idstring

Unique identifier of chat completion

"0217714854126607f5a9cf8ed5b018c76e4ad3dc2810db57ffb50"
modelstring

Actual model name used

"doubao-seed-2-0-pro-260215"
objectenum<chat.completion>

Response type

"chat.completion"
createdinteger

Creation timestamp

1771485416
service_tierenum<default | scale>

Service tier for this request - `default`: Default service tier - `scale`: Used reserved quota

"default"
choicesobject[]

Chat completion choices list

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hello! Doubao Seed 2.0 is ByteDance's next-generation large language model, featuring enhanced reasoning, multimodal understanding, and deep thinking capabilities..."
    },
    "finish_reason": "stop",
    "moderation_hit_type": "severe_violation"
  }
]
usageobject

Token usage statistics

{
  "prompt_tokens": 15,
  "completion_tokens": 256,
  "total_tokens": 271,
  "prompt_tokens_details": {
    "cached_tokens": 0
  },
  "completion_tokens_details": {
    "reasoning_tokens": 0
  }
}
POST/v1/chat/completions
curl --request POST \
  --url https://api.starmagic.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "doubao-seed-2.0-pro",
  "messages": [
    {
      "role": "user",
      "content": "Hello, introduce the new features of Doubao Seed 2.0"
    }
  ]
}'
Response: 成功
{
  "id": "0217714854126607f5a9cf8ed5b018c76e4ad3dc2810db57ffb50",
  "model": "doubao-seed-2-0-pro-260215",
  "object": "chat.completion",
  "created": 1771485416,
  "service_tier": "default",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": null,
        "content": null
      },
      "finish_reason": "stop",
      "moderation_hit_type": "severe_violation"
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 256,
    "total_tokens": 271,
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 0
    }
  }
}