๋ฉ”์ธ ์ฝ˜ํ…์ธ ๋กœ ๊ฑด๋„ˆ๋›ฐ๊ธฐ
POST
BaseURL ์„ค๋ช…: ๊ธฐ๋ณธ BaseURL์€ https://direct.evolink.ai์ด๋ฉฐ, ํ…์ŠคํŠธ ๋ชจ๋ธ์„ ๋” ์ž˜ ์ง€์›ํ•˜๊ณ  ์žฅ๊ธฐ ์—ฐ๊ฒฐ์„ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค; https://api.evolink.ai๋Š” ๋ฉ€ํ‹ฐ๋ชจ๋‹ฌ ์ฃผ๋ ฅ ์ฃผ์†Œ๋กœ, ์ด๋ฏธ์ง€ ์ž…๋ ฅ์„ ํฌํ•จํ•  ๋•Œ ์ด ์ฃผ์†Œ๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.์„ธ์…˜ ์บ์‹œ: Responses API๋Š” ์š”์ฒญ ํ—ค๋” x-dashscope-session-cache: enable๋กœ ์„œ๋ฒ„ ์ธก ์„ธ์…˜ ์บ์‹œ๋ฅผ ํ™œ์„ฑํ™”ํ•˜์—ฌ ๋ฉ€ํ‹ฐํ„ด ์ง€์—ฐ๊ณผ ๋น„์šฉ์„ ์ ˆ๊ฐํ•ฉ๋‹ˆ๋‹ค.

์ธ์ฆ

Authorization
string
header
ํ•„์ˆ˜

##๋ชจ๋“  API์—๋Š” Bearer Token ์ธ์ฆ์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค##

API Key ๋ฐœ๊ธ‰:

API Key ๊ด€๋ฆฌ ํŽ˜์ด์ง€์—์„œ API Key๋ฅผ ๋ฐœ๊ธ‰๋ฐ›์œผ์„ธ์š”

์š”์ฒญ ํ—ค๋”์— ์ถ”๊ฐ€:

ํ—ค๋”

x-dashscope-session-cache
enum<string>
๊ธฐ๋ณธ๊ฐ’:disable

์„ธ์…˜ ์บ์‹œ ์Šค์œ„์น˜. enable๋กœ ์„ค์ •ํ•˜๋ฉด ์„œ๋ฒ„๊ฐ€ ๋Œ€ํ™” ์ปจํ…์ŠคํŠธ๋ฅผ ์ž๋™ ์บ์‹œํ•˜์—ฌ ๋ฉ€ํ‹ฐํ„ด ์ถ”๋ก  ์ง€์—ฐ๊ณผ ๋น„์šฉ์„ ์ ˆ๊ฐํ•ฉ๋‹ˆ๋‹ค.

์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์˜ต์…˜:
enable,
disable

๋ณธ๋ฌธ

application/json
model
enum<string>
ํ•„์ˆ˜

๋Œ€ํ™” ๋ชจ๋ธ ์ด๋ฆ„

์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์˜ต์…˜:
qwen3.8-max-preview
์˜ˆ์‹œ:

"qwen3.8-max-preview"

input
ํ•„์ˆ˜

๋ชจ๋ธ ์ž…๋ ฅ. ๋ฌธ์ž์—ด(์ˆœ์ˆ˜ ํ…์ŠคํŠธ)์„ ์ „๋‹ฌํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, Chat ํ˜•์‹์˜ ๋ฉ”์‹œ์ง€ ๋ฐฐ์—ด๋„ ์ „๋‹ฌ ๊ฐ€๋Šฅ(๋ฉ€ํ‹ฐ๋ชจ๋‹ฌ input_text / input_image ์ง€์›).

instructions
string

์‹œ์Šคํ…œ ์ง€์‹œ๋กœ ์ปจํ…์ŠคํŠธ ์‹œ์ž‘ ์œ„์น˜์— ์‚ฝ์ž…๋ฉ๋‹ˆ๋‹ค. previous_response_id๋ฅผ ์‚ฌ์šฉํ•  ๋•Œ, ์ด์ „ ํ„ด์˜ instructions๋Š” ์ด๋ฒˆ ํ„ด์— ์ „๋‹ฌ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

