1. 文本接口
魔芋AI开发文档
  • API快速配置
    • CC-Switch快速配置(推荐)
    • Claude Code 与 Codex 安装配置
    • 智能体集成魔芋Skills
  • 魔芋SDK
    • SDK接口规范文档
    • SDK 完整示例
  • API文档
    • 文本接口
      • Anthropic 文本接口
      • 豆包文本接口
      • Gemini 文本接口
      • 多模态接口
      • OpenAI 文本接口
    • 图片接口
      • Doubao 图片接口
      • Seedream 图生图接口
      • Gemini 图片生成接口
      • GPT-Image-2 图片接口
      • MiniMax-Hailuo 图片接口
      • OpenAI 图片接口
      • Gemini 图生图调用示例
      • 即梦 & 生数异步图片接口
    • 视频接口
      • kling-v3-传入参考视频
      • 豆包(Doubao)视频接口
      • Happy Horse 视频接口
      • 即梦视频接口
      • Kling 视频接口
      • Kling-v3 系列视频接口
      • Seedance 2.0 多图生视频调用示例
      • Sora 视频接口
      • Veo 视频生成 API 接口文档
  • API接口
    • 模型
      • 获取可用模型列表
    • 文本对话
      • OpenAI 对话补全
      • OpenAI Responses
      • Anthropic 消息接口
      • Gemini 内容生成
    • 图片生成
      • 图片编辑
      • 图片生成
    • 视频生成
      • 提交视频生成任务
      • 查询视频生成任务
      • 查询豆包视频任务状态
      • 按令牌获取视频任务列表
    • 素材库
      • 真人素材 API 接口文档(H5 人脸认证)
      • 创建素材 / 批量上传
      • 查询素材列表
      • 查询单个素材
      • 按批次查询素材
      • 更新素材名称
      • 删除素材
      • 获取素材库列表
      • 创建素材库
      • 删除素材库
      • 转移素材库
  • Seedance2文档
    • Seedance 2.0 视频生成接口
    • 按令牌获取视频任务列表
    • 素材库 API 接口文档
  • 数据模型
    • ChatMessage
    • ChatCompletionRequest
    • ChatCompletionResponse
    • OpenAIUsage
    • ResponsesRequest
    • ResponsesResponse
    • AnthropicMessageRequest
    • AnthropicMessageResponse
    • GeminiPart
    • GeminiContent
    • GeminiGenerateContentRequest
    • GeminiGenerateContentResponse
    • ModelListResponse
    • ImageGenerationRequest
    • ImageGenerationResponse
    • SeedanceContentItem
    • SeedanceMetadata
    • VideoGenerationRequest
    • VideoTaskSubmitResponse
    • VideoTaskQueryResponse
    • VideoTaskListResponse
    • VideoTaskListItem
    • VideoAutoUploadRequest
    • VideoAutoUploadSubmitResponse
    • VideoFlatQueryResponse
    • AssetItem
    • CreateAssetRequest
    • CreateAssetResponse
    • ListAssetsRequest
    • ListAssetsResponse
    • GetAssetResponse
    • BatchGetAssetsResponse
    • AssetIdResponse
    • AssetGroupListResponse
    • ErrorResponse
  1. 文本接口

OpenAI 文本接口

OpenAI 对话补全接口文档。

接口地址#

POST https://www.moyu.info/v1/chat/completions

请求示例#

cURL#

其他语言#

响应格式#

{
  "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
    }
  }
}

请求参数#

基础参数#

参数类型必填说明
modelstring是模型名称,如 gpt-4o, gpt-4o-mini, chatgpt-4o-latest 等
messagesarray是对话消息列表,每条消息包含 role 和 content

messages 格式#

[
  {"role": "system", "content": "你是一个助手"},
  {"role": "user", "content": "你好"}
]
支持的 role 值:
system: 系统消息,用于设定助手的行为
user: 用户消息
assistant: 助手的回复

采样参数#

参数类型必填默认值说明
temperaturenumber否1采样温度,范围 0-2。较高的值(如 1.5)使输出更随机,较低的值(如 0.2)使输出更确定
top_pnumber否1核采样参数,范围 0-1。建议只调整 temperature 或 top_p,不要同时调整
ninteger否1为每个输入生成的补全数量
streamboolean否false是否流式输出。true 时,服务器将发送 SSE 事件流

控制参数#

