SDK и инструменты

Чат совместим с OpenAI SDK — меняются только base_url и ключ. Генерация изображений идёт по собственному REST, потому что это асинхронная задача.

OpenAI SDK

Любой клиент, умеющий говорить с OpenAI-совместимым эндпоинтом, работает с чатом Mintform: официальные SDK для Python и JavaScript, а также сторонние обёртки, где можно задать базовый URL.

Установка

pip install openai

Клиент

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MINTFORM_API_KEY"],
    base_url="https://mintform.app/v1",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "ping"}],
)
print(response.choices[0].message.content)

Что покрывает SDK

Возможность	Через OpenAI SDK	Комментарий
Чат /v1/chat/completions	да	Полная совместимость по формату запроса и ответа.
Стриминг	да	stream=True / stream: true, итерация по чанкам.
Vision (картинка на вход)	да	Части content с image_url — ссылка или data-URI.
Генерация изображений	нет	Свой асинхронный REST: POST /v1/images/generations + опрос job.
Список моделей	нет	Каталог моделей — на странице «Модели» и в этой документации.

Переменные окружения

Держи ключ в MINTFORM_API_KEY (или своём аналоге) и не смешивай с OPENAI_API_KEY, иначе SDK легко уйдёт не на тот базовый URL.

Postman-коллекция

Готовая коллекция с четырьмя запросами: чат, чат со стримингом, создание изображения и опрос задачи. Импортируй файл и заполни две переменные.

# Import the collection, then set two variables:
#   base_url = https://mintform.app
#   api_key  = mf_live_…
# Everything else (chat, streaming, image job, job polling) is pre-wired.

Скачать коллекцию: /mintform.postman_collection.json