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. 文本接口

豆包文本接口

豆包(Doubao)文本生成接口文档。

接口地址#

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

请求示例#

注意事项#

⚠️ Windows 环境下 curl 中文编码问题
在 Windows 系统上使用 curl 的 -d 参数直接传递中文时,curl 会使用系统码页(GBK)而非 UTF-8 编码,导致中文被识别为乱码。
推荐解决方案:
1.
使用 --data-binary @文件 方式发送请求
2.
或使用 Python/JavaScript/Go 等编程语言调用

cURL(推荐方式)#

中文请求示例:

其他语言#


图片识别请求示例(Seed 模型)#

doubao-seed-2-0-pro-260215 支持多模态输入(文本、图片),以下是图片识别的请求示例。

Chat Completions 接口#

Responses 接口#

其他语言(图片识别)#

图片识别响应示例#

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "这张图展现了壮美开阔的自然户外场景:前景是宽阔平静的深蓝色湖面,一艘亮橙色的皮划艇漂在水面上;中景是沿着湖岸生长的茂密针叶林,林间笼着薄雾;远景是连绵巍峨、覆着积雪的高大山脉,衬着清朗的淡蓝色天空。",
        "reasoning_content": "用户现在问这张图主要展示什么...",
        "role": "assistant"
      }
    }
  ],
  "created": 1782099072,
  "id": "021782099058603f74590442eab0123ecdd9df6ba66d3a91c6b19",
  "model": "doubao-seed-2-0-pro-260215",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 442,
    "prompt_tokens": 1353,
    "total_tokens": 1795,
    "prompt_tokens_details": {"cached_tokens": 0},
    "completion_tokens_details": {"reasoning_tokens": 313}
  }
}

图片输入格式说明#

接口content type图片字段格式
/v1/chat/completionsimage_url{"type": "image_url", "image_url": {"url": "图片URL"}}
/v1/responsesinput_image{"type": "input_image", "image_url": "图片URL"}
支持的图片格式:JPEG、PNG、GIF、WebP 等常见图片格式,支持 URL 链接方式传入。

视频识别请求示例(Seed 模型)#

doubao-seed-2-0-pro-260215 支持视频输入,支持两种传入方式:URL 链接和 Base64 编码。

方式一:传入视频 URL#

Chat Completions 接口#

Responses 接口#

方式二:传入 Base64 编码视频#

适用于本地视频文件,先将视频编码为 Base64 后传入。

Chat Completions 接口#

Responses 接口#

其他语言(视频识别 - URL 方式)#

Base64 方式:

视频识别响应示例#

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "这是一段AI生成的延时风格视频,展现了伦敦经典地标场景:画面主体是伊丽莎白塔(大本钟)矗立在泰晤士河畔,时段为晨昏时分,天空覆着有层次感的云层。下方威斯敏斯特桥上车流处于快速运动的延时状态,双向车道车辆川流不息,其中标志性的红色双层巴士格外醒目。",
        "reasoning_content": "用户现在需要描述这个AI生成的视频内容...",
        "role": "assistant"
      }
    }
  ],
  "created": 1782100464,
  "id": "021782100435589f74590442eab0123ecdd9df6ba66d3a9981cae",
  "model": "doubao-seed-2-0-pro-260215",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 605,
    "prompt_tokens": 6390,
    "total_tokens": 6995,
    "prompt_tokens_details": {"cached_tokens": 0},
    "completion_tokens_details": {"reasoning_tokens": 421}
  }
}

视频输入格式说明#

接口content type视频字段格式
/v1/chat/completionsvideo_url{"type": "video_url", "video_url": {"url": "视频URL或Base64"}}
/v1/responsesinput_video{"type": "input_video", "video_url": "视频URL或Base64", "fps": 1}
传入方式对比:
方式优点缺点适用场景
URL 链接请求体小、传输快需要视频可公开访问视频已托管在 CDN/OSS
Base64 编码无需公网可访问的 URL请求体大(约为原文件 1.33 倍)本地视频文件
参数说明:
fps(仅 Responses 接口):视频采样帧率,表示每秒提取的帧数,默认为 1

