接入协议

TopsDyne 同时支持 OpenAI 兼容协议 与 Anthropic 协议，覆盖市面上绝大多数 AI 工具。

OpenAI 兼容协议

完全兼容 OpenAI API 格式，可直接使用 OpenAI 官方 SDK 或任何兼容客户端。

在售模型与型号以控制台模型广场实时展示为准；本文示例中的模型 ID 均为占位 your-model-id，请替换为实际在售模型。

Base URL：https://api.topsdyne.com/v1

鉴权：Authorization: Bearer sk-xxx（你的 API Key）

端点	说明
POST /v1/chat/completions	对话补全（主流）
GET /v1/models	模型列表
POST /v1/videos	视频生成任务提交（平台扩展端点，非 OpenAI 格式；详见 视频生成）
GET /v1/videos/{id}	视频任务查询（平台扩展端点，非 OpenAI 格式）

注：/v1/videos 系列是 TopsDyne 的自有扩展端点——沿用相同的 Base URL 与 Bearer 鉴权，但请求/响应体为平台自定义格式，不属于 OpenAI API 规范。

示例（curl）：

curl https://api.topsdyne.com/v1/chat/completions \
  -H "Authorization: Bearer $TOPSDYNE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Anthropic 协议

Claude Code 等 Anthropic 系工具使用 x-api-key 鉴权，TopsDyne 原生支持。

Base URL：https://api.topsdyne.com（不要带 /v1）

鉴权：x-api-key: sk-xxx（你的 API Key）

端点：

端点	说明
POST /v1/messages	Anthropic Messages API 主端点
POST /anthropic/v1/messages	兼容硬编码 /anthropic/ 前缀的工具

对比与选择

维度	OpenAI 兼容	Anthropic
Base URL	https://api.topsdyne.com/v1	https://api.topsdyne.com
鉴权方式	Authorization: Bearer	x-api-key
适用工具	Codex、Cursor、Cherry Studio、OpenAI SDK	Claude Code 等 Anthropic 协议 CLI 工具
可用模型	全部模型	全部模型（Claude Code 需按教程配置模型映射）

⚠️ 最容易填错的地方：OpenAI 兼容协议带 /v1 后缀，Anthropic 协议不带。填错会返回 401 / 404。

SDK 快速示例

Python（OpenAI SDK）

from openai import OpenAI

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

response = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

Node.js（OpenAI SDK）

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-xxx',
  baseURL: 'https://api.topsdyne.com/v1',
});

const response = await client.chat.completions.create({
  model: 'your-model-id',
  messages: [{ role: 'user', content: '你好' }],
});

下一步

• Token 使用 — 额度说明
• 工具配置 — 工具接入教程