LLM 模型对话调用

请求参数

Header 参数

Authorization

string

认证信息

必需

示例值:

Bearer {{api_key}}

Body 参数application/json

model

enum<string>

询问的AI大模型

必需

枚举值:

qwen-plus-latestqwen-max-latestqwen-turbo-latestqwen2.5-14b-instruct-1mqwen-math-plus-latestqwen-coder-plus-latestqwen2.5-vl-32b-instructqwen2.5-vl-72b-instructqwen-vl-max-latestqwen-vl-plus-latestqvq-maxqwq-32bqwq-plusGLM-4-PlusGLM-4-AirGLM-4-FlashGLM-Z1-AirGLM-Z1-AirXGLM-Z1-FlashGLM-4-LongGLM-4V-PlusGLM-4V-Flashdoubao-1-5-thinking-pro-250415Doubao-1.5-pro-32kDoubao-1.5-pro-256kDoubao-1.5-lite-32kdoubao-1.5-vision-pro-250328doubao-1.5-vision-lite-250315Doubao-pro-32k-characterdeepseek-chatdeepseek-reasonerdeepseek-v3-freedeepseek-r1-freedeepseek-v3-aliyundeepseek-r1-aliyundeepseek-v3-baiduyundeepseek-r1-baiduyundeepseek-v3-tencentdeepseek-r1-tencentdeepseek-v3-volcenginedeepseek-r1-volcenginedeepseek-v3-siliconflowdeepseek-r1-siliconflowdeepseek-r1-minimaxMiniMax-Text-01abab7-chat-previewabab6.5s-chathunyuan-litehunyuan-turbos-latesthunyuan-t1-latesthunyuan-large-longcontexthunyuan-visionernie-4.5-turbo-32kernie-x1-turbo-32kernie-4.5-turbo-vl-32kernie-speed-128kyi-largeyi-lightningyi-medium-200kyi-visionBaichuan4-TurboBaichuan4-AirBaichuan3-Turbo-128kLiteMax-32K4.0Ultrakimi-latestgpt-4o-minigpt-4.1gpt-4.1-20%gpt-4.1-minigpt-4.1-nanogpt-4ogpt-4o-20%o3-20%gpt-4o-imageo3-minio4-minio1claude-sonnet-4-20250514claude-sonnet-4-20250514-thinkingclaude-opus-4-20250514claude-sonnet-4-20250514-70%claude-sonnet-4-20250514-thinking-70%claude-opus-4-20250514-70%claude-opus-4-20250514-thinking-70%claude-sonnet-4-20250514-50%claude-sonnet-4-20250514-thinking-50%claude-3.7-sonnetclaude-3.7-sonnet-thinkingclaude-3.7-sonnet-20%claude-3.7-sonnet-thinking-20%gemini-2.5-flash-preview-05-20gemini-2.5-flash-preview-05-20-50%gemini-2.5-flash-preview-04-17-20%gemini-2.5-pro-preview-05-06gemini-2.5-pro-preview-05-06-50%gemini-2.5-pro-exp-03-25-20%gemini-2.0-flash-preview-image-generationgemini-2.0-flash-001gemini-2.0-flash-litegrok-3grok-3-20%grok-3-reasoninggrok-3-deepsearchgrok-3-search

示例值:

deepseek-v3-tencent

messages

array [object {2}]

会话和提问

必需

role

enum<string>

角色

必需

枚举值:

systemassistantuser

示例值:

systemuserassistant

content

string

文本内容

必需

temperature

number

核采样阈值

可选

默认值:

0.2

示例值:

0.2

max_tokens

integer

可选

回答的tokens的最大长度

示例值:

4000

stream

boolean

流式传输

可选

默认值:

false

web_search

boolean

联网搜索

可选

默认值:

false

reason

boolean

深度思考模式

可选

默认值:

false

session_id

integer

可选

会话session ID

session_token

string

可选

(推荐使用) 和session_id 任选一

示例值:

e8eec3b3-c75f-4390-8a68-adf369c50fbe

示例

