AI SETUPAPI
Платформа
API-документация

Gemini

Публичное API для интеграции моделей генерации текста

Gemini 3.5 Flash

Скоростная AI-модель для агентов

POSThttps://api.aisetup.ru/v1/responses
Header:Authorization: Bearer YOUR_KEY

Параметры

ПараметрТипОписание
modelstringИдентификатор модели: gemini-3.5-flash
inputstring|arrayТекст запроса (строка) или массив сообщений (как в OpenAI Responses API). Для отправки изображений используйте массив с content-блоками типа input_text и input_image. URL изображения должен быть прямым и публично доступным.
instructions*stringСистемная инструкция (опционально)
temperature*numberТемпература генерации (0..2, опционально)
max_output_tokens*numberЛимит выходных токенов (опционально)
stream*booleanСтримить ответ через SSE (опционально)
* — опциональные поля.

Пример запроса

# Текстовый запрос
curl -s "https://api.aisetup.ru/v1/responses" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "input": "Составь 5 вариантов короткого оффера для лендинга"
  }'

# Запрос с изображением (URL)
curl -s "https://api.aisetup.ru/v1/responses" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "input": [
      {
        "role": "user",
        "content": [
          { "type": "input_text", "text": "Что изображено на картинке?" },
          { "type": "input_image", "image_url": "https://example.com/photo.jpg" }
        ]
      }
    ]
  }'

Ответы API

Структура ответа

ПолеТипОписание
idstringID ответа
objectstringТип объекта. Всегда "response"
modelstringИспользованная модель (совпадает с переданным полем model)
output_textstringАгрегированный текст ответа
outputarrayМассив выходных блоков (output items)
↳ typestringТип блока (всегда "message")
↳ rolestringРоль отправителя (всегда "assistant")
↳ contentarrayМассив с содержимым сообщения
↳ typestringТип контента внутри блока (всегда "output_text")
↳ textstringТекст ответа от модели
usageobjectСтатистика токенов
↳ input_tokensnumberВходные токены
↳ output_tokensnumberВыходные токены
↳ total_tokensnumberВсего токенов (input + output)

Пример тела ответа (JSON)

{
  "id": "cmqr4ab12003f2clkxyz009ef",
  "object": "response",
  "model": "gemini-3.5-flash",
  "output_text": "На фото — азиатский слон, стоящий в воде среди растений.",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "На фото — азиатский слон, стоящий в воде среди растений."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 520,
    "output_tokens": 84,
    "total_tokens": 604
  }
}

Gemini 3.1 Pro

Умная модель для программирования и логики (Preview)

POSThttps://api.aisetup.ru/v1/responses
Header:Authorization: Bearer YOUR_KEY

Параметры

ПараметрТипОписание
modelstringИдентификатор модели: gemini-3-1-pro-preview
inputstring|arrayТекст запроса (строка) или массив сообщений (как в OpenAI Responses API). Для отправки изображений используйте массив с content-блоками типа input_text и input_image. URL изображения должен быть прямым и публично доступным.
instructions*stringСистемная инструкция (опционально)
temperature*numberТемпература генерации (0..2, опционально)
max_output_tokens*numberЛимит выходных токенов (опционально)
stream*booleanСтримить ответ через SSE (опционально)
* — опциональные поля.

Пример запроса

# Текстовый запрос
curl -s "https://api.aisetup.ru/v1/responses" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-1-pro-preview",
    "input": "Составь 5 вариантов короткого оффера для лендинга"
  }'

# Запрос с изображением (URL)
curl -s "https://api.aisetup.ru/v1/responses" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-1-pro-preview",
    "input": [
      {
        "role": "user",
        "content": [
          { "type": "input_text", "text": "Что изображено на картинке?" },
          { "type": "input_image", "image_url": "https://example.com/photo.jpg" }
        ]
      }
    ]
  }'

Ответы API

Структура ответа

ПолеТипОписание
idstringID ответа
objectstringТип объекта. Всегда "response"
modelstringИспользованная модель (совпадает с переданным полем model)
output_textstringАгрегированный текст ответа
outputarrayМассив выходных блоков (output items)
↳ typestringТип блока (всегда "message")
↳ rolestringРоль отправителя (всегда "assistant")
↳ contentarrayМассив с содержимым сообщения
↳ typestringТип контента внутри блока (всегда "output_text")
↳ textstringТекст ответа от модели
usageobjectСтатистика токенов
↳ input_tokensnumberВходные токены
↳ output_tokensnumberВыходные токены
↳ total_tokensnumberВсего токенов (input + output)

Пример тела ответа (JSON)

{
  "id": "cmqr4ab12003f2clkxyz009ef",
  "object": "response",
  "model": "gemini-3-1-pro-preview",
  "output_text": "На фото — азиатский слон, стоящий в воде среди растений.",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "На фото — азиатский слон, стоящий в воде среди растений."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 520,
    "output_tokens": 84,
    "total_tokens": 604
  }
}