POST https://www.moyu.cn/v1/chat/completions{
"id": "chatcmpl-123",
"object": "chat.completion",
"created": 1677652288,
"model": "MODEL_NAME",
"choices": [{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!有什么我可以帮助你的吗?"
},
"finish_reason": "stop"
}],
"usage": {
"prompt_tokens": 9,
"completion_tokens": 12,
"total_tokens": 21,
"prompt_tokens_details": {
"cached_tokens": 0
},
"completion_tokens_details": {
"reasoning_tokens": 0
}
}
}| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称,如 gpt-4o, gpt-4o-mini, chatgpt-4o-latest 等 |
| messages | array | 是 | 对话消息列表,每条消息包含 role 和 content |
[
{"role": "system", "content": "你是一个助手"},
{"role": "user", "content": "你好"}
]system: 系统消息,用于设定助手的行为user: 用户消息assistant: 助手的回复| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| temperature | number | 否 | 1 | 采样温度,范围 0-2。较高的值(如 1.5)使输出更随机,较低的值(如 0.2)使输出更确定 |
| top_p | number | 否 | 1 | 核采样参数,范围 0-1。建议只调整 temperature 或 top_p,不要同时调整 |
| n | integer | 否 | 1 | 为每个输入生成的补全数量 |
| stream | boolean | 否 | false | 是否流式输出。true 时,服务器将发送 SSE 事件流 |
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| max_tokens | integer | 否 | 模型最大值 | 生成的最大 token 数量 |
| max_completion_tokens | integer | 否 | - | 补全部分的最大 token 数量 |
| stop | string/array | 否 | null | 停止序列。最多 4 个序列,遇到时 API 将停止生成 |
| presence_penalty | number | 否 | 0 | 存在惩罚,范围 -2.0 到 2.0。正值会根据新 token 是否出现在文本中来惩罚它们 |
| frequency_penalty | number | 否 | 0 | 频率惩罚,范围 -2.0 到 2.0。正值会根据新 token 在文本中的现有频率来惩罚它们 |
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| stream_options | object | 否 | - | 流式输出的额外选项,如 include_usage: true |
| logprobs | boolean | 否 | false | 是否返回输出 token 的对数概率 |
| top_logprobs | integer | 否 | - | 每个 token 位置返回的最可能 token 数量,范围 0-20 |
| user | string | 否 | - | 终端用户的唯一标识符,用于监控和检测滥用 |
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 本次对话的唯一标识符 |
| object | string | 对象类型,固定为 chat.completion |
| created | integer | 创建时间戳 |
| model | string | 使用的模型名称 |
| choices | array | 生成的补全结果列表 |
| choices[].message.content | string | 助手的回复内容 |
| choices[].finish_reason | string | 结束原因:stop(自然结束)、length(达到长度限制)、content_filter(内容过滤) |
| usage | object | token 使用情况统计 |
| usage.prompt_tokens | integer | 输入消息使用的 token 数 |
| usage.completion_tokens | integer | 生成内容使用的 token 数 |
| usage.total_tokens | integer | 总 token 数 |
| usage.prompt_tokens_details | object | 输入 token 详情 |
| usage.prompt_tokens_details.cached_tokens | integer | 缓存命中的输入 token 数(未命中缓存时为 0) |
| usage.completion_tokens_details | object | 输出 token 详情 |
| usage.completion_tokens_details.reasoning_tokens | integer | 推理过程消耗的 token 数(不支持推理的模型为 0) |
POST https://www.moyu.info/v1/responses{
"id": "resp_xxx",
"object": "response",
"created_at": 0,
"model": "MODEL_NAME",
"status": "completed",
"output": [
{
"id": "msg_xxx",
"type": "message",
"role": "assistant",
"status": "completed",
"content": [
{
"type": "output_text",
"text": "你好!我是 AI 助手,可以帮你回答问题、写作、翻译、总结、编程、做计划等。"
}
]
}
],
"usage": {
"input_tokens": 14,
"output_tokens": 86,
"total_tokens": 100,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens_details": {
"reasoning_tokens": 0
}
}
}| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称,如 gpt-4o, gpt-5.4 等 |
| input | string/array | 是 | 输入内容,可以是字符串或消息数组 |
{
"model": "MODEL_NAME",
"input": "你好"
}{
"model": "MODEL_NAME",
"input": [
{"role": "user", "content": "你好"},
{"role": "assistant", "content": "你好!有什么可以帮你的?"},
{"role": "user", "content": "介绍一下你自己"}
]
}| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| temperature | number | 否 | 1 | 采样温度,范围 0-2 |
| top_p | number | 否 | 1 | 核采样参数,范围 0-1 |
| max_output_tokens | integer | 否 | 模型最大值 | 生成的最大 token 数量 |
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| instructions | string | 否 | - | 系统指令,用于设定助手的行为(等同于 system message) |
| stream | boolean | 否 | false | 是否流式输出 |
| previous_response_id | string | 否 | - | 上一次响应的 ID,用于多轮对话上下文衔接 |
| truncation | string | 否 | disabled | 截断策略 |
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| tools | array | 否 | [] | 可用工具列表(函数调用等) |
| tool_choice | object | 否 | - | 工具选择策略 |
| reasoning | object | 否 | - | 推理配置,如 {"effort": "medium"} |
| metadata | object | 否 | {} | 自定义元数据 |
| user | string | 否 | - | 终端用户的唯一标识符 |
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 本次响应的唯一标识符,格式为 resp_xxx |
| object | string | 对象类型,固定为 response |
| created_at | integer | 创建时间戳 |
| model | string | 使用的模型名称 |
| status | string | 响应状态:completed(完成)、failed(失败)、in_progress(进行中) |
| output | array | 输出内容列表 |
| output[].type | string | 输出项类型,如 message |
| output[].role | string | 角色,固定为 assistant |
| output[].content | array | 内容列表 |
| output[].content[].type | string | 内容类型,如 output_text |
| output[].content[].text | string | 助手的回复文本 |
| usage | object | token 使用情况统计 |
| usage.input_tokens | integer | 输入使用的 token 数 |
| usage.output_tokens | integer | 输出使用的 token 数 |
| usage.total_tokens | integer | 总 token 数 |
| usage.input_tokens_details | object | 输入 token 详情 |
| usage.input_tokens_details.cached_tokens | integer | 缓存命中的输入 token 数(未命中缓存时为 0) |
| usage.output_tokens_details | object | 输出 token 详情 |
| usage.output_tokens_details.reasoning_tokens | integer | 推理过程消耗的 token 数(不支持推理的模型为 0) |