开发者接入

OpenAI SDK 接入 1A1API

新项目优先使用 Responses API；已有项目可以继续使用 Chat Completions。JavaScript 和 Python 示例都从环境变量读取 API 密钥。

适用版本：当前 OpenAI JavaScript / Python SDK 最后验证：2026-07-20

先看最小请求模型与接口查看错误码排查

填法

baseURL 填到 /v1

baseURLhttps://1a1api.top/v1

API 密钥保存到 OPENAI_API_KEY 环境变量，不要写进源码。

模型 IDgpt-5.6-sol 仅作测试示例；实际可用模型以控制台模型列表为准。

接口根地址不要把 /v1/responses 或 /v1/chat/completions 写进 baseURL。

先安装 OpenAI SDK

# JavaScript / TypeScript
npm install openai

# Python
python -m pip install openai

macOS / Linux：设置环境变量

export OPENAI_API_KEY="sk-your-api-key"

Windows PowerShell：当前会话

$env:OPENAI_API_KEY="sk-your-api-key"

不要把真实 API 密钥提交到 Git、写进浏览器前端代码或放进公开截图。生产环境请使用部署平台的密钥管理功能。

JavaScript 最小示例

Responses API 测试

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "https://1a1api.top/v1",
});

const response = await client.responses.create({
  model: "gpt-5.6-sol",
  input: "Reply with exactly: ok",
});

console.log(response.output_text);

Python 最小示例

Responses API 测试

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url="https://1a1api.top/v1",
)

response = client.responses.create(
    model="gpt-5.6-sol",
    input="Reply with exactly: ok",
)

print(response.output_text)

兼容旧项目

已有 Chat Completions 项目可以继续使用

如果现有代码依赖 messages 和 choices 返回结构，不必为了测试而重写；保持同一个 baseURL 即可。

JavaScript Chat Completions

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "https://1a1api.top/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5.6-sol",
  messages: [{ role: "user", content: "Reply with exactly: ok" }],
});

console.log(response.choices[0]?.message?.content);

常见错法

SDK 接入先排这几项

404 /v1/v1baseURL 被重复加了 /v1，或把完整接口路径填到了 Base URL。

401 UnauthorizedSDK 未读取到 API 密钥、密钥复制不完整，或自定义 HTTP 客户端没有发送 Authorization: Bearer ... 请求头。使用官方 SDK 时，请先确认环境变量已经生效。

522 / 524长任务建议开启 stream: true，并拆分输入。

自定义 HTTP 请求只有自己拼 HTTP 请求时，才需要手动检查 Bearer 请求头；官方 SDK 会从配置或环境变量组装认证信息。