{
    "model": "Doubao-1.5-lite-32k",
    "messages": [
        {
            "role": "user",
            "content": "今天深圳的天气"
        }
    ],
    "temperature": 0.2,
    "max_tokens": 2000,
    "stream": false,
    "web_search": false,
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "get_current_weather",
                "description": "获得天气信息",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "location": {
                            "type": "string",
                            "description": "城市和州名，例如：上海, 中国"
                        },
                        "unit": {
                            "type": "string",
                            "enum": [
                                "celsius",
                                "fahrenheit"
                            ]
                        }
                    },
                    "required": [
                        "location"
                    ]
                }
            }
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.mindcraft.com.cn/v1/chat/completions' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "Doubao-1.5-lite-32k",
    "messages": [
        {
            "role": "user",
            "content": "今天深圳的天气"
        }
    ],
    "temperature": 0.2,
    "max_tokens": 2000,
    "stream": false,
    "web_search": false,
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "get_current_weather",
                "description": "获得天气信息",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "location": {
                            "type": "string",
                            "description": "城市和州名，例如：上海, 中国"
                        },
                        "unit": {
                            "type": "string",
                            "enum": [
                                "celsius",
                                "fahrenheit"
                            ]
                        }
                    },
                    "required": [
                        "location"
                    ]
                }
            }
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

id

string

必需

model

string

必需

usage

object

模型消耗

必需

completion_tokens

integer

必需

prompt_tokens

integer

必需

total_tokens

integer

必需

choices

array [object {2}]

必需

message

object

可选

finish_reason

string

可选

示例

成功示例成功示例(联网搜索)tools

{
    "id": "76dae891b9744c19853bc66464d684cd",
    "model": "deepseek-r1-tencent",
    "usage": {
        "completion_tokens": 941,
        "prompt_tokens": 12,
        "total_tokens": 953
    },
    "choices": [
        {
            "message": {
                "role": "assistant",
                "content": "\n\n关于“人能不能不学习”这个问题，......",
                "reasoning_content": "\n嗯，用户问“人能不能不学习”，这个问题看起来简单，但可能涉及多个层面。首先，我需要确定用户的具体意图。是出于对学习压力的逃避，还是对学习本质的哲学思考？或者可能是在寻求某种生活方式的建议？\n\n接下来，我得考虑不同的角度。从生物学角度看，人类天生有学习的能力和需求，比如婴儿学习走路、说话。如果不学习，生存都会成问题。但现代社会中的“学习”可能更多指学校教育或技能获取，这时候是否需要学习可能取决于个人目标。\n\n然后是社会角度，现代社会对知识和技能的依赖很大，不学习可能导致竞争力下降，影响就业和生活质量。但另一方面，有些人可能通过实践经验而非传统学习途径获得成功，比如某些创业者或艺术家，这时候是否算“不学习”呢？\n\n还有心理层面，学习是否是人类内在的需求？如果一个人完全不学习，可能会感到无聊或缺乏成就感。但如果有其他方式满足心理需求，比如社交、娱乐，是否可以不学习？\n\n另外，用户可能隐含对教育体系的不满，或者感到学习压力大，想寻找不学习的合理性。这时候需要平衡现实需求和个人幸福，给出建设性建议，而不是绝对的回答。\n\n可能还需要区分“学习”的定义。广义的学习包括任何新经验的获取，而狭义指正式教育。如果用户指后者，那么答案可能更灵活，但如果是前者，几乎不可能不学习。\n\n还要考虑文化差异，不同社会对学习的重视程度不同，可能影响答案。比如在技术发展快的国家，持续学习几乎是必须的，而在某些传统社群中，生活技能可能通过观察和实践自然获得，不需要正规学习。\n\n最后，总结时需强调学习的重要性，同时尊重个人选择，指出可能的后果，帮助用户权衡利弊，而不是给出非黑即白的答案。\n"
            },
            "finish_reason": "stop"
        }
    ],
    "status": 200
}

🟢200流体成功请求

🟢200联网请求

使用 openai的py包 代码请求#

请求参数

示例代码

返回响应

使用 openai的py包代码请求