跳转到内容
中文

Claude Haiku 5.5 API

POST Base URL: https://api.hiapi.ai /v1/chat/completions

该模型使用兼容 OpenAI 的 Chat Completions 接口。同一个 HiAPI API Key 可调用账户分组内已开放模型;切换到图片、视频或音频模型时,需要改用 /v1/tasks 及对应请求结构。

模型概览

模型名称Claude Haiku 5.5
提供方Anthropic
上下文 / 最大输出1M / 128K tokens
接口POST /v1/chat/completions
推理low / medium / high / xhigh · 默认 medium
价格输入/输出 $0.15 / $0.75;缓存读取 $0.015;缓存写入 $0.1875(5 分钟)或 $0.30(1 小时),每 1M Token,输入不超过 100K

通过 HiAPI 兼容 OpenAI 的 Chat Completions API 调用 Anthropic Claude Haiku 5.5,适合快速文本与编程工作流。

生产建议

请求契约
  • 使用 model=claude-haiku-5-5 调用 POST /v1/chat/completions。
  • 使用 reasoning_effort=low、medium、high 或 xhigh,默认 medium。
  • 在 Playground 中填写非空 system prompt 后,可选择 5m 或 1h。将 cache_control={type:"ephemeral"} 放在 system 文本 content block 内;5 分钟缓存省略 ttl,1 小时缓存设置 ttl:"1h"。关闭缓存时应完全省略 cache_control。不要将它放在请求顶层。
  • 此契约使用兼容 OpenAI 的 Chat Completions 原生字段。图片输入、工具调用、JSON mode 和 Responses API 尚未单独验收,暂不宣传。

适用场景

快速 Agent 工作

适合兼顾可调推理强度与响应速度的文本、编程和短流程任务。

messagesreasoning_effort

请求参数

model string 必填

固定填写这个公共模型 ID。

示例 claude-haiku-5-5 可选值: claude-haiku-5-5
messages array 必填

按顺序传入 system、user 和 assistant 消息。

stream boolean 可选

设为 true 返回 SSE。

默认 false
reasoning_effort enum 可选

原生 Chat Completions 请求可使用 low、medium、high 或 xhigh。

默认 medium 可选值: lowmediumhighxhigh
max_tokens integer 可选

可见输出与思考共同使用的最大 Token 数。

API 接入示例

调用示例

流式响应

读取内容增量直到 [DONE],并在返回时检查 usage。

请求体
{
  "model": "claude-haiku-5-5",
  "messages": [
    {
      "role": "system",
      "content": [
        {
          "type": "text",
          "text": "你是一个简洁的迁移助手。",
          "cache_control": {
            "type": "ephemeral",
            "ttl": "5m"
          }
        }
      ]
    },
    {
      "role": "user",
      "content": "把这份迁移计划总结为三个风险和三个应对措施。"
    }
  ],
  "stream": true,
  "reasoning_effort": "medium",
  "max_tokens": 4096
}

响应结构

从 choices[0].message.content 读取可见文本;流式调用拼接增量直到 [DONE]。计费以 usage 为准。

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "model": "claude-haiku-5-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "先划分可回滚的迁移边界。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 48,
    "total_tokens": 80
  }
}
  1. 从 choices[0].message.content 读取可见文本。
  2. 流式调用拼接内容与思考增量,直到 [DONE]。
  3. 读取输入与输出用量;思考计入输出。

常见问题

Claude Haiku 5.5 是什么模型?

这是 Anthropic 的 Claude Haiku 5.5。已核对的模型规格为 1M Token 上下文和 128K 最大输出;本页展示 Chat Completions 请求格式。

应该使用哪个端点和模型 ID?

使用 POST /v1/chat/completions,并将 model 设置为 claude-haiku-5-5。

支持哪些推理强度?

使用 reasoning_effort=low、medium、high 或 xhigh,默认 medium。该字段属于原生 Chat Completions 请求。

支持图片、工具调用、JSON mode 或 Responses 吗?

当前公共契约只开放文本 Chat Completions。上述能力尚未单独验收,暂不宣传。

如何使用提示词缓存?

在 Playground 中选择缓存时长前,请先填写非空 system prompt。将 cache_control 放在 system 文本 block 内:{"type":"ephemeral"} 使用默认的 5 分钟缓存,{"type":"ephemeral","ttl":"1h"} 请求 1 小时缓存。不需要显式缓存控制时省略 cache_control;请求顶层的 cache_control 不受支持。

Token 如何计费?

输入不超过 100K Token 时,每 1M Token 价格为:输入 $0.15、输出 $0.75、缓存读取 $0.015、5 分钟缓存写入 $0.1875、1 小时缓存写入 $0.30。超过 100K 时,分别为 $0.75、$3.75、$0.075、$0.9375 和 $1.50。API 响应返回 Token 用量;HiAPI 使用日志展示最终结算金额。 查看实时价格。

下一步