1. Chat对话
MoYunAPI
  • MoYun API
    • 快速开始
    • 充值与价格说明
    • 接入Agent指南
      • IDE与终端AI(IDE & AI CLI)
        • VS Code配置指南
          • VS Code安装与配置指南
        • JetBrains系列配置指南
          • JetBrains系列IDE下载与安装
        • 国产桌面IDE配置指南
          • IDE 配接 Cline 使用指南
          • CodeBuddy CN IDE 配置指南
          • Trae CN IDE 配置指南
        • AI CLI配置指南
          • Kimi Code CLI
          • MiMo Code CLI 配置指南
          • OpenCode CLI 配置指南
          • Cursor CLI
          • Grok CLI
          • ChatGPT(Codex CLI)配置指南
          • Claude Code CLI配置指南
      • 桌面级Agent(Desktop Agent)
        • WorkBuddy 配置指南
        • QoderWork
        • ZCode配置指南
        • Claude Code Desktop
        • ChatGPT(Codex Desktop)配置指南
        • Grok Desktop配置指南
        • MiniMax Code配置指南
        • Cursor Desktop
        • OpenCode Desktop配置指南
      • 工作流(WorkFlows)
        • n8n 配置使用 MoYunAPI 教程
        • Dify 配置使用 MoYunAPI 教程
      • 自动化工具(Automation)
        • CC Switch 安装与配置教程
      • 开源项目(Open Source)
        • OpenClaw下载与API配接(Windows)
        • OpenClaw下载与API配接(Linux)
    • 提示词指南
      • Seedream 4.0-5.0 提示词指南
    • API 文档
      • Models模型
        • 获取模型列表
      • Chat对话
        • 对话补全 (Chat Completions) — 核心接口
          POST
      • Completions文本
        • 文本补全 (Completions)
      • Embeddings向量
        • 文本嵌入 (Embeddings)
      • Images图片
        • Doubao-Seedream 图生图(单图参考)
        • Doubao-Seedream 多图融合生图
        • Doubao-Seedream 文生图
        • Doubao-Seedream 组图生成
        • MiniMax-Image 文生图
        • MiniMax-Image 图生图(人物主体参考)
        • GLM-Image 文生图
        • GLM-CogView 文生图
        • Qwen-Image 文生图
        • Qwen-Image 3.0 图生图/图像编辑
      • Audio音频
        • MiMo-TTS语音系列
        • 语音合成 (Text-to-Speech)
        • 语音识别 (Audio Transcription)
      • Realtime语音对话
        • 实时语音对话 (WebSocket)
      • Moderations内容安全审核
        • 内容安全审核 (Moderations)
      • Rerank文档重排序
        • 文档重排序 (Rerank)
      • Video视频
        • 生成视频 (Video Generation, 异步任务)
        • 查询视频任务状态
    • Images图片
    • 数据模型
      • Error
      • ErrorResponse
      • Usage
      • StyleObject
      • ChatMessage
      • SubjectReference
      • Tool
      • FunctionCall
  1. Chat对话

对话补全 (Chat Completions) — 核心接口

POST
https://moyunapi.com/v1/chat/completions
Chat
基于对话历史生成模型回复,是 MoYun API 最核心的接口,完全兼容 OpenAI Chat Completions 格式。支持普通对话、流式输出(SSE)、工具/函数调用、结构化输出(JSON Schema)、多模态输入(图像)与音频输出、推理模型等。

流式响应(SSE)说明#

设置 stream=true 后,响应 Content-Type 为 text/event-stream,以多行 data: {JSON}\n\n 形式返回增量内容,每个 chunk 的 choices[].delta 携带增量文本/工具调用片段;最后发送 data: [DONE] 标识结束。客户端需按行解析并累加 delta。建议设置 stream_options.include_usage=true 以在末尾获取用量。

工具调用流程#

1.
请求携带 tools(函数定义)与 tool_choice(策略);
2.
模型返回 choices[].message.tool_calls,finish_reason=tool_calls;
3.
客户端执行函数,把结果以 {role:'tool', tool_call_id, content} 追加进 messages;
4.
再次请求,模型基于工具结果给出最终回复。

通用错误#

返回 400(参数错误)、401(认证失败)、429(限流/额度不足)、500(服务异常)。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Header 参数

Body 参数application/json必填

示例

返回响应

🟢200
application/json
成功。非流式返回 JSON;流式(stream=true)返回 text/event-stream。
Body

🟠400
🟠401
🟠429
🔴500
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://moyunapi.com/v1/chat/completions' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-5.6-luna",
    "messages": [
        {
            "role": "system",
            "content": "你是一位简洁的科普助手,回答控制在三句话以内。"
        },
        {
            "role": "user",
            "content": "请用三句话介绍量子计算。"
        }
    ],
    "temperature": 0.7,
    "max_tokens": 500,
    "stream": false
}'
响应示例响应示例
200 - 普通对话响应
{
    "id": "chatcmpl-final8820000",
    "object": "chat.completion",
    "created": 1785914182,
    "model": "deepseek-v4-flash",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "量子计算利用量子比特(qubit)的叠加和纠缠特性,能以指数级速度处理某些经典计算机难以解决的问题。其核心原理是让量子比特同时处于多种状态,并通过对纠缠态的操控实现并行计算。目前它在密码破解、药物模拟和优化问题等领域展现出巨大潜力。",
                "reasoning_content": "我们要求用三句话介绍量子计算。需要简洁,每句话都重要。第一句定义,第二句原理,第三句应用或意义。注意控制在三句话以内。"
            },
            "logprobs": null,
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 104,
        "completion_tokens": 100,
        "total_tokens": 204,
        "prompt_tokens_details": {
            "cached_tokens": 0
        },
        "completion_tokens_details": {
            "reasoning_tokens": 37
        },
        "prompt_cache_hit_tokens": 0,
        "prompt_cache_miss_tokens": 104
    },
    "system_fingerprint": "fp_afj73b594c_prod0820_fp8_kvinche_20260702"
}
上一页
获取模型列表
下一页
文本补全 (Completions)
Built with