Справочник параметров

Примеры параметров для текстовых моделей и генерации изображений

Примеры параметров API на основе GPT-5 (текстовые модели) и Gemini 2.5 Flash Image (генерация изображений).

Параметры могут отличаться для разных моделей. Для полной информации о поддержке параметров конкретной моделью обратитесь к официальной документации или проверьте список доступных моделей.

Доступные модели

Полный список моделей с описанием поддерживаемых параметров

OpenAI API Reference

Официальная документация параметров OpenAI моделей

Anthropic API Reference

Официальная документация параметров Claude моделей

Основные параметры

`model`

Тип: string (обязательный)

{
  "model": "gpt-5"
}

`messages`

Тип: array (обязательный, если нет prompt)

Массив сообщений в формате диалога.

{
  "messages": [
    {"role": "user", "content": "Привет!"}
  ]
}

`prompt`

Тип: string (опционально)

Простой текстовый промпт. Не используйте если есть messages.

{
  "prompt": "Напиши стих про кота"
}

`system_prompt`

Тип: string (опционально)

Системный промпт для настройки поведения ассистента.

{
  "system_prompt": "Ты — полезный помощник"
}

Если используете messages, system_prompt игнорируется. Добавьте системное сообщение в массив messages.

Параметры генерации

`temperature`

Тип: number
Диапазон: 0.0 - 2.0
По умолчанию: 1.0

{
  "temperature": 0.7
}

`max_completion_tokens`

Тип: integer

Максимальное количество токенов в ответе (включая reasoning для GPT-5).

{
  "max_completion_tokens": 5000
}

`top_p`

Тип: number
Диапазон: 0.0 - 1.0

{
  "top_p": 0.9
}

`frequency_penalty`

Тип: number
Диапазон: -2.0 - 2.0

{
  "frequency_penalty": 0.5
}

`presence_penalty`

Тип: number
Диапазон: -2.0 - 2.0

{
  "presence_penalty": 0.6
}

Reasoning параметры (GPT-5)

`reasoning_effort`

Тип: string
Значения: "minimal", "low", "medium", "high"
По умолчанию: "minimal"

Управляет глубиной анализа модели.

{
  "reasoning_effort": "high"
}

При reasoning_effort: "high" увеличьте max_completion_tokens, чтобы избежать пустых ответов.

`verbosity`

Тип: string
Значения: "low", "medium", "high"
По умолчанию: "medium"

Управляет детализацией ответа.

{
  "verbosity": "low"
}

Форматы вывода

`response_format`

Тип: object

Формат ответа модели.

{
  "response_format": { "type": "json_object" }
}

`stream`

Тип: boolean
По умолчанию: false

{
  "stream": true
}

Мультимодальность

`image_input`

Тип: array

Список URL изображений для отправки модели (vision модели).

{
  "image_input": ["https://example.com/image.jpg"]
}

Дополнительно

`stop`

Тип: string или array

{
  "stop": ["\n", "END"]
}

`n`

Тип: integer

Количество вариантов ответа.

{
  "n": 3
}

`seed`

Тип: integer

{
  "seed": 42
}

`user`

Тип: string

Идентификатор пользователя для логирования.

{
  "user": "user-123"
}

Параметры для Gemini 2.5 Flash Image

`prompt`

Тип: string (обязательный)

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

{
  "prompt": "Красивый закат над океаном, фотореалистично, 4K"
}

`image_input`

Тип: array
По умолчанию: []

Входные изображения для трансформации или использования как референс. Поддерживает несколько изображений.

{
  "prompt": "Превратить в стиль аниме",
  "image_input": ["https://example.com/photo.jpg"]
}

`aspect_ratio`

Тип: string
По умолчанию: "match_input_image"

Соотношение сторон генерируемого изображения.

Доступные значения:

match_input_image — по размеру входного изображения
1:1 — квадрат
16:9, 9:16 — широкоформатное (горизонтальное/вертикальное)
4:3, 3:4 — стандартное
3:2, 2:3 — фото
4:5, 5:4 — портрет/альбом
21:9 — ультраширокое

{
  "aspect_ratio": "16:9"
}

`output_format`

Тип: string
Значения: "jpg", "png"
По умолчанию: "jpg"

Формат выходного файла.

{
  "output_format": "png"
}

Пример полного запроса

{
  "model": "gemini-2.5-flash-image",
  "prompt": "Футуристический город ночью, неоновые огни, киберпанк",
  "image_input": ["https://example.com/reference.jpg"],
  "aspect_ratio": "16:9",
  "output_format": "png"
}

Другие модели генерации изображений могут иметь свои специфичные параметры. Проверяйте документацию на странице Доступные модели.

Доступные модели

OpenAI API Reference

Anthropic API Reference

Содержание