Работа с API

Базовый адрес API: https://api.mashagpt.ru/v1

Введение

Работа с API MashaGPT возможна как обычными HTTP запросами в любом удобном для вас языке, так и используя опенсорсные библиотеки разработанные для работы с OpenAI API, полный список которых можно найти тут.

При работе с библиотеками стоит учитывать, что MashaGPT API расположен по адресу https://api.mashagpt.ru

Проверьте возможность настройки базового url в библиотеке которую вы собираетесь использовать.

Установите библиотеку для Go:

go get github.com/sashabaranov/go-openai

Пример использования GPT-3.5

package main

import (
	"context"
	"fmt"
	openai "github.com/sashabaranov/go-openai"
)

func main() {
	config := openai.DefaultConfig("your token")
	config.BaseURL = "https://api.mashagpt.ru/v1"
	client := openai.NewClientWithConfig(config)

	resp, err := client.CreateChatCompletion(
		context.Background(),
		openai.ChatCompletionRequest{
			Model: openai.GPT3Dot5Turbo,
			Messages: []openai.ChatCompletionMessage{
				{
					Role:    openai.ChatMessageRoleUser,
					Content: "Hello!",
				},
			},
		},
	)

	if err != nil {
		fmt.Printf("ChatCompletion error: %v\n", err)
		return
	}

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

Авторизация

API MashaGPT использует ключи API для аутентификации. Ключ можно найти на странице своего профиля.

Помните, что ваш ключ API — это секрет!

Не делитесь им с другими и не раскрывайте его в каком-либо клиентском коде (браузерах, приложениях).

Запросы должны направляться через ваш собственный сервер, где ваш ключ может безопасно храниться и использоваться (например используя переменную среды или хранилище секретов)

Все запросы API должны включать ваш ключ API в HTTP-заголовоке авторизации следующим образом:

Authorization: Bearer MASHAGPT_API_KEY

Отправка запросов

Вы можете вставить приведенную ниже команду в свой терминал, чтобы сделать первый запрос API. Обязательно замените $MASHAGPT_API_KEY своим секретным ключом API.

curl https://api.mashagpt.ru/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MASHAGPT_API_KEY" \
  -d '{
     "model": "gpt-3.5-turbo",
     "messages": [{"role": "user", "content": "Скажи мне что-нибудь про котиков"}],
     "temperature": 0.7
   }'

Этот запрос использует модель gpt-3.5-turbo (которая под капотом указывает на последний вариант модели gpt-3.5-turbo) для ответа на команду: «Скажи мне что-нибудь про котиков». Вы должны получить ответ, похожий на следующий:

{
    "id": "chatcmpl-8Bk7lqRP4g6oWtUkPs8EOuRmYnwJG",
    "object": "chat.completion",
    "created": 1697809601,
    "model": "gpt-3.5-turbo-0613",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "Котики - это обожаемые многими домашние животные, которые славятся своей независимостью и грациозностью. Они являются одними из самых популярных домашних животных во всем мире. Котики могут быть разных пород, размеров и окрасов. Они обладают отличным слухом, зрением и рефлексами, что делает их отличными охотниками. Котики очень чистоплотны и тратят много времени на уход за своей шерстью. Они также известны своей способностью принимать разные позы, такие как \"колесом\" или \"ребенком\", что делает их очень милыми и удивительными созданиями. Котики могут быть отличными компаньонами, они могут быть ласковыми, игривыми и преданными своим хозяевам. Все эти качества делают котиков одними из самых прекрасных и популярных животных в мире."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 24,
        "completion_tokens": 338,
        "total_tokens": 362,
        "prompt_energy": 24,
        "completion_energy": 338,
        "total_energy": 362
    }
}

Теперь, когда вы выполнили первый запрос, давайте разберем объект ответа. Мы видим, что finish_reason - "stop", что означает, что API вернул полный ответ, сгенерированный моделью, без каких-либо ограничений. В списке вариантов мы сгенерировали только одно сообщение, но вы можете установить параметр n для создания нескольких вариантов сообщений.