kimi-k3

调用示例

正式 Base URL 为 https://www.unicompapi.com/v1；设置 UNICOMP_BASE_URL 与 UNICOMP_API_KEY 后替换素材与 Base64 占位内容。新请求使用 REQUEST_KEY，响应 X-Unicomp-Request-Id 保存为 REQUEST_ID；两者用于查询同一原单。

POST /v1/chat/completions

# 仅用于新请求；未知结果时查询原单，不重新执行本段
# 需要 Python 3；保存打印的 REQUEST_KEY
REQUEST_KEY="$(python3 -c 'import uuid; print(uuid.uuid4())')"
[ -n "$REQUEST_KEY" ] || exit 1 # UUID生成失败时停止
printf 'REQUEST_KEY=%s\n' "$REQUEST_KEY"
curl "$UNICOMP_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $UNICOMP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  --data '{
  "model": "kimi-k3",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "请描述这张图片"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,<完整图片Base64>"
          }
        }
      ]
    }
  ],
  "max_completion_tokens": 4096,
  "stream": false
}'

准备本人参考素材

素材API目前仅开放个人账户的个人Key。上传不创建生成任务。此型号可用上传格式与配置如下；参考输入的角色和数量按生成方式或对应调用组合填写，不能把接口可上传格式当作模型输入能力。使用本人同账号Key上传原文件，返回data.id后填入messages[].content[].video_asset.assetId，不能使用他人素材ID。

MP4；原文件≤71.52MiB；请求头X-Image-Profile: kimi-native-video。总量与轮次按对应调用组合约束。

curl "$UNICOMP_BASE_URL/assets" \
  -H "Authorization: Bearer $UNICOMP_API_KEY" \
  -H "Content-Type: video/mp4" \
  -H "X-Image-Profile: kimi-native-video" \
  -H "X-Model-Id: kimi-k3" \
  -H "X-File-Name: reference.mp4" \
  --data-binary @reference.mp4

{
  "data": {
    "id": "<本人素材ID>",
    "object": "asset",
    "name": "reference.mp4",
    "kind": "video",
    "mime_type": "video/mp4",
    "bytes": "<真实文件字节数>",
    "sha256": "<真实SHA256>",
    "created_at": "<上传时间>",
    "url": "/v1/assets/<本人素材ID>/content"
  }
}

按上方对应格式设置X-Image-Profile；原二进制大小按该profile及模型限制，Content-Type与实际内容必须匹配；X-File-Name为URL编码文件名。模型输入还需符合本页尺寸、格式、数量和总大小限制。上传时同时设置X-Model-Id: kimi-k3，视频引用字段与fps见对应组合。 素材列表GET /v1/assets，本人素材内容GET/HEAD /v1/assets/<素材ID>/content。

字段与限制

• max_tokens 与 max_completion_tokens 二选一，均为1–1048576的整数；不能同时传入。max_completion_tokens限制完成Token总量，含返回用量中的思考Token；若限制不足以形成正文，请核查原请求结果，不自动重试。两者均未指定时平台采用本型号默认预算。
• messages为文字对话；支持stream:true时返回SSE，须收到完整finish、usage及[DONE]才确认结束。中断或未知结果应核查原请求，不能自动重新POST。
• 该型号固定参数：top_p=0.95、n=1、frequency_penalty=0、presence_penalty=0；可省略，不是可调能力。stop最多5项，每项最多32个UTF-8字节。K2.6 thinking.disabled时temperature=0.6，其余固定1；2.7-code/K3固定1。具体thinking组合仍以已启用组合为准。
• 当前上下文 1048576 Token；输入与输出须符合本型号Token容量；请求大小限制见容量说明。响应最多32MiB，最长等待30分钟。连接中断时查询原请求，不重复提交。
• 本型号默认回复预算 4096 Token；这是平台默认值，不是模型的最大输出能力。
• 图片请求允许完整历史最多 200 条消息，每次最多 16 张PNG/JPEG dataURI图片；原图≤20MiB、边长≤8192、像素≤16777216。总输入≤20MiB；不接受远程URL。普通图片示例不混用tools；图片与工具组合仅使用本页明确列出的组合示例。
• 当前图片输入已开放SSE；须完整消费结束用量及[DONE]。
• 续轮须保留原assistant正文及存在时完整reasoning_content，并使用原Key；使用原图片素材，保持总量符合限制。
• 图片输入先按估算预留，按原请求的实际Token用量结算；估算不是模型输入上限。若返回402 VISION_BALANCE_REQUIRED，原回复和用量已保留，补足余额后使用原Key向 /v1/requests/<原请求号>/settle 发送无请求体、无查询参数的POST，取回原结果，不重新生成。请求号读取 X-Unicomp-Request-Id。

流式文字

选择已开放的纯文字组合，再添加stream:true，图片输入不使用此示例；SDK关闭自动重试，逐个消费SSE。以下为格式示意，不是实际调用结果。

{
  "model": "kimi-k3",
  "messages": [
    {
      "role": "user",
      "content": "你好，请用一句话介绍自己。"
    }
  ],
  "max_completion_tokens": 4096,
  "stream": true
}

data: {"choices":[{"index":0,"delta":{"content":"你好"},"finish_reason":null}]}

data: {"choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{"prompt_tokens":8,"completion_tokens":2,"total_tokens":10}}

data: [DONE]

请求组合示例

示例随当前型号配置生成；请替换素材与历史消息占位内容。选择相应组合展开查看，不要混用不同组合参数。

{
  "model": "kimi-k3",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "video_asset",
          "video_asset": {
            "assetId": "<本人已上传MP4素材ID>",
            "source": "upload"
          }
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,<本人完整图片Base64>"
          }
        },
        {
          "type": "text",
          "text": "比较视频与图片，请用JSON描述主要内容。"
        }
      ]
    }
  ],
  "stream": false,
  "max_completion_tokens": 512,
  "reasoning_effort": "low",
  "response_format": {
    "type": "json_object"
  }
}

{
  "model": "kimi-k3",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "video_asset",
          "video_asset": {
            "assetId": "<本人已上传MP4素材ID>",
            "source": "upload"
          }
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,<本人完整图片Base64>"
          }
        },
        {
          "type": "text",
          "text": "比较视频与图片，请用JSON描述主要内容。"
        }
      ]
    }
  ],
  "stream": false,
  "max_completion_tokens": 512,
  "reasoning_effort": "low",
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "scene",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "scene": {
            "type": "string"
          }
        },
        "required": [
          "scene"
        ],
        "additionalProperties": false
      }
    }
  }
}

支持的能力

使用下方调用示例选择参数组合；请求结果和费用可在用量记录中查看。

调用参数和限制见本页示例。

当前价格

接口金额使用整数微元：1元 = 1,000,000微元。按报价和实际用量结算。

响应与结果

非流式响应choices[].message.content和usage；文字stream:true返回text/event-stream delta、finish与[DONE]。OCR只支持非流式。

保存Idempotency-Key和X-Unicomp-Request-Id。使用请求号查询状态与费用，客户端禁自动重试未知请求；401核Key，400核字段，402核余额，409核幂等或报价变化，503检查型号或服务状态。