参数类型必填默认值说明
max_tokensinteger否模型最大值生成的最大 token 数量
max_completion_tokensinteger否-补全部分的最大 token 数量
stopstring/array否null停止序列。最多 4 个序列,遇到时 API 将停止生成
presence_penaltynumber否0存在惩罚,范围 -2.0 到 2.0。正值会根据新 token 是否出现在文本中来惩罚它们
frequency_penaltynumber否0频率惩罚,范围 -2.0 到 2.0。正值会根据新 token 在文本中的现有频率来惩罚它们

高级参数#

参数类型必填默认值说明
stream_optionsobject否-流式输出的额外选项,如 include_usage: true
logprobsboolean否false是否返回输出 token 的对数概率
top_logprobsinteger否-每个 token 位置返回的最可能 token 数量,范围 0-20
userstring否-终端用户的唯一标识符,用于监控和检测滥用

响应字段说明#

字段类型说明
idstring本次对话的唯一标识符
objectstring对象类型,固定为 chat.completion
createdinteger创建时间戳
modelstring使用的模型名称
choicesarray生成的补全结果列表
choices[].message.contentstring助手的回复内容
choices[].finish_reasonstring结束原因:stop(自然结束)、length(达到长度限制)、content_filter(内容过滤)
usageobjecttoken 使用情况统计
usage.prompt_tokensinteger输入消息使用的 token 数
usage.completion_tokensinteger生成内容使用的 token 数
usage.total_tokensinteger总 token 数
usage.prompt_tokens_detailsobject输入 token 详情
usage.prompt_tokens_details.cached_tokensinteger缓存命中的输入 token 数(未命中缓存时为 0)
usage.completion_tokens_detailsobject输出 token 详情
usage.completion_tokens_details.reasoning_tokensinteger推理过程消耗的 token 数(不支持推理的模型为 0)

Responses 接口#

OpenAI Responses API 接口文档。

接口地址#

POST https://www.moyu.info/v1/responses

请求示例#

cURL#

其他语言#

响应格式#

{
  "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
    }
  }
}

请求参数#

基础参数#

参数类型必填说明
modelstring是模型名称,如 gpt-4o, gpt-5.4 等
inputstring/array是输入内容,可以是字符串或消息数组

input 格式#

支持两种格式:
字符串格式(简单用法):
{
  "model": "MODEL_NAME",
  "input": "你好"
}
消息数组格式(多轮对话):
{
  "model": "MODEL_NAME",
  "input": [
    {"role": "user", "content": "你好"},
    {"role": "assistant", "content": "你好!有什么可以帮你的?"},
    {"role": "user", "content": "介绍一下你自己"}
  ]
}

采样参数#

参数类型必填默认值说明
temperaturenumber否1采样温度,范围 0-2
top_pnumber否1核采样参数,范围 0-1
max_output_tokensinteger否模型最大值生成的最大 token 数量

控制参数#

参数类型必填默认值说明
instructionsstring否-系统指令,用于设定助手的行为(等同于 system message)
streamboolean否false是否流式输出
previous_response_idstring否-上一次响应的 ID,用于多轮对话上下文衔接
truncationstring否disabled截断策略

高级参数#

参数类型必填默认值说明
toolsarray否[]可用工具列表(函数调用等)
tool_choiceobject否-工具选择策略
reasoningobject否-推理配置,如 {"effort": "medium"}
metadataobject否{}自定义元数据
userstring否-终端用户的唯一标识符

响应字段说明#

字段类型说明
idstring本次响应的唯一标识符,格式为 resp_xxx
objectstring对象类型,固定为 response
created_atinteger创建时间戳
modelstring使用的模型名称
statusstring响应状态:completed(完成)、failed(失败)、in_progress(进行中)
outputarray输出内容列表
output[].typestring输出项类型,如 message
output[].rolestring角色,固定为 assistant
output[].contentarray内容列表
output[].content[].typestring内容类型,如 output_text
output[].content[].textstring助手的回复文本
usageobjecttoken 使用情况统计
usage.input_tokensinteger输入使用的 token 数
usage.output_tokensinteger输出使用的 token 数
usage.total_tokensinteger总 token 数
usage.input_tokens_detailsobject输入 token 详情
usage.input_tokens_details.cached_tokensinteger缓存命中的输入 token 数(未命中缓存时为 0)
usage.output_tokens_detailsobject输出 token 详情
usage.output_tokens_details.reasoning_tokensinteger推理过程消耗的 token 数(不支持推理的模型为 0)
修改于 2026-08-05 01:35:22
上一页
多模态接口
下一页
Doubao 图片接口
Built with