Skip to content

Codex API 第一次请求 ​

先用一个最小请求确认网络、鉴权和响应解析都正常,再接入业务逻辑。具体 endpoint 和模型名称以 API 控制台 的当前文档为准。

用环境变量保存密钥 ​

export CLAWSOCKET_API_KEY="your-api-key"

不要把密钥写进前端代码、Git 仓库或客户端日志。

用 curl 验证连接 ​

下面展示请求结构,endpoint 和字段请以控制台文档为准:

curl https://api.clawsocket.com/v1/responses -H "Authorization: Bearer $CLAWSOCKET_API_KEY" -H "Content-Type: application/json" -d '{"model":"codex","input":"用一句话解释这段代码"}'

在服务端调用 ​

js
const response = await fetch('https://api.clawsocket.com/v1/responses', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.CLAWSOCKET_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ model: 'codex', input: '用一句话解释这段代码' })
})
if (!response.ok) throw new Error(`API request failed: ${response.status}`)
const data = await response.json()
console.log(data)

上线前请补充超时、重试、响应 schema 校验和错误分类,详见 生产环境 API 清单。

专注 Codex 使用方法与 API 工程实践