模型 API 接入文档
Claude Haiku 5.5 API 接入文档
通过 Rivya Public API v1 调用 Claude Haiku 5.5，包含模型 ID claude-haiku-5-5-chat、输入类型、参数、Files API 规则、积分和响应示例。
API 可调用文本输入可用对话
API 模型 ID
claude-haiku-5-5-chat
输入类型
text
Files API
最小请求不需要
基础积分
基础费率（积分/百万 token）：输入 12，输出 60 任务最终消耗向上取整到整数积分。
能力类型
对话
可用状态
Chat API：非 streaming + SSE streaming
计费方式
TOKEN_BASED
提示词上限
20000 字符
请求字段
Chat 请求一次发送一条 message。历史上下文由 Rivya session 保存，不接受 raw messages 数组。
| Key | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | claude-haiku-5-5-chat | 使用 claude-haiku-5-5-chat 作为 API 模型 ID。 |
| session_id | string | 否 | - | 可选 API 创建的对话 session ID。省略时会创建新 session。 |
| message | string | 是 | - | 下一条用户消息。Chat API 的历史上下文来自服务端 session，不接受 raw messages 数组。 |
| attachments | array | 否 | - | 可选图片 file_id，必须来自 Files API。这里不接受外部附件 URL。 |
| enable_web_search | boolean | 否 | false | 仅在所选 Chat 模型支持联网搜索时生效。 |
| reasoning_effort | string | 否 | default | 可选推理强度：default、minimal、low、medium、high 或 xhigh，按模型支持情况生效。 |
| client_request_id | string | 否 | - | 可选客户端请求 ID，便于你在自己的系统中追踪请求。 |
| thought_mode | string | 否 | default | 可选 thought_mode：default、on 或 off。对于支持思考功能的模型，on 表示开启，off 表示关闭，default 使用模型的默认行为。其他模型会忽略此字段。 |
| tool_slug | string | 否 | - | 可选，填写已有 Rivya 聊天工具的 slug。Rivya 会将该工具的指令加入本轮对话。如果会话已指定工具，请省略此字段或使用相同的 slug。 |
模型参数
这个 Chat 模型使用上方通用 Chat API 字段。联网搜索、图片 file 附件、思考内容和 reasoning 支持情况会体现在 readiness 数据里。
最小请求
{
"model": "claude-haiku-5-5-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}创建响应
Chat 接口会直接返回本轮 assistant message、token usage 和最终积分结算。
{
"id": "chatcmpl_assistant_message_id",
"object": "chat.completion",
"session_id": "chat_session_claude_haiku_5_5_chat",
"model": "claude-haiku-5-5-chat",
"created_at": "2026-05-11T00:00:00.000Z",
"message": {
"id": "assistant_message_id",
"role": "assistant",
"content": "1. 选择产品图片。2. 撰写推广帖文。3. 安排发布并查看效果。",
"created_at": "2026-05-11T00:00:00.000Z"
},
"usage": {
"input_tokens": 1200,
"output_tokens": 320,
"total_tokens": 1520
},
"credits": {
"reserved": 0,
"final": 0,
"settlement_status": "PENDING"
}
}常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。