接入文档 · TRNapi

快速开始

整个接入只需三步:注册充值 → 生成 API 令牌 → 替换 base_url。无需信用卡,注册即送体验额度。

基础地址(Base URL):https://api.trnapi.com/v1 —— 与 OpenAI 路径结构一致,支持 /chat/completions、/models、/embeddings 等。

获取密钥

登录控制台 → 「令牌」→ 新建令牌,可设置额度上限、分组与过期时间。令牌形如 sk-xxxxxxxx,请妥善保管。

端点说明

能力	路径	方法
对话补全	`/v1/chat/completions`	POST
模型列表	`/v1/models`	GET
向量嵌入	`/v1/embeddings`	POST

cURL 示例

# 对话补全
curl https://api.trnapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-•••••" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [{"role":"user","content":"你好"}]
  }'

Python / Node SDK

直接复用官方 OpenAI SDK,只改 base_url 与 api_key:

# Python
from openai import OpenAI
client = OpenAI(base_url="https://api.trnapi.com/v1", api_key="sk-•••••")
r = client.chat.completions.create(model="gpt-5.3-codex",
messages=[{"role":"user","content":"hi"}])

// Node
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.trnapi.com/v1", apiKey: "sk-•••••" });
const r = await client.chat.completions.create({
model: "gemini-3-pro", messages: [{ role: "user", content: "hi" }] });

图像生成

图像走 /v1/images/generations(OpenAI 同步格式,直接返回图片 URL)。可售模型:gpt-image-2(GPT Image 2)、gpt-image-nano(Nano Banana Pro)。

# 文生图(同步返回 url)
curl https://api.trnapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-•••••" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-nano","prompt":"a glass serum bottle on marble, studio photo","n":1}'
# → { "data": [ { "url": "https://.../xxx.png" } ] }

图生图 / 改图:在请求体加 image(图片 URL 或 base64)即可。图像为异步出图,平台已自动轮询并同步返回成品 URL,单张约 20–40 秒,请将客户端超时设为 ≥120s。

兼容客户端接入

任何支持「自定义 OpenAI 接口」的客户端都能直接接入(Cherry Studio、NextChat、LobeChat、Open WebUI、沉浸式翻译、各类 IDE 插件等)。只需在其设置里填:

配置项	填写值
API 地址 / Base URL	`https://api.trnapi.com/v1`
API Key	`sk-（你的 TRNapi 令牌）`
模型名	`claude-opus-4-8` / `gpt-5.4` / `gemini-3-pro` …

Codex CLI

OpenAI Codex CLI 走 /v1/responses 协议,已支持。编辑 ~/.codex/config.toml:

# ~/.codex/config.toml
model = "gpt-5.3-codex"
model_provider = "TRNapi"

[model_providers.TRNapi]
name = "TRNapi"
base_url = "https://api.trnapi.com/v1"
wire_api = "responses"
env_key = "TRNAPI_KEY"

# 设置令牌并运行
export TRNAPI_KEY=sk-•••••
codex

Claude Code

Claude Code 走 Anthropic 原生 /v1/messages 协议。当前可直接用 OpenAI 兼容方式调用 Claude(在任意兼容客户端 / SDK 里把 model 设为 claude-opus-4-8 等,见上文)。原生 ANTHROPIC_BASE_URL 直连方式正在开通,如需请提交工单。

模型与倍率

模型分官方直连(稳定)与高速线路(低价)两档来源,统一接口调用。完整列表与实时倍率见模型中转页或调用 /v1/models。

状态码与错误

错误以标准 HTTP 状态码 + JSON 错误体返回,结构与 OpenAI 一致:

状态码	含义	处理建议
`401`	密钥无效 / 缺失	检查 `Authorization` 头
`402`	余额不足	前往控制台充值
`429`	触发限速 / 并发上限	退避重试或提升分组限额
`5xx`	渠道波动	自动重试;或切换分组回落官方直连

限速与并发

限速按令牌与分组分别配置,可在控制台为不同业务设定独立 RPM 与并发上限。高速线路通过负载均衡提供更高并发;对稳定性敏感的高并发场景建议走官方直连分组。

建议在客户端对 429 / 5xx 做指数退避重试,并优先使用「分组路由」实现高速线路波动自动回落官方直连。

常见问题

和直接用官方有什么区别?

统一一个端点接入所有模型,高速线路价格可低至官方 1/5;同时提供国内可达、聚合计费与令牌管控,无需自备海外支付。

高速线路稳定吗?

高速线路按多渠道冗余设计,智能调度 + 自动故障转移 + 负载均衡;对稳定性敏感的生产业务建议选用官方直连来源。

支持流式 / 函数调用 / 多模态吗?

支持。与 OpenAI 协议一致,stream、tools、图片输入等按各模型能力透传。

计费如何结算?

充值进余额,按 token 用量 × 模型倍率实时扣费,控制台可查每一笔用量日志。详见定价页。

五分钟接入指南