发送 GetAPI.ONE API 请求

准备工作与边界

• 一个保存在 GETAPI_ONE_API_KEY 中的受限 GetAPI.ONE 密钥。
• 一个在当前目录中明确列出预期端点类型的模型。
• 已安装 curl 且允许访问 www.getapi.one HTTPS 的命令行。
• 接受真实请求可能产生用量费用。本示例仅做静态复核，未发送模型请求。

• 创建并加载密钥
• 选择端点兼容模型

1. 选择明确声明的端点

其它协议族使用不同路径与请求体。请以所选模型页显示的端点为准；不要把 Anthropic、Gemini、图像或视频调用强行套用到上面的两个示例。

2. Responses API 示例

只有选择了目录中列出 Responses 端点的模型后才使用此示例。运行前必须替换 YOUR_RESPONSES_MODEL。

curl --fail-with-body https://www.getapi.one/v1/responses \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "Reply with the word ready."
  }'

3. Chat Completions 示例

只有所选目录模型列出 OpenAI Chat 端点时才使用此示例。运行前必须替换 YOUR_CHAT_MODEL。

curl --fail-with-body https://www.getapi.one/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with the word ready."}
    ]
  }'

4. 检查结果

1. 先读取 HTTP 状态。2xx 表示网关接受并完成 HTTP 请求，但客户端仍需检查响应对象中是否存在预期输出。
2. Responses 请求应检查返回的响应状态/output 结构；Chat Completions 应检查 choices 结构。不要把两种协议的响应形态混用。
3. 打开 GetAPI.ONE 请求或使用日志，在可用时核对时间、端点、模型和请求标识。

流式与重试

流式会改变响应传输和事件处理；是否支持取决于所选端点与模型。先完成非流式请求，再根据协议参考与模型页添加流式参数。

• 不要自动重试认证、额度、权限或模型选择错误。
• 重试超时或上游失败前，先判断原请求是否可能已处理，以及操作是否可以安全重复。
• 应用中使用有上限的重试次数与退避，并保留请求标识和时间以便诊断。

错误分支

• 故障排查清单
• 准备求助材料