DEVELOPER QUICKSTART

开发者最小请求

只验证环境变量、OpenAI 兼容接口根地址（Base URL）和模型 ID。第一次使用、购买或创建密钥请先看“快速跑通”。

准备

把密钥和地址放进环境变量

以下命令只在当前终端会话生效，不会把完整 API 密钥写入源码。

macOS / Linux / WSL

export OPENAI_API_KEY="sk-your-api-key"
export OPENAI_BASE_URL="https://1a1api.top/v1"

Windows PowerShell

$env:OPENAI_API_KEY="sk-your-api-key"
$env:OPENAI_BASE_URL="https://1a1api.top/v1"

示例模型仅用于跑通测试。实际可用模型取决于当前 API 密钥所属分组，请以控制台模型列表或 /v1/models 返回结果为准。

Responses API：新项目优先

使用完整接口路径 /v1/responses，先要求模型只返回一个固定短词，便于判断链路是否成功。

macOS / Linux / WSL · Responses API

curl "$OPENAI_BASE_URL/responses" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "Reply with exactly: ok"
  }'

Windows PowerShell · Responses API

$body = @{
  model = "gpt-5.6-sol"
  input = "Reply with exactly: ok"
} | ConvertTo-Json

Invoke-RestMethod `
  -Method Post `
  -Uri "$env:OPENAI_BASE_URL/responses" `
  -Headers @{ Authorization = "Bearer $env:OPENAI_API_KEY" } `
  -ContentType "application/json" `
  -Body $body

兼容

Chat Completions：旧项目兼容

只有现有代码依赖 Chat Completions 时才需要这段；不要把完整接口路径再填进 Base URL 字段。Windows 可沿用上方 Invoke-RestMethod 结构，把 URI 改为 /chat/completions 并把请求体换成 messages。

macOS / Linux / WSL · Chat Completions

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {"role": "user", "content": "Reply with exactly: ok"}
    ]
  }'

验证

怎样算成功

响应中能读到 ok，并且 1A1API 调用日志出现对应模型、状态、耗时和费用，才算链路跑通。

401环境变量未生效、密钥复制不完整，或自定义 HTTP 客户端没有发送 Authorization: Bearer ...。

403当前 API 密钥所属分组没有该模型权限，或余额、订阅条件不满足。

404接口根地址与接口路径重复，例如误写成 /v1/v1/responses。

429 / 超时先降低并发和请求长度，再到调用日志确认请求是否到达。

如果你还没有 API 密钥，或不知道该选哪个客户端，请回到新手：快速跑通。SDK 代码示例请看 OpenAI SDK 接入。