概述
Ling.AI 会透传百炼侧的代码解释器能力。对于 /v1/chat/completions 和 DashScope,通常通过 enable_code_interpreter 启用;对于 /v1/responses,则通过 tools 中的 code_interpreter 工具启用。
使用限制
代码解释器通常要求同时开启 enable_thinking,并且在 Chat Completions / DashScope 下通常仅支持流式输出。另外,它与普通函数调用工具编排通常被上游视为互斥场景,请不要把 enable_code_interpreter 和自定义 tools / Function Calling 混在同一条 Chat 请求里。
Responses API
/v1/responses 是最完整的代码解释器接入方式。您可以把 code_interpreter 单独打开,也可以与 web_search、web_extractor 组合使用。
from openai import OpenAI
client = OpenAI(
base_url="https://api.vip.lingapi.ai/v1",
api_key="sk-xxxxxxxx"
)
response = client.responses.create(
model="qwen3-max-2026-01-23",
input="123的21次方是多少?",
tools=[
{"type": "code_interpreter"},
{"type": "web_search"},
{"type": "web_extractor"}
],
enable_thinking=True
)
print(response.output_text)
Responses API 下,工具调用阶段通常会出现在 response.output 中,类型可能为 code_interpreter_call。若上游返回工具统计,调用次数通常可在 usage.x_tools.code_interpreter.count 中查看。
Chat Completions
在 /v1/chat/completions 中,通过 enable_code_interpreter 打开代码解释器。常见做法是与 enable_thinking 一起传入,并启用流式输出。
from openai import OpenAI
client = OpenAI(
base_url="https://api.vip.lingapi.ai/v1",
api_key="sk-xxxxxxxx"
)
stream = client.chat.completions.create(
model="qwen3-max-2026-01-23",
messages=[
{"role": "user", "content": "123的21次方是多少?"}
],
extra_body={
"enable_code_interpreter": True,
"enable_thinking": True
},
stream=True
)
Chat 提示
OpenAI 兼容 Chat Completions 一般拿不到代码执行细节本身,只能看到思考内容与最终回答。如需拿到中间代码或更完整的工具事件,请优先使用 Responses API 或 DashScope。
DashScope
DashScope 协议下同样通过 enable_code_interpreter 启用,并且会在流式块里额外返回 tool_info,其中可包含代码内容。
import dashscope
response = dashscope.Generation.call(
api_key="sk-xxxxxxxx",
model="qwen3-max-2026-01-23",
messages=[
{"role": "user", "content": "123的21次方是多少?"}
],
enable_code_interpreter=True,
enable_thinking=True,
result_format="message",
stream=True,
incremental_output=True
)
for chunk in response:
print(chunk.output.get("tool_info"))
如果上游返回代码执行明细,通常会在 tool_info 中看到类似 {"type":"code_interpreter","code_interpreter":{"code":"123**21"}} 的结构。
计费说明
- 代码解释器本身在当前官方默认配置下仍按限时免费处理,但会显著增加 Token 消耗。
- 系统内置的官方工具默认值里,
code_interpreter当前映射为免费工具;如上游价格调整,可在后台工具计费规则中覆盖。