curl --request POST \
  --url https://api.powertokens.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen3.6-plus",
  "input": "What can you do?"
}
'

{
  "id": "<string>",
  "created_at": 123,
  "object": "response",
  "model": "<string>",
  "output": [
    {
      "id": "<string>",
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "<string>",
          "annotations": [
            {}
          ],
          "logprobs": {},
          "ocr_result": "<unknown>"
        }
      ]
    }
  ],
  "parallel_tool_calls": true,
  "tool_choice": "<unknown>",
  "tools": [
    {}
  ],
  "usage": {
    "input_tokens": 123,
    "output_tokens": 123,
    "total_tokens": 123,
    "input_tokens_details": {
      "cached_tokens": 123,
      "text_tokens": 123,
      "image_tokens": 123
    },
    "output_tokens_details": {
      "reasoning_tokens": 123,
      "text_tokens": 123
    },
    "x_details": [
      {}
    ],
    "x_tools": {},
    "plugins": {},
    "prompt_tokens_details": {}
  },
  "error": {}
}

{
  "error": {
    "message": "input is required",
    "type": "invalid_request_error",
    "code": "bad_request_body",
    "param": "input"
  }
}

{
  "error": {
    "message": "无效的令牌",
    "type": "api_error",
    "code": "access_denied",
    "param": ""
  }
}

{
  "error": {
    "message": "当前账户额度不足，请稍后重试",
    "type": "api_error",
    "code": "insufficient_user_quota",
    "param": ""
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

聊天模型

Responses API

使用 Responses API 兼容格式创建模型响应。input 可传入字符串或消息数组；需要多轮上下文时可传入上一轮响应的 previous_response_id，也可把上一轮 output 中的消息、推理或工具调用项放回 input。

公开字段：model、input、instructions、previous_response_id、conversation、stream、store、tools、tool_choice、temperature、top_p、enable_thinking、reasoning、ocr_options。字段是否生效取决于模型和上游渠道能力。

POST

responses

curl --request POST \
  --url https://api.powertokens.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen3.6-plus",
  "input": "What can you do?"
}
'

{
  "id": "<string>",
  "created_at": 123,
  "object": "response",
  "model": "<string>",
  "output": [
    {
      "id": "<string>",
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "<string>",
          "annotations": [
            {}
          ],
          "logprobs": {},
          "ocr_result": "<unknown>"
        }
      ]
    }
  ],
  "parallel_tool_calls": true,
  "tool_choice": "<unknown>",
  "tools": [
    {}
  ],
  "usage": {
    "input_tokens": 123,
    "output_tokens": 123,
    "total_tokens": 123,
    "input_tokens_details": {
      "cached_tokens": 123,
      "text_tokens": 123,
      "image_tokens": 123
    },
    "output_tokens_details": {
      "reasoning_tokens": 123,
      "text_tokens": 123
    },
    "x_details": [
      {}
    ],
    "x_tools": {},
    "plugins": {},
    "prompt_tokens_details": {}
  },
  "error": {}
}

{
  "error": {
    "message": "input is required",
    "type": "invalid_request_error",
    "code": "bad_request_body",
    "param": "input"
  }
}

{
  "error": {
    "message": "无效的令牌",
    "type": "api_error",
    "code": "access_denied",
    "param": ""
  }
}

