Быстрый старт

Эта страница поможет выполнить первый API-запрос к DDTokens. DDTokens совместим с протоколом OpenAI Chat Completions, поэтому в большинстве проектов на OpenAI SDK достаточно заменить API-ключ и base_url.

Требования

Перед началом убедитесь, что у вас есть:

• Аккаунт DDTokens.
• Рабочий API-ключ. Если ключ еще не создан, сначала прочитайте Создание API-ключа.
• Терминал для выполнения команд.

Настройка переменных окружения

Задайте API-ключ и адрес API в терминале:

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

Не добавляйте API-ключ в репозиторий кода. В рабочей среде передавайте его через секреты CI/CD, переменные окружения или систему управления секретами.

Вызов API с помощью 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 позволяет сверить расход токенов.

Использование 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 SDK для Go:

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 с популярными инструментами программирования.