Skip to main content
POST
BaseURL note: The default BaseURL is https://direct.evolink.ai, which offers better support for text models and long connections. https://api.evolink.ai is the primary multimodal endpoint; use it when your request includes image input.Session caching: The Responses API enables server-side session caching via the x-dashscope-session-cache: enable request header to reduce multi-turn latency and cost.

Authorizations

Authorization
string
header
required

##All APIs require Bearer Token authentication##

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header:

Headers

x-dashscope-session-cache
enum<string>
default:disable

Session caching switch. When set to enable, the server automatically caches the conversation context to reduce multi-turn inference latency and cost.

Available options:
enable,
disable

Body

application/json
model
enum<string>
required

Chat model name

Available options:
qwen3.8-max-preview
Example:

"qwen3.8-max-preview"

input
required

Model input. Can be a string (plain text) or a Chat-format message array (supporting multimodal input_text / input_image).

instructions
string

Inserted as a system instruction at the start of the context. When using previous_response_id, the previous turn's instructions are not carried into this turn.

previous_response_id
string

Unique ID of the previous response (the response id, valid for 7 days). Used to link multi-turn conversations; the server automatically retrieves and combines that turn's input and output as context.

max_output_tokens
integer

Maximum number of output tokens to generate this time (including thinking).

reasoning
object

Thinking control.

store
boolean
default:true

Whether to store this response.

  • true (default): can be referenced by previous_response_id
  • false: not stored and cannot be referenced later
stream
boolean
default:false

Whether to return a Responses event stream.

temperature
number

Sampling temperature, range [0, 2].

Required range: 0 <= x <= 2
top_p
number

Nucleus sampling parameter, range (0, 1].

Required range: 0 <= x <= 1
tools
object[]

List of tools. Supports built-in tools (web_search for web search, web_extractor for web extraction, code_interpreter for code interpretation) and custom function tools.

Response

Generated successfully

id
string

Unique ID of this response (valid for 7 days, can be used as previous_response_id)

Example:

"resp_xxxxxxxx"

object
string
Example:

"response"

status
string

Response status

Example:

"completed"

model
string
Example:

"qwen3.8-max-preview"

output
object[]

Array of output items (including message / reasoning / built-in tool calls, etc.)

usage
object

Token usage statistics.