Документация

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

1. 1. Зарегистрируйтесь
2. 2. Пополните баланс и создайте API-ключ в кабинете.
3. 3. Подставьте ключ в сниппет ниже и выполните запрос.

curl https://apimira.com/v1/chat/completions \
  -H "Authorization: Bearer ya-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4-mini",
    "messages": [
      {
        "role": "user",
        "content": "Привет!"
      }
    ]
  }'

base_url — это адрес выше с суффиксом /v1. Модель задаётся параметром model.

Model ID берётся из каталога целиком, вместе с префиксом до «/»: например openai/gpt-5.4-mini или anthropic/claude-sonnet-4.6.

Подключение программ

Любая программа с OpenAI-совместимым API подключается тремя значениями:

Если поле называется просто «Base URL» — путь /chat/completions программа добавит сама, дописывать его не нужно. И следите, чтобы в адресе не получилось /v1/v1.

Быстрая проверка ключа без программы — выполните запрос из блока «Быстрый старт» выше.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "yourapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "yourapi",
      "options": {
        "baseURL": "https://apimira.com/v1",
        "apiKey": "ya-ВАШ_КЛЮЧ"
      },
      "models": {
        "openai/gpt-5.4-mini": { "name": "GPT-5.4 Mini" },
        "anthropic/claude-sonnet-4.6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}

Чат — генерация ответа

POST /v1/chat/completions

Генерация ответа модели. Поддерживает stream=true (SSE). Формат запроса и ответа — как у OpenAI.

Стриминг: передайте "stream": true. Чанки приходят в формате data: {...} и завершаются data: [DONE].

Поддерживаются: текстовый chat, генерация изображений и озвучка (TTS). В chat параметры tools, response_format и vision пока вернут 400.

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

POST /v1/images/generations

POST /v1/images/generations — синхронно, тело и ответ совместимы с OpenAI Images. Списывается фиксированная цена за изображение, умноженная на количество (n).

curl https://apimira.com/v1/images/generations \
  -H "Authorization: Bearer ya-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image/gpt-image-2",
    "prompt": "a red cat wearing glasses",
    "n": 1
  }'

Модель должна быть типа «изображение» (см. GET /v1/models). Ответ — массив data с полем b64_json (base64 картинки) или url.

Озвучка (TTS)

POST /v1/audio/speech

POST /v1/audio/speech — синхронно превращает текст в речь. Ответ — бинарные аудио-байты (по умолчанию mp3). Списывается фиксированная цена за запрос.

curl https://apimira.com/v1/audio/speech \
  -H "Authorization: Bearer ya-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "audio/elevenlabs-tts",
    "input": "Привет! Это синтез речи.",
    "voice": "alloy"
  }' \
  --output speech.mp3

Модель должна быть типа «аудио» (см. GET /v1/models). Параметры: input (текст), voice (голос), response_format (формат файла).

Эндпоинты

Коды ошибок

Частые вопросы