创建响应 · Moss API

请求参数

字段类型必填说明

model: string必填

模型 ID。推荐使用稳定 model ID；需要复现固定版本时，可填写 snapshot model ID。

input: array必填

输入消息数组；当前必须且只能包含一条 role=user 消息。

input[].role: string必填

当前固定为 user。

input[].content: array必填

内容数组；必须同时包含至少一个非空 input_text，以及 1～5 个 input_image 或 1 个 input_video。图片与视频不能混合输入。

input[].content[].type: string必填

内容类型。

input_text.text: string必填

图片或视频理解指令，必须为非空字符串。

input_image.image_url: string条件必填

可由服务端访问的图片 URL；与同一内容项的 file_id 二选一。单图最大 30 MB；支持 PNG、JPG、JPEG、WebP、BMP、GIF、TIFF。

input_image.file_id: string条件必填

已上传图片的文件 ID；与同一内容项的 image_url 二选一。单图最大 30 MB；支持 PNG、JPG、JPEG、WebP、BMP、GIF、TIFF。

input_video.video_url: string条件必填

可由服务端访问的视频 URL；与同一内容项的 file_id 二选一。单视频最大 200 MB，当前不限制视频时长；支持 MP4、M4V、AVI、MOV、WebM、MKV。

input_video.file_id: string条件必填

已上传视频的文件 ID；与同一内容项的 video_url 二选一。单视频最大 200 MB，当前不限制视频时长；支持 MP4、M4V、AVI、MOV、WebM、MKV。

max_output_tokens: integer可选

最大输出 Token 数，范围为 1～8192。

返回值

接口返回 Responses API 对象。模型生成的文本位于 output[].content[].text；通过 status 判断输出是否完整。

字段类型说明

status: string

响应状态，当前为 completed 或 incomplete。

incomplete_details.reason: string | null

输出不完整的原因；达到输出上限时为 max_output_tokens。

output: array

输出项列表。

output[].content: array

输出内容列表。

output[].content[].type: string

当前文本结果固定为 output_text。

output[].content[].text: string

模型生成的文本结果。

usage.input_tokens: integer

本次请求使用的输入 Token 数。

usage.output_tokens: integer

本次请求生成的输出 Token 数。

usage.total_tokens: integer

输入与输出 Token 总数。

响应还会包含 ID、对象类型、时间和模型等通用元数据，完整结构见右侧响应示例。客户端应忽略未使用的附加字段；usage 仅表示本次请求的 Token 用量。

错误码

HTTP	error.code	触发条件	处理建议
400	`missing_required_field`	缺少文本指令或缺少媒体内容	确保 `input[].content` 同时包含非空 `input_text` 和有效媒体。
400	`media_count_exceeded`	图片超过 5 张，或视频超过 1 个	将单次请求控制为 1～5 张图片，或 1 个视频。
400	`mixed_media_not_supported`	同一请求同时传入图片和视频	图片理解和视频理解分开请求。
400	`invalid_media_source`	同一媒体项同时传 URL 和 `file_id`，或两者都未传	每个媒体内容项只填写对应 URL 字段或 `file_id`。
400	`unsupported_media_format`	上传或引用的媒体格式不支持	使用文档列出的图片或视频格式，并确认文件大小在限制内。

下一步

上传文件

上传图片或视频并获取可复用的 file_id。

请求限制

查看公开 API 的稳定输入限制。

请求示例

curl -X POST "https://api.mosi.cn/v1/responses" \
  -H "Authorization: Bearer $MOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "moss-vl-1.0",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "请描述图片中的主要内容。"
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/image.jpg"
        }
      ]
    }
  ],
  "max_output_tokens": 1024
}'

import os
import requests

response = requests.post(
        "https://api.mosi.cn/v1/responses",
        headers={
        "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
        "Content-Type": "application/json",
        },
        json={
            "model": "moss-vl-1.0",
            "input": [
                {
                    "role": "user",
                    "content": [
                        {
                            "type": "input_text",
                            "text": "请描述图片中的主要内容。",
                        },
                        {
                            "type": "input_image",
                            "image_url": "https://example.com/image.jpg",
                        },
                    ],
                },
            ],
            "max_output_tokens": 1024,
        },
)

