> For the complete documentation index, see [llms.txt](https://docs.mashagpt.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mashagpt.ru/quickstart/working-with-api.md).

# Работа с API

{% hint style="success" %}
Базовый адрес API: `https://api.mashagpt.ru/v1`
{% endhint %}

## Введение

Работа с API MashaGPT возможна как обычными HTTP запросами в любом удобном для вас языке, так и используя опенсорсные библиотеки разработанные для работы с OpenAI API, полный список которых можно найти [тут](https://platform.openai.com/docs/libraries).

{% hint style="warning" %}
При работе с библиотеками стоит учитывать, что MashaGPT API расположен по адресу *<https://api.mashagpt.ru>*&#x20;

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

Установите [библиотеку](https://github.com/sashabaranov/go-openai) для Go:

```bash
go get github.com/sashabaranov/go-openai
```

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

```go
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 для аутентификации.  Ключ можно найти на [странице своего профиля](https://mashagpt.ru/settings?tab=api).

{% hint style="danger" %}
Помните, что ваш ключ API — это секрет!

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

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

Все запросы 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`) для ответа на команду: «Скажи мне что-нибудь про котиков». Вы должны получить ответ, похожий на следующий:

```json
{
    "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 для создания нескольких вариантов сообщений.
