API 文档

IT小哥 API 完全兼容 OpenAI API 协议。如果你已经用过 openai-python / openai-node 等 SDK，把 base_url 改一行即可切过来。

3 步上手：

注册 / 登录后，进入 "我的 API Key" 创建一把 sk-* 密钥 · 新用户注册即赠 15 万 tokens
用完后充值余额（美元单位，1 USD = 500,000 quota，按 token 扣费）
把 Base URL 改成 https://api.itxiaoge.com/v1，开始调用

💡 本站接入参数速查：

Base URL	`https://api.itxiaoge.com/v1`
API Key	从我的 API Key 创建，`sk-itxg-*` 格式
计费单位	按 token 实时扣费，1 USD = 500,000 quota
兼容协议	OpenAI Chat Completions / Embeddings / Images 全兼容
支持模型	GPT-4o / GPT-4-turbo / Claude 3.5 Sonnet / Claude Opus / Gemini 1.5 Pro / ...
查余额	在控制台首页顶部"API Key 余额"卡片实时查看

1 分钟示例

# 把 sk-xxx 替换为你自己的 key
curl "https://api.itxiaoge.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-haiku-20240307",
    "messages": [{"role":"user","content":"你好"}]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxxxx",
    base_url="https://api.itxiaoge.com/v1",
)

resp = client.chat.completions.create(
    model="claude-3-haiku-20240307",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxxxxxxxxxxx",
  baseURL: "https://api.itxiaoge.com/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-3-haiku-20240307",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

认证

每次请求通过 Authorization: Bearer <sk-xxx> 头传入你的 API Key。

Key 在用户中心 → 我的 API Key 创建、启用、禁用、删除；完整 Key 只在创建时展示一次，请及时保存。

Base URL

所有 OpenAI 兼容端点都在 /v1 下：

https://api.itxiaoge.com/v1

Chat Completions 最常用

POST /v1/chat/completions — 和 OpenAI 完全一致。支持 stream:true 流式输出。

字段	类型	说明
`model`	string	模型名，见 Models
`messages`	array	对话历史，`{role, content}`
`stream`	bool	是否流式返回，默认 `false`
`max_tokens`	int	最多输出多少 token
`temperature`	float	0–2，默认 1
`tools` / `tool_choice`	object	函数调用，同 OpenAI 语义

Embeddings

POST /v1/embeddings — 文本向量化。

curl "https://api.itxiaoge.com/v1/embeddings" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "你好，世界"
  }'

Images

POST /v1/images/generations — 文本生成图片。

curl "https://api.itxiaoge.com/v1/images/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "a cute cat",
    "size": "1024x1024"
  }'

可用模型

GET /v1/models — 返回当前上游可调用的全部模型。

常见模型（具体可用列表以 /v1/models 实时返回为准）：

Claude 系列：claude-3-haiku-20240307 · claude-3-5-sonnet-20241022 · claude-3-5-haiku-20241022 · claude-sonnet-4-20250514 · claude-3-7-sonnet-20250219-thinking
OpenAI 系列：gpt-4o · gpt-4o-mini · gpt-5 · gpt-5-codex
Gemini 系列：gemini-1.5-pro · gemini-2.0-flash

流式响应

请求体加 "stream": true，响应按 SSE（text/event-stream）逐块返回，每块是一个 JSON：

data: {"choices":[{"delta":{"content":"Hello"}}]}
data: {"choices":[{"delta":{"content":" world"}}]}
data: [DONE]

openai-python / openai-node SDK 自动处理。curl 需要加 -N 禁用 buffer。

计费与额度

内部额度单位：quota，1 USD = 500,000 quota（与上游 new-api 对齐）
按 token 计费：cost = prompt × ratio + completion × ratio × completion_ratio
每个模型的 ratio 跟 new-api 同步（每小时自动刷新）
余额不足调用返回 402 insufficient_quota

查看每次调用的扣费：用户中心 → 我的 API Key → 📊 日志

错误码

HTTP	code	含义
401	`invalid_auth`	没带 Authorization 头或 key 不存在
401	`invalid_key_prefix`	key 必须以 `sk-` 开头
402	`insufficient_quota`	余额不足，请充值
403	`key_disabled`	该 key 已被禁用
502	`upstream_error`	上游通道出错，请稍后重试
503	`-`	暂无可用上游通道

FAQ

Q：原有代码怎么迁移？

A：只改两行 — api_key 换成 sk-itxiaoge-*、base_url 换成 https://api.itxiaoge.com/v1。

Q：余额会过期吗？

A：不会。充值后永久有效。

Q：能限制单 Key 可用的模型吗？

A：暂不支持，计划下个版本加模型白名单功能。

Q：支持流式？函数调用？图片 vision？

A：都支持，格式与 OpenAI 完全一致。