Skip to main content
API docs by Redocly

SmartBuddy API (1.0.0)

Документация, примеры, вопросы и ответы

Личный кабинет, настройки, баланс

Ограничение до 2-х запросов в секунду, для увеличения - напишите нам.

Host API: https://api.smartbuddy.ru

Модели генерации текста (function calling, vision): anthropic/claude-3-haiku, anthropic/claude-3-opus, anthropic/claude-3-sonnet, anthropic/claude-3.5-sonnet, deepseek/deepseek-chat, deepseek/deepseek-coder, google/gemini-flash-1.5, google/gemini-pro, google/gemini-pro-1.5, meta-llama/llama-3-70b-instruct, meta-llama/llama-3.1-405b-instruct, meta-llama/llama-3.1-70b-instruct, meta-llama/llama-3.1-8b-instruct, microsoft/wizardlm-2-8x22b, openai/gpt-3.5-turbo-0125, openai/gpt-4-turbo, openai/gpt-4o, openai/gpt-4o-mini, openai/o1-mini, openai/o1-preview, perplexity/llama-3-sonar-large-32k-online, perplexity/llama-3.1-sonar-large-128k-online, qwen/qwen-110b-chat, qwen/qwen-2-vl-72b-instruct, qwen/qwen-2.5-72b-instruct, sber/gigachat, sber/gigachat-pro

Модели генерации изображений: stable-diffusion, dall-e-3, playground, flux-1-schnell, flux-1-dev, flux-1-pro

По всем вопросам и предложениям пишите на support@mail.smartbuddy.ru. Поможем.

ChatCompletions

Запрос к нейросети (текст, vision, functions, structured outputs)

header Parameters
Authorization
string
Example: Bearer API_TOKEN

API-ключ для авторизации запросов (сгенерировать API-ключ)

Request Body schema: application/json
required
max_tokens
number >= 0
Default: 4096

Максимальное количество токенов, которое нейросеть может использовать для ответа

required
Array of objects non-empty

Массив сообщений

Array (non-empty)
required
string or Array of objects

Текст сообщения

role
required
string
Enum: "assistant" "system" "user"

Роль

model
required
string (ModelEnum)
Enum: "anthropic/claude-3-haiku" "anthropic/claude-3-opus" "anthropic/claude-3-sonnet" … 26 more

Список моделей

stream
boolean
Default: false

Потоковый вывод

temperature
number [ 0 .. 2 ]
Default: 0.7

Температура

Responses

Response Schema: application/json
required
Array of objects non-empty

Ответы

Array (non-empty)
finish_reason
required
string

Причина, по которой нейросеть завершила генерацию текста, некоторые ИИ имеют свои причины, уточняйте в их документации

message
required
string

Сообщение

model
required
string

Модель

required
object

Количество использованных токенов

completion_tokens
required
integer

Количество токенов на выходе нейросети (ответ)

prompt_tokens
required
integer

Количество токенов на вход нейросети (запрос)

total_tokens
required
integer

Общее количество токенов, использованного нейросетью

Request samples

Content type
application/json
{
  • "model": "anthropic/claude-3-haiku",
  • "temperature": 0.7,
  • "max_tokens": 4096,
  • "stream": false,
  • "messages": [
    • {
      }
    ]
}

Response samples

Content type
application/json
{
  • "choices": [
    • {
      }
    ],
  • "model": "GigaChat:3.1.25.3",
  • "usage": {
    • "prompt_tokens": "30",
    • "completion_tokens": "171",
    • "total_tokens": "201"
    }
}

ImagesGenerations

Генерация изображения.

Параметры по умолчанию (ограничение от провайдера):

  • n=1 (отправляйте в цикле)
  • response_format=b64_json
header Parameters
Authorization
string
Example: Bearer API_TOKEN

API-ключ для авторизации запросов (сгенерировать API-ключ)

Request Body schema: application/json
required
model
required
string (ImageModel)
Enum: "dall-e-3" "flux-1-dev" "flux-1-pro" … 3 more

Список моделей генерации изображений

prompt
required
string

Текстовое описание изображения

ImageSizeStableDiffusionEnum (string) or ImageSizeDalle3Enum (string) or ImageSizePlaygroundEnum (string) or ImageSizeFluxEnum (string)
Default: "1024x1024"

Разрешение изображения

One of
string (ImageSizeStableDiffusionEnum)
Default: "1024x1024"
Enum: "1024x1024" "1152x896" "1216x832" … 6 more

Размер изображения для модели Stable Diffusion

Responses

Response Schema: application/json
created
required
integer

Время создания

required
Array of objects non-empty

Сгенерированные изображения

Array (non-empty)
b64_json
required
string

The base64-encoded JSON of the generated image

Request samples

Content type
application/json
{
  • "model": "dall-e-3",
  • "prompt": "string",
  • "size": "1024x1024"
}

Response samples

Content type
application/json
{
  • "created": "1708501063",
  • "data": [
    • {
      }
    ]
}

Баланс

Получить текущий баланс в рублях

header Parameters
Authorization
string
Example: Bearer API_TOKEN

API-ключ для авторизации запросов (сгенерировать API-ключ)

Responses

Response Schema: application/json
balance
required
number <float>

Текущий баланс в рублях

Request samples 

curl --location --request GET 'https://api.smartbuddy.ru/v1/balance' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer API_TOKEN'

Response samples

Content type
application/json
{
  • "balance": "302.49"
}