响应格式#

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "logprobs": null,
      "message": {
        "content": "Artificial intelligence is the simulation of human intelligence by machines, particularly computer systems. It encompasses learning, reasoning, problem-solving, perception, and language understanding. AI is revolutionizing industries from healthcare to transportation with its growing capabilities.",
        "reasoning_content": "The user is asking for a concise explanation of AI in three sentences...",
        "role": "assistant"
      }
    }
  ],
  "created": 1770776426,
  "id": "021770776423638e3a31c433292ba20cb5fbeea5c08b17662cb9b",
  "model": "doubao-seed-1-8-251228",
  "service_tier": "default",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 116,
    "prompt_tokens": 60,
    "total_tokens": 176,
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 76
    }
  }
}

请求参数#

基础参数#

参数类型必填说明
modelstring是模型名称,如 doubao-seed-1-8-251228
messagesarray是对话消息列表

messages 数组#

每个消息对象包含以下字段:
字段类型必填说明
rolestring是角色:user(用户) 或 assistant(助手)
contentstring是消息内容

可选参数#

参数类型必填默认值说明
temperaturefloat否1.0控制输出的随机性,范围 0-2
top_pfloat否1.0核采样参数,范围 0-1
max_tokensinteger否-生成的最大token数量
streamboolean否false是否流式返回
presence_penaltyfloat否0存在惩罚,范围 -2.0 到 2.0
frequency_penaltyfloat否0频率惩罚,范围 -2.0 到 2.0

响应字段说明#

字段类型说明
idstring请求的唯一标识符
objectstring对象类型,固定为 "chat.completion"
createdinteger创建时间戳
modelstring使用的模型名称
choicesarray生成的回复列表
choices[].message.rolestring回复角色,为 "assistant"
choices[].message.contentstring生成的文本内容
choices[].message.reasoning_contentstring推理过程内容(如果模型支持)
choices[].finish_reasonstring结束原因:stop(正常结束)、length(达到长度限制)
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)

Windows 环境编码问题说明#

问题原因#

Windows 系统上 curl 的 -d 参数使用系统码页(GBK/CP936)编码中文,而非 UTF-8。这会导致:
中文输入被模型识别为乱码
模型返回 "看起来你的输入出现了乱码" 等提示
英文输入正常工作

验证方法#

使用 --trace 查看实际发送的字节:
如果看到中文字节是 GBK 编码(如 c4 e3 ba c3)而非 UTF-8(e4 bd a0 e5 a5 bd),则确认是编码问题。

解决方案#

方案一:使用文件发送(推荐)#

方案二:切换控制台编码#

chcp 65001
然后再执行 curl 命令。

方案三:使用编程语言(推荐)#

使用 Python、JavaScript、Go 等编程语言调用 API,这些语言默认使用 UTF-8 编码,不会出现编码问题。

支持的模型#

模型名称说明多模态支持语言
doubao-seed-1-8-251228豆包推理模型文本英文(中文有编码问题)
doubao-seed-2-0-pro-260215豆包多模态推理模型文本、图片、视频输入中文、英文
注意:目前在魔芋AI平台上,doubao-seed-1-8-251228 模型对中文输入存在字符编码识别问题,建议使用英文输入或等待平台修复。

常见问题#

Q: 为什么中文输入被识别为乱码?#

A: 这是 Windows 环境下 curl 的已知问题。Windows curl 使用系统码页(GBK)而非 UTF-8 编码命令行参数。请使用 --data-binary @文件 方式或编程语言调用。

Q: 如何确保中文正确传输?#

A: 推荐使用以下方式之一:
1.
使用 printf 创建 UTF-8 文件,然后用 --data-binary @文件 发送
2.
使用 Python、JavaScript、Go 等编程语言调用
3.
在 Windows CMD 中执行 chcp 65001 切换到 UTF-8 编码

Q: 英文调用正常吗?#

A: 是的,英文调用完全正常,编码问题仅影响中文等非 ASCII 字符。

修改于 2026-08-05 01:35:07
上一页
Anthropic 文本接口
下一页
Gemini 文本接口
Built with