API 快速开始

信息

页面与服务规则以当前 控制台 为准。

先确认这三项

1. 在 API 控制台「令牌」页面创建 API Key，并确认该密钥所属分组。
2. 从 模型广场 或 /v1/models 取得当前可用的完整模型 ID。
3. Base URL 固定为 https://llmapi.cttai.art/v1（OpenAI 兼容）。

以下示例使用本机环境变量 CTTAI_API_KEY，不要把真实 Key 写进代码仓库。

查询密钥可见的模型

curl https://llmapi.cttai.art/v1/models \
  -H "Authorization: Bearer $CTTAI_API_KEY"

模型列表表示当前可见信息；具体协议、模态与实时可用性以模型说明为准。

Chat Completions 最小请求

将 YOUR_AVAILABLE_MODEL 替换为支持该协议的完整模型 ID。

curl https://llmapi.cttai.art/v1/chat/completions \
  -H "Authorization: Bearer $CTTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_AVAILABLE_MODEL",
    "messages": [{"role": "user", "content": "请只回复 OK"}]
  }'

该请求可能产生少量费用。成功后可在控制台「使用日志」确认模型与用量。

SDK 示例

Node.js（OpenAI SDK）

npm install openai

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.CTTAI_API_KEY,
  baseURL: 'https://llmapi.cttai.art/v1',
});

const result = await client.chat.completions.create({
  model: process.env.CTTAI_MODEL,
  messages: [{role: 'user', content: '请只回复 OK'}],
});
console.log(result.choices[0].message.content);

Python（OpenAI SDK）

python -m pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['CTTAI_API_KEY'],
    base_url='https://llmapi.cttai.art/v1',
)
result = client.chat.completions.create(
    model=os.environ['CTTAI_MODEL'],
    messages=[{'role': 'user', 'content': '请只回复 OK'}],
)
print(result.choices[0].message.content)

流式输出

请求体加 "stream": true 即可获得 SSE 流式响应：

data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"你好"},"index":0}]}
data: [DONE]

上线前检查

• 使用独立 Key 与预算，确认分组权限。
• 处理连接、读取与业务超时；长任务先查询状态，避免重复提交。
• 对临时 429 / 5xx 使用有上限的退避重试；认证或参数错误不要盲目重试。
• 记录时间、模型、request id / task id 与错误正文，日志中不保存完整 Key。
• 实际费用以控制台使用日志与计费规则为准。

其它模型

• 判断型模型（非对话协议）：见 Jev 模型接入