SDK 接入

可用 OpenAI 兼容 SDK 调用它实际支持的文本接口。API 原点加 /v1 作为 SDK base_url；原点本身不带版本。模型仍使用当前 Key 目录中的公开 ID。

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GLOOP_API_KEY"],
    base_url=os.environ["GLOOP_API_BASE"].rstrip("/") + "/v1",
    max_retries=0,
)
response = client.chat.completions.create(
    model=os.environ["GLOOP_MODEL"],
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

JavaScript

import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: process.env.GLOOP_API_KEY,
  baseURL: process.env.GLOOP_API_BASE.replace(/\/$/, '') + '/v1',
  maxRetries: 0,
});
const response = await client.chat.completions.create({
  model: process.env.GLOOP_MODEL,
  messages: [{ role: 'user', content: '你好' }],
});
console.log(response.choices[0].message.content);

示例禁用自动重试，避免网络中断时未经确认重新发起收费请求。是否启用重试应按具体接口的幂等契约决定，不能假定所有 SDK 调用都有平台去重能力。

平台专用接口

图像报价、持久任务、工具与文件接口使用普通 HTTP 客户端。不要调用不存在的 SDK 方法，如 client.image_tasks.create。端点页面提供 cURL、requests 与 fetch 示例，并区分 JSON、multipart、SSE 和二进制。

音频响应保存为字节；图片上传让客户端生成 multipart boundary；流式响应逐事件解析。自定义 API 字段只在对应端点明确支持时传入，兼容 SDK 不意味着全部 OpenAI 功能可用。先读流式指南与异步恢复。