Messages 请求与流式响应
使用 curl 调用 藕片 API 的 Messages 接口,发送最小请求并读取 SSE 流式响应。
准备请求
以下示例使用 macOS / Linux 的 shell;Windows 可在 WSL 中执行。先在密钥页面获取 Key,再在终端中设置:
export SERVICE_API_KEY='YOUR_API_KEY'请避免将真实密钥保存在共享脚本或终端录屏中。示例模型为 claude-sonnet-5-5,可用模型和价格以公开价格页及实际账号权限为准。
发送最小请求
curl --fail-with-body --max-time 120 'https://eopt.ai/v1/messages' \
-H "x-api-key: $SERVICE_API_KEY" \
-H 'anthropic-version: 2023-06-01' \
-H 'content-type: application/json' \
--data '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"messages": [{"role": "user", "content": "只回复:连接成功"}]
}'成功时返回 Messages JSON。读取 content 中的文本块;stop_reason 表示停止原因,usage 是本次报告的用量。不要把整个 content 数组当成纯文本,工具调用与思考块需要按各自类型处理。
这里的 120 秒是示例客户端等待上限,不是服务时限承诺。超时后的实际结果应结合使用日志确认。
读取流式响应
在同一请求中设置 "stream": true,并让 curl 不缓冲输出:
curl --no-buffer --fail-with-body --max-time 120 'https://eopt.ai/v1/messages' \
-H "x-api-key: $SERVICE_API_KEY" \
-H 'anthropic-version: 2023-06-01' \
-H 'content-type: application/json' \
--data '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"stream": true,
"messages": [{"role": "user", "content": "只回复:连接成功"}]
}'响应使用 SSE 的 event: / data: 帧。解析器需要处理分块、空行和多次读取,不能假定一次网络读取就是一条完整事件。文本通常来自 content_block_delta;完整结束以 message_stop 为准,并处理流内的 error 事件。
HTTP 200 只说明流已开始。连接断开或出现错误事件时,按中途失败说明处理。
后续接入
此页演示 Messages 接口;其他协议和参数的兼容范围应通过对应客户端验证。