快速开始

本页帮助你完成第一次 DDTokens API 调用。DDTokens 兼容 OpenAI Chat Completions 协议，所以大多数 OpenAI SDK 项目只需要替换 API Key 和 base_url。

前置条件

开始前，确认你已经准备好：

• 一个 DDTokens 账号。
• 一个可用的 API Key。还没有创建时，先阅读创建 API Key。
• 一个可以运行命令的终端。

配置环境变量

在终端里设置 API Key 和接口地址：

export DDDT_API_KEY="sk-your-key-here"
export DDDT_BASE_URL="https://apiddt.com/v1"

不要把 API Key 写入代码仓库。生产环境建议使用 CI/CD Secret、环境变量或密钥管理系统注入。

使用 cURL 调用

运行下面的命令发送第一条消息：

curl "$DDDT_BASE_URL/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DDDT_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "Hello!"
      }
    ]
  }'

成功时，你会收到一个 JSON 响应，其中包含 choices 和 usage 字段。usage 字段可用于核对 Token 消耗。

使用 TypeScript

安装 OpenAI SDK：

npm install openai

创建 quickstart.ts：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.DDDT_API_KEY,
  baseURL: process.env.DDDT_BASE_URL ?? "https://apiddt.com/v1",
});

async function main() {
  const response = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "Hello!" }],
  });

  console.log(response.choices[0]?.message?.content);
}

main();

运行：

npx tsx quickstart.ts

使用 Python

安装 OpenAI SDK：

pip install openai

创建 quickstart.py：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DDDT_API_KEY"],
    base_url=os.environ.get("DDDT_BASE_URL", "https://apiddt.com/v1"),
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

运行：

python3 quickstart.py

使用 Go

安装 OpenAI 兼容的 Go SDK：

go get github.com/sashabaranov/go-openai

创建 main.go：

package main

import (
	"context"
	"fmt"
	"os"

	openai "github.com/sashabaranov/go-openai"
)

func main() {
	config := openai.DefaultConfig(os.Getenv("DDDT_API_KEY"))
	config.BaseURL = "https://apiddt.com/v1"

	client := openai.NewClientWithConfig(config)
	response, err := client.CreateChatCompletion(
		context.Background(),
		openai.ChatCompletionRequest{
			Model: "gpt-4o-mini",
			Messages: []openai.ChatCompletionMessage{
				{Role: openai.ChatMessageRoleUser, Content: "Hello!"},
			},
		},
	)
	if err != nil {
		panic(err)
	}

	fmt.Println(response.Choices[0].Message.Content)
}

运行：

go run main.go

下一步

• 查看模型价格，选择合适的模型。
• 阅读速率限制，为生产环境配置重试和限流。
• 打开客户端接入指南，把 DDTokens 用在常见 AI 编程工具里。