OpenAI Compatible API

来点Token API 文档

使用统一入口调用聊天、Responses、模型列表和图片生成接口。倍率为 1,实际可用模型以控制台和 /v1/models 返回为准。

Base URL https://givemesometoken.xyz/v1
Authorization Authorization: Bearer sk-你的API密钥
/v1

一个 Base URL

Chatbox、Cherry Studio、LobeChat 等 OpenAI 兼容客户端直接填 https://givemesometoken.xyz/v1

1x

倍率为 1

不虚标,不隐藏加价。账单和用量以控制台记录为准。

IMG

支持图片接口

gpt-image-2/v1/images/generations,不是普通聊天接口。

快速开始

先在控制台创建 API Key,然后把它放到请求头里。下面示例使用 gpt-5.4,你也可以换成 gpt-5.5

curl https://givemesometoken.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手。"},
      {"role": "user", "content": "用一句话介绍来点Token。"}
    ]
  }'
Base URL 只填到 /v1。大多数客户端会自动追加 /chat/completions/responses 或图片接口路径。

接口列表

用途 方法和路径 说明
模型列表 GET /v1/models 查看当前 API Key 可用模型。模型受账号、分组、额度和上游状态影响。
聊天补全 POST /v1/chat/completions OpenAI Chat Completions 兼容格式,适合 Chatbox、Cherry Studio、LobeChat。
Responses POST /v1/responses 适合支持 Responses API 的 SDK 或客户端。
图片生成 POST /v1/images/generations 图片模型使用,例如 gpt-image-2
图片编辑 POST /v1/images/edits 图片编辑接口,客户端和模型必须支持图片编辑能力。
Gemini 原生 /v1beta 给 Gemini SDK/CLI 使用。普通 OpenAI 兼容客户端不要填这个。

聊天调用

Chat Completions 是兼容性最好的入口。支持普通请求和流式输出。

curl -N https://givemesometoken.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "stream": true,
    "messages": [
      {"role": "user", "content": "写一个三行的产品介绍。"}
    ]
  }'

JavaScript

const response = await fetch("https://givemesometoken.xyz/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-你的API密钥",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gpt-5.4",
    messages: [{ role: "user", content: "你好,来点Token。" }]
  })
});

const data = await response.json();
console.log(data.choices[0].message.content);

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的API密钥",
    base_url="https://givemesometoken.xyz/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {"role": "user", "content": "用中文解释什么是 API 中转。"}
    ],
)

print(resp.choices[0].message.content)

Responses API

如果你的 SDK 或客户端支持 Responses API,可以直接使用 /v1/responses

curl https://givemesometoken.xyz/v1/responses \
  -H "Authorization: Bearer sk-你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "给我一个适合开发者的 API Key 安全建议。"
  }'

图片生成

图片模型不要走聊天接口。使用 /v1/images/generations,模型示例为 gpt-image-2

curl https://givemesometoken.xyz/v1/images/generations \
  -H "Authorization: Bearer sk-你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A minimal product hero image for a transparent AI API relay, clean Apple-style, warm light.",
    "size": "1024x1024"
  }'

图片编辑

图片编辑使用 multipart form-data,把原图作为 image 字段上传。

curl https://givemesometoken.xyz/v1/images/edits \
  -H "Authorization: Bearer sk-你的API密钥" \
  -F "model=gpt-image-2" \
  -F "prompt=Add a tiny green token in the center." \
  -F "image=@input.png"
图片接口只对支持 OpenAI 图片能力的分组生效。如果 API Key 所在分组不是 OpenAI 平台,图片接口可能返回不支持或 404。

客户端配置

客户端 推荐配置 模型
Chatbox Provider 选择 OpenAI API 或 OpenAI Compatible,Base URL 填 https://givemesometoken.xyz/v1 gpt-5.4gpt-5.5
Cherry Studio 选择 OpenAI 兼容服务,自定义 API 地址填 https://givemesometoken.xyz/v1 手动添加控制台可用模型。
LobeChat 使用 OpenAI Compatible Provider,API Key 填来点Token 的 sk-... /v1/models 返回为准。
Gemini SDK/CLI 如果使用 Gemini 原生协议,入口使用 https://givemesometoken.xyz/v1beta 使用 Gemini 对应模型。

常见问题

Base URL 需要加 /chat 吗?

不需要。Chatbox 这类客户端只填 https://givemesometoken.xyz/v1,客户端会自动追加接口路径。

为什么模型不可用?

模型可用性取决于 API Key、分组、账户额度和上游状态。先用 GET /v1/models 检查当前 Key 能看到哪些模型。

为什么图片生成失败?

图片生成要使用 /v1/images/generations 和图片模型,例如 gpt-image-2。普通聊天客户端不一定支持图片接口。

返回 401 怎么办?

检查请求头是否包含 Authorization: Bearer sk-你的API密钥,并确认 API Key 没有被删除、禁用或复制错。

返回额度或余额错误怎么办?

进入控制台查看余额、套餐、分组和用量记录。余额不足或 Key 未绑定可用分组时,请先处理账户配置。