Skip to main content
POST
Chat completion: Qwen3.8-Max (OpenAI compatible)
오른쪽의 플레이그라운드를 사용해 요청을 직접 전송하십시오: AuthorizationBearer sk-your-api-key를 넣으십시오. 예제에는 이미 reasoning_effort: "none"이 포함되어 있으며, 전송을 눌러 응답을 확인하십시오.
모델은 기본적으로 추론합니다(티어 xhigh, 출력으로 과금됩니다). 이 예제는 디버깅을 빠르고 저렴하게 유지하기 위해 추론을 비활성화합니다. 어려운 추론의 경우 reasoning_effort 필드를 제거하고 max_tokens를 4000 이상으로 올리십시오. 전체 설명은 Qwen3.8-Max 개요를 참조하십시오.

매개변수 빠른 참조

세 가지 쉬운 실수

1. max_tokens는 추론을 제한하지 않습니다. max_tokens=1를 설정했지만 여전히 출력 token 1,054개(그중 1,045개는 추론)로 청구되었습니다. 비용을 제어하려면 reasoning_effort="none"를 사용하십시오.2. 강제 도구 호출에는 추론을 꺼야 합니다. tool_choice"required" 또는 이름이 지정된 함수로 설정된 경우, 추론 모드에서는 400이 반환되거나 호출이 조용히 건너뛰어집니다 — 함께 reasoning_effort="none"를 전달하십시오.3. thinking_budget는 아무 효과가 없습니다. 어떤 값이든 low 티어와 동일하게 동작합니다. 대신 reasoning_effort를 사용하십시오.

응답 읽기

  • 추론 흔적은 choices[0].message.reasoning_content에 있습니다(추론이 켜져 있을 때 반환됩니다)
  • 추론 비용은 usage.completion_tokens_details.reasoning_tokens에, 캐시 적중은 usage.prompt_tokens_details.cached_tokens에 있습니다
  • 일부 상위 라우트는 이 두 필드를 보고하지 않습니다(테스트에서 요청의 약 3분의 1) — 정확한 추론 비용 집계가 필요하다면 이 점을 염두에 두십시오
  • 7개의 유효한 reasoning_effort 값은 실제로 4개의 등급에만 매핑됩니다; maxxhigh보다 더 깊게 추론하지 않습니다
  • 잘못된 reasoning_effort 값은 조용히 낮은 등급으로 대체하지 않고, 전체 유효 집합을 나열하는 400 응답을 반환합니다

관련

인증

Authorization
string
header
필수

Add Authorization: Bearer YOUR_API_KEY to the request header

본문

application/json
model
string
필수

Always qwen3.8-max

messages
object[]
필수

Standard OpenAI message array

max_tokens
integer

Output budget for the visible answer, range [1, 131072]. Note: does not bound thinking tokens

reasoning_effort
enum<string>

Thinking tier, default xhigh. Measured to have only four real tiers: none / minimal≡low / medium / high≡xhigh≡max

사용 가능한 옵션:
none,
minimal,
low,
medium,
high,
xhigh,
max
temperature
number

Valid range [0.0, 2.0); passing 2 returns 400

top_p
number

Valid range (0.0, 1.0]

top_k
integer
stream
boolean

SSE streaming. This endpoint returns usage in the final chunk even without stream_options

stop
string[]

Stop sequences, verified working

response_format
object

Structured output; json_schema held strictly in testing. Pair it with reasoning_effort: none

tools
object[]

Function calling tool list, verified working

tool_choice
any

auto / none work as-is; required or a named function requires reasoning_effort: none

parallel_tool_calls
boolean

Set false to limit to a single tool call, verified working

n
integer

Number of candidates. Values above 1 require reasoning_effort: none

logprobs
boolean

응답

Chat completion succeeded

id
string
model
string
choices
object[]
usage
object

Usage stats. Some upstream routes do not report reasoning_tokens or cached_tokens