大唐token 接入文档

常用入口

快速开始

接口地址

大多数工具的 Base URL 只填到 /v1，不要再手动拼 /chat/completions。

创建 API Key

1. 登录控制台。
2. 进入「令牌」页面。
3. 新建令牌，选择合适分组；不确定时先用通用分组测试。
4. 复制密钥，填入客户端。

API Key 就像余额支付密码。不要发到群里、视频里、GitHub 或前端代码里。

常见工具怎么填

文本模型代码示例

curl

curl https://datang.jbbtoken.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-your-jbbtoken-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [{"role": "user", "content": "Say hello in one sentence."}]
  }'

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-jbbtoken-key",
    base_url="https://datang.jbbtoken.cn/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "Write a short title."}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-jbbtoken-key",
  baseURL: "https://datang.jbbtoken.cn/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [{ role: "user", content: "Write a short title." }],
});
console.log(resp.choices[0].message.content);

图片生成模型

大唐token 的生图接口按 OpenAI 兼容协议接入。Base URL 仍然使用 https://datang.jbbtoken.cn/v1，图片生成接口是 POST /v1/images/generations，图生图/参考图编辑接口是 POST /v1/images/edits。

如果客户端把 Host 和 Path 分开配置，Host 填 https://datang.jbbtoken.cn，Path 填 /v1；如果 Base URL 已填到 https://datang.jbbtoken.cn/v1，API Path 不要再重复填 /v1。

文生图参数

图生图参数

尺寸建议

不要只在 prompt 里写“16:9”。建议同时传 size，让服务端按参数做最终比例兜底。

生图代码示例

文生图 curl

curl -X POST https://datang.jbbtoken.cn/v1/images/generations \
  -H "Authorization: Bearer sk-your-jbbtoken-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A realistic sunset cityscape, wet street reflections, cinematic lighting, clean composition",
    "n": 1,
    "size": "16:9",
    "quality": "high",
    "response_format": "url"
  }'

图生图 / 图片编辑 curl

curl -X POST https://datang.jbbtoken.cn/v1/images/edits \
  -H "Authorization: Bearer sk-your-jbbtoken-key" \
  -F "model=gpt-image-2" \
  -F "prompt=保留人物主体，改成电影海报风格，背景换成夜晚城市霓虹" \
  -F "size=16:9" \
  -F "quality=high" \
  -F "image=@./reference.png"

返回 base64

curl -X POST https://datang.jbbtoken.cn/v1/images/generations \
  -H "Authorization: Bearer sk-your-jbbtoken-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean product poster with premium commercial lighting",
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

Python OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-jbbtoken-key",
    base_url="https://datang.jbbtoken.cn/v1",
)

resp = client.images.generate(
    model="gpt-image-2",
    prompt="A cute orange cat playing with yarn",
    size="1024x1024",
    extra_body={
        "quality": "high",
        "response_format": "url",
    },
)

print(resp.data[0].url)

URL 返回适合网页预览和下载；b64_json 适合自动化工作流。签名图片 URL 可能有有效期，业务侧需要长期保存时请自行下载归档。

常见报错

本站新服务器 IP 是 43.103.52.230。如果你本机 hosts 写死了旧 IP，需要改掉或删除旧记录。

计费说明

大唐token 使用余额制，按模型实际价格扣费。文本模型通常按输入和输出 token 计算，生图模型通常按次、张数、质量或上游固定价格计算。最终价格以控制台价格页、分组价格和用量日志为准。

生图请求建议先用小尺寸、单张、低并发测试。确认模型、比例和提示词稳定后，再切换到高质量、大尺寸或批量生成。

你可以在控制台查看余额、调用日志和扣费明细。这样用户能知道每次请求大概花了多少钱。

安全提醒

• 不要把 API Key 写进前端网页代码。
• 不要在视频、截图、GitHub 里展示真实 Key。
• 如果怀疑 Key 泄露，马上删除旧 Key 并重新创建。
• 生产环境建议给不同项目创建不同 Key，方便排查和停用。