Gemini 4 Argon · API

Быстрый старт

Два шага: отправить запрос, а затем получить ответ в потоковом режиме. Замените YOUR_API_KEY своим ключом, и команды ниже заработают как есть. Эндпоинт совместим с OpenAI Chat Completions, поэтому в готовом коде для OpenAI достаточно поменять base_url и model.

Шаг 1 · Отправка запроса

curl https://nezhagate.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-4-argon", "messages": [{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}]}'

Ответ (HTTP 200)

{
  "id": "chatcmpl-7f3c9a1e2b4d6f8a",
  "object": "chat.completion",
  "created": 1791281400,
  "model": "gemini-4-argon",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Фотосинтез — это процесс, в котором растения с помощью солнечного света превращают углекислый газ и воду в сахар и выделяют кислород.",
        "reasoning_content": "..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 186,
    "total_tokens": 204,
    "prompt_tokens_details": {"cached_tokens": 0},
    "completion_tokens_details": {"reasoning_tokens": 144}
  }
}

message.content — это ответ, message.reasoning_content — размышления. В usage — токены, по которым оплачивается этот запрос: токены размышлений входят в completion_tokens и оплачиваются по цене выхода.

Шаг 2 · Потоковый вывод (рекомендуется)

curl -N https://nezhagate.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-4-argon", "stream": true, "messages": [{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}]}'

Поток — это стандартный SSE: каждый фрагмент несёт текст в choices[0].delta.content, последний фрагмент содержит usage, а завершается поток строкой data: [DONE]. Для длинных ответов и моделей с размышлениями используйте потоковый вывод: непотоковый запрос обрывается примерно через 10 минут.

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(base_url="https://nezhagate.com/v1", api_key="YOUR_API_KEY")

# 1. Один запрос — один ответ
resp = client.chat.completions.create(
    model="gemini-4-argon",
    messages=[{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}],
)
print(resp.choices[0].message.content)

# 2. Потоковый вывод
stream = client.chat.completions.create(
    model="gemini-4-argon",
    messages=[{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Аутентификация

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Чтобы начать, создайте API-ключ в консоли.

Основные характеристики

Параметры запроса

JSON-тело запроса POST /v1/chat/completions — такое же, как в OpenAI Chat Completions. Основные параметры и то, как каждый из них работает у этой модели:

Начните с параметров на этой странице. Вызов инструментов, мультимодальный ввод и режим JSON пока не обещаются.

Цена

Оплата за токены по актуальным ценам ниже (за миллион токенов). Оплачиваются только успешные запросы и только по фактическому расходу: неудачные, прерванные по таймауту и отклонённые запросы бесплатны. 1 кредит = $0.005.

Например, запрос с 2000 входных токенов и 1000 выходных (включая размышления) стоит около $0.004.

Размышления

Задайте reasoning_effort как low, medium или high; если параметр опущен, используется low.

Видимое рассуждение возвращается в reasoning_content. usage.completion_tokens включает рассуждение и ответ; не прибавляйте токены рассуждения повторно.

Тарифы одинаковы на всех уровнях. Более глубокое рассуждение может увеличить число выходных токенов.

Токены размышлений входят в usage.completion_tokens и оплачиваются по цене выхода (некоторые модели ещё и указывают их отдельно в completion_tokens_details.reasoning_tokens).

{
  "model": "gemini-4-argon",
  "messages": [{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}],
  "reasoning_effort": "medium"
}

Кэширование промптов

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

usage.prompt_tokens — весь ввод. usage.prompt_tokens_details.cached_tokens — кэшированная часть этого ввода. Тариф кэша применяется только к фактическим попаданиям.

Веб-поиск

Необязательный web_search шлюза передаёт модели найденный текст. Это не означает проверенной нативной поддержки поиска или инструментов.

curl https://nezhagate.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-4-argon", "web_search": true, "messages": [{"role": "user", "content": "Какие главные технологические новости сегодня"}]}'

Ограничения Beta

• Проверены текстовый диалог, потоковый вывод и три уровня рассуждения. Инструменты, мультимодальный ввод и режим JSON ещё не проверены.
• Официальный контекст — около миллиона токенов, общих для ввода и вывода. Поиск в длинном вводе проверен; полное окно и вывод на миллион токенов не проверялись.
• Делите длинные задачи. max_tokens не является проверенным строгим пределом бюджета. Неудачные запросы не оплачиваются; прерванный запрос с выводом рассчитывается по фактическому расходу.

Ошибки и возвраты

Ошибки возвращаются объектом error (message, type, code, param); ориентируйтесь на HTTP-статус и code, а не на текст message. Неудачные запросы не оплачиваются; полный список — в разделе Коды ошибок.

Если поток дал сбой уже после начала передачи, код статуса не меняется: ошибка приходит строкой данных с error, или поток просто заканчивается (без data: [DONE]). Считайте такой поток оборванным.