{
  "error": {
    "message": "当前账户额度不足，请稍后重试",
    "type": "api_error",
    "code": "insufficient_user_quota",
    "param": ""
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

授权

Authorization

string

header

必填

在请求头中传入 Authorization: Bearer <token>。

请求头

x-dashscope-session-cache

enum<string>

可选的上游会话缓存开关。仅在当前模型和上游渠道支持时生效。

可用选项:

enable

请求体

application/json

model

enum<string>

必填

模型名称。请使用平台接口已公开且支持 Responses API 的模型；具体模型是否支持工具、OCR 或思考模式，取决于当前渠道能力。

可用选项:

MiniMax-M2.5,

MiniMax-M2.5-highspeed,

MiniMax-M2.7,

MiniMax-M2.7-highspeed,

MiniMax-M3,

mimo-v2.5,

mimo-v2.5-pro,

qwen3-coder-plus,

qwen3-max,

qwen3.5-flash,

qwen3.6-plus,

deepseek-v3-2-251201,

seed-1-6-250915,

seed-1-6-flash-250715,

seed-1-8-251228,

seed-2-0-lite-260228,

seed-2-0-mini-260215,

seed-2-0-pro-260328

示例:

"qwen3.6-plus"

input

必填

模型输入。可传入纯文本字符串，也可传入按对话顺序排列的消息数组。多轮工具调用时，可把上一轮响应中的 message、function_call、function_call_output 或 reasoning 项传回。

instructions

string

系统指令，插入到上下文起始位置。使用 previous_response_id 时，上一轮的 instructions 不会自动传入本轮上下文。

previous_response_id

string

上一轮响应的 id。用于创建多轮对话，服务端会把上一轮输入和输出组合为上下文。不能与 conversation 同时使用。

conversation

string

当前响应所属的会话 ID。会话历史会作为上下文传入，本次输入和输出会在响应完成后添加到会话中。不能与 previous_response_id 同时使用。

stream

boolean

默认值:false

是否启用流式输出。设置为 true 时返回 SSE 事件流。

store

boolean

默认值:true

是否存储本次响应。设为 false 时，该响应不能通过 previous_response_id 作为后续上下文使用。

tools

object[]

模型生成响应时可调用的工具数组。可混合使用内置工具和自定义 function 工具。工具是否生效取决于模型和上游渠道支持情况。

Option 1
Option 2
Option 3
Option 4

Show child attributes

tool_choice

默认值:auto

控制模型如何选择工具。字符串模式支持 auto、none、required；对象模式用于限制模型只能在给定工具列表中选择。

可用选项:

auto,

none,

required

temperature

number

采样温度，控制输出随机性。建议不要同时设置 temperature 和 top_p。

必填范围: 0 <= x < 2

top_p

number

核采样概率阈值，控制输出多样性。建议不要同时设置 temperature 和 top_p。

必填范围: 0 < x <= 1

enable_thinking

boolean

已弃用

是否开启思考模式。该字段不是 OpenAI 标准字段，建议使用 reasoning.effort 替代。

reasoning

object

控制模型的思考强度。设置后，模型可能在回复前生成 reasoning 类型输出项。

Show child attributes

ocr_options

object

OCR 定制任务参数，仅适用于支持 OCR 的模型。定制任务结果会通过响应内容中的 ocr_result 返回。

响应

调用成功。非流式模式返回完整 Response 对象；流式模式返回 SSE 事件流。

string

必填

本次响应的唯一标识符，可用于 previous_response_id。

created_at

integer

必填

本次请求的 Unix 时间戳（秒）。

object

enum<string>

必填

固定为 response。

可用选项:

response

status

enum<string>

必填

响应生成状态。

可用选项:

completed,

failed,

in_progress,

cancelled,

queued,

incomplete

model

string

必填

用于生成响应的模型 ID。

output

object · object · 函数调用 · object · object · object · object[]

必填

模型生成的输出项数组。数组中的元素类型和顺序取决于模型响应和工具调用情况。

Show child attributes

parallel_tool_calls

boolean

是否并行调用工具。

tool_choice

any

回显请求中的工具选择策略。

tools

object[]

回显请求中的工具配置。

Option 1
Option 2
Option 3
Option 4

Show child attributes

usage

object

Token 用量统计。启用工具、缓存、OCR 或多模态输入时，可能返回额外明细字段。

Show child attributes

error

object | null

生成失败时的错误对象；成功时通常为 null。

Claude 消息接口

miniMax-M2.5

聊天模型

图像模型

视频模型

音频模型

资产库

Responses API

授权

请求头

请求体

响应