热核算力

GPT API / Messages

用 Messages API 调用 GPT 模型

已有客户端使用 Messages 请求结构时,可通过热核算力的 /v1/messages 接口发送基础文本请求。下面只演示正式站已验收的 gptplus 分组与 gpt-6-luna。

准备密钥和余额

  1. 注册热核算力,在兑换页使用购买的兑换券;兑换券人民币 5 元起。
  2. 在密钥页创建绑定 gptplus 分组的 API Key。
  3. 确认模型列表包含 gpt-6-luna;分组白名单和倍率以当前分组说明及账号内实际设置为准。

正式 API Base URL 为 https://api.codexhot.com/v1。此处的 Messages 请求可选择 GPT 模型,并不表示本站已开放 claude-* 模型。

发送基础文本请求

将 YOUR_API_KEY 替换为自己的密钥。以下 JSON 使用短输入;响应正文中的文本位于 content 数组的 text 块。

macOS / Linux

curl https://api.codexhot.com/v1/messages \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-6-luna","max_tokens":128,"messages":[{"role":"user","content":"只回复 PONG"}]}'

Windows PowerShell

Invoke-RestMethod -Uri 'https://api.codexhot.com/v1/messages' `
  -Method Post `
  -Headers @{ 'x-api-key' = 'YOUR_API_KEY'; 'anthropic-version' = '2023-06-01' } `
  -ContentType 'application/json; charset=utf-8' `
  -Body '{"model":"gpt-6-luna","max_tokens":128,"messages":[{"role":"user","content":"只回复 PONG"}]}'

密钥只应放在本机或服务端的安全配置中,不要写进网页、截图或公开仓库。

读取流式响应

在相同请求体中增加 "stream":true,服务端会返回 SSE 事件。使用 curl -N 可让终端持续显示事件;文本增量在 content_block_delta,结束事件为 message_stop。

curl -N https://api.codexhot.com/v1/messages \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-6-luna","max_tokens":128,"stream":true,"messages":[{"role":"user","content":"只回复 PONG"}]}'

流式和非流式请求均按实际用量计费。生产验证覆盖该分组的基础文本、SSE 完成和扣费;不能据此推断工具调用、图像输入或其他模型已兼容。

排查接入问题

  • 401:确认密钥有效、请求头为 x-api-key,且没有多余空格。
  • 404:核对密钥绑定的分组和模型白名单。此示例使用 gptplus 的 gpt-6-luna。
  • 429:查看响应正文、账号余额、并发和上游限频,避免对相同错误无限重试。

更多状态码见报错排查;如果现有项目使用 OpenAI Chat Completions 请求结构,请看迁移指南,两种协议的请求和响应字段不同。

注册并创建密钥