response.raise_for_status()
print(response.json())

const response = await fetch("https://api.mosi.cn/v1/responses", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.MOSS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "moss-vl-1.0",
    "input": [
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "请描述图片中的主要内容。"
          },
          {
            "type": "input_image",
            "image_url": "https://example.com/image.jpg"
          }
        ]
      }
    ],
    "max_output_tokens": 1024
  }),
})

if (!response.ok) throw new Error(`HTTP ${response.status}`)
console.log(await response.json())

curl -X POST "https://api.mosi.cn/v1/responses" \
  -H "Authorization: Bearer $MOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "moss-vl-1.0",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "请比较两张图片的异同。"
        },
        {
          "type": "input_image",
          "file_id": "<image_file_id_1>"
        },
        {
          "type": "input_image",
          "file_id": "<image_file_id_2>"
        }
      ]
    }
  ],
  "max_output_tokens": 1024
}'

import os
import requests

response = requests.post(
        "https://api.mosi.cn/v1/responses",
        headers={
        "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
        "Content-Type": "application/json",
        },
        json={
            "model": "moss-vl-1.0",
            "input": [
                {
                    "role": "user",
                    "content": [
                        {
                            "type": "input_text",
                            "text": "请比较两张图片的异同。",
                        },
                        {
                            "type": "input_image",
                            "file_id": "<image_file_id_1>",
                        },
                        {
                            "type": "input_image",
                            "file_id": "<image_file_id_2>",
                        },
                    ],
                },
            ],
            "max_output_tokens": 1024,
        },
)

response.raise_for_status()
print(response.json())

const response = await fetch("https://api.mosi.cn/v1/responses", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.MOSS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "moss-vl-1.0",
    "input": [
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "请比较两张图片的异同。"
          },
          {
            "type": "input_image",
            "file_id": "<image_file_id_1>"
          },
          {
            "type": "input_image",
            "file_id": "<image_file_id_2>"
          }
        ]
      }
    ],
    "max_output_tokens": 1024
  }),
})

if (!response.ok) throw new Error(`HTTP ${response.status}`)
console.log(await response.json())

curl -X POST "https://api.mosi.cn/v1/responses" \
  -H "Authorization: Bearer $MOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "moss-vl-1.0",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "请按时间顺序总结视频中的事件。"
        },
        {
          "type": "input_video",
          "video_url": "https://example.com/video.mp4"
        }
      ]
    }
  ],
  "max_output_tokens": 1024
}'

import os
import requests

response = requests.post(
        "https://api.mosi.cn/v1/responses",
        headers={
        "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
        "Content-Type": "application/json",
        },
        json={
            "model": "moss-vl-1.0",
            "input": [
                {
                    "role": "user",
                    "content": [
                        {
                            "type": "input_text",
                            "text": "请按时间顺序总结视频中的事件。",
                        },
                        {
                            "type": "input_video",
                            "video_url": "https://example.com/video.mp4",
                        },
                    ],
                },
            ],
            "max_output_tokens": 1024,
        },
)

response.raise_for_status()
print(response.json())

const response = await fetch("https://api.mosi.cn/v1/responses", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.MOSS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "moss-vl-1.0",
    "input": [
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "请按时间顺序总结视频中的事件。"
          },
          {
            "type": "input_video",
            "video_url": "https://example.com/video.mp4"
          }
        ]
      }
    ],
    "max_output_tokens": 1024
  }),
})

if (!response.ok) throw new Error(`HTTP ${response.status}`)
console.log(await response.json())

响应示例

{
  "id": "resp_task_abc123",
  "object": "response",
  "created_at": 1710000000,
  "status": "completed",
  "completed_at": 1710000001,
  "error": null,
  "incomplete_details": null,
  "model": "moss-vl-1.0",
  "output": [
    {
      "id": "msg_task_abc123",
      "type": "message",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "图片中有四颗坚果。"
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 8743,
    "output_tokens": 94,
    "total_tokens": 8837
  }
}