StarMagicStarMagic
Español
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
Guía de integración
Doubao Seed 2.0 - 快速开始Doubao Seed 2.0 - 完整参数文档Doubao Seed 2.0 Responses API - 快速开始Doubao Seed 2.0 Responses API - 完整参数文档
StarMagicStarMagic
Español
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
TextoDoubaoDoubao.Seed.2.0

Doubao Seed 2.0 Responses API - Inicio rápido

  • 使用 Responses API 格式调用 Doubao Seed 2.0 系列模型
  • 支持服务端上下文存储,通过 previous_response_id 实现多轮对话
  • 最简化参数,快速上手
  • 支持模型:doubao-seed-2.0-pro、doubao-seed-2.0-lite、doubao-seed-2.0-mini、doubao-seed-2.0-code <Note> **BaseURL**: La BaseURL predeterminada es `https://api.starmagic.ai`, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. `https://api.starmagic.ai` es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto.
</Note>

Autorización

AuthorizationstringheaderObligatorio

##所有接口均需要使用Bearer Token进行认证## **获取 API Key:** 访问 [API Key 管理页面](https://starmagic.ai/app/api-keys) 获取您的 API Key **使用时在请求头中添加:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

Cuerpo de solicitud

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

对话模型名称 - `doubao-seed-2.0-pro`: 旗舰版,综合能力最强,适合复杂推理和高质量生成 - `doubao-seed-2.0-lite`: 轻量版,速度更快,性价比高 - `doubao-seed-2.0-mini`: 极速版,响应最快,适合简单任务 - `doubao-seed-2.0-code`: 代码专用版,针对代码生成和理解优化

"doubao-seed-2.0-pro"
inputstringObligatorio

输入内容(纯文本),等同于使用 user 角色输入的文本信息

"你好,介绍一下 Doubao Seed 2.0 的新特性"

Respuesta

application/json
成功

Cuerpo de respuesta

idstring

本次响应的唯一标识

"resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e"
objectenum<response>

对象类型,固定为 response

"response"
created_atnumber

创建时间的 Unix 时间戳(秒)

1771486674
modelstring

实际使用的模型名称和版本

"doubao-seed-2-0-code-preview-260215"
statusenum<completed | in_progress | incomplete | failed>

响应状态 - `completed`: 生成完成 - `in_progress`: 生成中 - `incomplete`: 未完成 - `failed`: 失败

"completed"
outputobject[]

模型输出内容列表

[
  null
]
service_tierstring

本次请求的服务等级

"default"
usageobject

Token 使用统计信息

{
  "input_tokens": 88,
  "input_tokens_details": {
    "cached_tokens": 0
  },
  "output_tokens": 230,
  "output_tokens_details": {
    "reasoning_tokens": 211
  },
  "total_tokens": 318
}
max_output_tokensinteger

模型输出最大 token 数

32768
cachingobject

缓存配置

{
  "type": "enabled"
}
storeboolean

是否存储了响应

true
expire_atinteger

存储过期时刻(Unix 时间戳)

1771745874
errorobject

错误信息,成功时为 null

{}
POST/v1/responses
curl --request POST \
  --url https://api.starmagic.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "doubao-seed-2.0-pro",
  "input": "你好,介绍一下 Doubao Seed 2.0 的新特性"
}'
Respuesta: 成功
{
  "id": "resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e",
  "object": "response",
  "created_at": 1771486674,
  "model": "doubao-seed-2-0-code-preview-260215",
  "status": "completed",
  "output": [
    null
  ],
  "service_tier": "default",
  "usage": {
    "input_tokens": 88,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 230,
    "output_tokens_details": {
      "reasoning_tokens": 211
    },
    "total_tokens": 318
  },
  "max_output_tokens": 32768,
  "caching": {
    "type": "enabled"
  },
  "store": true,
  "expire_at": 1771745874,
  "error": {}
}