三条测试流式curl命令(OpenAI / Anthropic,分别对应 /chat、/responses、/message 流式接口)

本文提供了OpenAI和Anthropic三家主流AI接口的流式curl调用示例。涵盖OpenAI的/chat和/new Responses接口,以及Anthropic的/message接口。详细展示了SSE流式请求的关键参数、头部设置及JSON体结构,并补充了调试技巧如-N参数和无缓冲输出,帮助开发者快速实现流式响应对接。

作者:zhuge··预计阅读 7 分钟·4 阅读·0 评论
三条测试流式curl命令(OpenAI / Anthropic,分别对应 /chat、/responses、/message 流式接口)

三条流式curl命令(OpenAI / Anthropic,分别对应 /chat、/responses、/message 流式接口)

1. OpenAI /v1/chat/completions(对应路径 /chat,SSE流式)

curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "stream": true,
    "messages": [
      {"role": "user", "content": "简单介绍人工智能"}
    ]
  }'

2. Anthropic /v1/messages(对应路径 /message,Claude SSE流式)

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: sk-ant-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-haiku-20240307",
    "stream": true,
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "简单介绍人工智能"}
    ]
  }'

3. OpenAI 全新 Responses 接口 /v1/responses(对应路径 /responses,流式)

OpenAI 官方新 Responses 流式接口,区别于传统 chat 接口:

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "stream": true,
    "input": "简单介绍人工智能"
  }'

补充说明

  1. 流式关键参数:"stream": true 开启 SSE 长流输出,终端会逐行返回 data: {...} 分片数据;
  2. 密钥替换:sk-xxxsk-ant-xxx 替换为你自己的 API Key;
  3. 接口路径对应关系:
    • /chat → OpenAI /v1/chat/completions
    • /responses → OpenAI 新接口 /v1/responses
    • /message → Anthropic Claude /v1/messages
  4. 流式数据结束标识:OpenAI 末尾返回 data: [DONE],Anthropic 返回 data: {"type":"message_stop"}

增强版(添加超时、自动打印完整流日志)

如需调试,可增加参数 -N 关闭curl缓冲,实时输出分片:

# 示例改造(以chat接口为例)
curl -N --connect-timeout 10 https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "stream": true,
    "messages": [{"role": "user", "content": "简单介绍人工智能"}]
  }'

-N 参数强制无缓冲流式打印,调试SSE接口必备。

相关文章

评论

加载中...