previous_response_id
string

์ด์ „ ํ„ด ์‘๋‹ต์˜ ๊ณ ์œ  ID(์‘๋‹ต id, ์œ ํšจ ๊ธฐ๊ฐ„ 7์ผ). ๋ฉ€ํ‹ฐํ„ด ๋Œ€ํ™”๋ฅผ ์—ฐ๊ฒฐํ•˜๋Š” ๋ฐ ์‚ฌ์šฉํ•˜๋ฉฐ, ์„œ๋ฒ„๊ฐ€ ํ•ด๋‹น ํ„ด์˜ ์ž…๋ ฅ๊ณผ ์ถœ๋ ฅ์„ ์ž๋™์œผ๋กœ ๊ฒ€์ƒ‰ยท๊ตฌ์„ฑํ•˜์—ฌ ์ปจํ…์ŠคํŠธ๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

max_output_tokens
integer

์ด๋ฒˆ ์ƒ์„ฑ ์ถœ๋ ฅ ์ฝ˜ํ…์ธ ์˜ ์ตœ๋Œ€ token ์ˆ˜(์‚ฌ๊ณ  ํฌํ•จ).

reasoning
object

์‚ฌ๊ณ  ์ œ์–ด.

store
boolean
๊ธฐ๋ณธ๊ฐ’:true

์ด๋ฒˆ ์‘๋‹ต์„ ์ €์žฅํ• ์ง€ ์—ฌ๋ถ€.

  • true(๊ธฐ๋ณธ๊ฐ’): previous_response_id๋กœ ์ฐธ์กฐ ๊ฐ€๋Šฅ
  • false: ์ €์žฅํ•˜์ง€ ์•Š์œผ๋ฉฐ, ์ดํ›„ ์ฐธ์กฐํ•  ์ˆ˜ ์—†์Œ
stream
boolean
๊ธฐ๋ณธ๊ฐ’:false

Responses ์ด๋ฒคํŠธ๋กœ ์ŠคํŠธ๋ฆฌ๋ฐ ๋ฐ˜ํ™˜ํ• ์ง€ ์—ฌ๋ถ€.

temperature
number

์ƒ˜ํ”Œ๋ง ์˜จ๋„, ๋ฒ”์œ„ [0, 2].

ํ•„์ˆ˜ ๋ฒ”์œ„: 0 <= x <= 2
top_p
number

๋‰ดํด๋ฆฌ์–ด์Šค ์ƒ˜ํ”Œ๋ง ๋งค๊ฐœ๋ณ€์ˆ˜, ๋ฒ”์œ„ (0, 1].

ํ•„์ˆ˜ ๋ฒ”์œ„: 0 <= x <= 1
tools
object[]

๋„๊ตฌ ๋ชฉ๋ก. ๋‚ด์žฅ ๋„๊ตฌ(web_search ์›น ๊ฒ€์ƒ‰, web_extractor ์›น ํŽ˜์ด์ง€ ์ถ”์ถœ, code_interpreter ์ฝ”๋“œ ์ธํ„ฐํ”„๋ฆฌํ„ฐ)์™€ ์‚ฌ์šฉ์ž ์ •์˜ function์„ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.

์‘๋‹ต

์ƒ์„ฑ ์„ฑ๊ณต

id
string

์ด๋ฒˆ ์‘๋‹ต์˜ ๊ณ ์œ  ID(์œ ํšจ ๊ธฐ๊ฐ„ 7์ผ, previous_response_id๋กœ ์‚ฌ์šฉ ๊ฐ€๋Šฅ)

์˜ˆ์‹œ:

"resp_xxxxxxxx"

object
string
์˜ˆ์‹œ:

"response"

status
string

์‘๋‹ต ์ƒํƒœ

์˜ˆ์‹œ:

"completed"

model
string
์˜ˆ์‹œ:

"qwen3.8-max-preview"

output
object[]

์ถœ๋ ฅ ํ•ญ๋ชฉ ๋ฐฐ์—ด(message / reasoning / ๋‚ด์žฅ ๋„๊ตฌ ํ˜ธ์ถœ ๋“ฑ ํฌํ•จ)

usage
object

token ์‚ฌ์šฉ ํ†ต๊ณ„.