Responses 接口

Responses 是 OpenAI 较新的接口格式，用 input 代替 messages，用 output 返回结果。AI 星图提供 POST /v1/responses，OpenAI SDK 的 client.responses.create() 可以直接使用。Codex CLI 也是通过这个接口接入的。

基础调用复制锚点链接

示例中的 your-model-id 请替换为模型广场中的模型 ID（也可以调用 GET /v1/models 查看）。

# Responses 格式：路径 /v1/responses，用 input 代替 messages
curl -sS https://ai.myaiexp.com/v1/responses \
  -H "Authorization: Bearer $MYAIEXP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "input": "Introduce yourself in one sentence.",
    "max_output_tokens": 600
  }'

要点：

• Base URL 同样是 https://ai.myaiexp.com/v1，Key 用 Authorization: Bearer <Key>。
• max_output_tokens 对应 Chat Completions 里的 max_tokens。推理模型的思考也计入输出，请留足空间。
• input 可以是字符串，也可以是和 messages 类似的消息数组；系统提示词可以用 instructions 传。

返回结构复制锚点链接

回答在 output[].content[].text（SDK 里用 resp.output_text 直接取），用量在 usage.input_tokens / usage.output_tokens。结构示意：

{
  "id": "resp_...",
  "object": "response",
  "model": "your-model-id",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "status": "completed",
      "content": [
        { "type": "output_text", "text": "..." }
      ]
    }
  ],
  "usage": { "input_tokens": 0, "output_tokens": 0, "total_tokens": 0 }
}

推理模型的 output 里可能在 message 之前多出 type: "reasoning" 的条目，读取时请按 type 筛选，或直接用 output_text。

流式复制锚点链接

加上 "stream": true，服务端以 SSE 返回事件，增量文字在 response.output_text.delta 事件的 delta 字段，最后以 response.completed 事件结束：

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"Hi", ...}

event: response.completed
data: {"type":"response.completed","response":{"status":"completed", ...}}

用 SDK 时传 stream=True / stream: true 后遍历事件即可。

完整字段见 API 参考。