LogoAPI in One
Dashboard

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

Всё, что нужно для интеграции API in One в ваше приложение.

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

Все запросы API требуют Bearer-токен в заголовке Authorization. Управлять API-ключами можно из панели управления.

http
Authorization: Bearer aio_your_api_key_here

Получите API-ключ: Создайте бесплатный API-ключ на странице API-ключей в панели управления. Новые аккаунты получают бонусные кредиты для изучения платформы.

Базовый URL

https://apiin.one/api/v1

Эндпоинты API

POST/api/v1/images/generations
POST/api/v1/videos/generations
POST/api/v1/audio/music
POST/api/v1/audio/speech
POST/api/v1/chat/completions
POST/api/v1/images/tools/remove-bg
GET/api/v1/tasks/{task_id}

Формат запроса

Все запросы используют JSON-тело с обязательным полем 'model' для указания AI-модели. Дополнительные параметры зависят от модели.

json
{
  "model": "flux-2",
  "prompt": "A beautiful landscape",
  "...other_params": "..."
}

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

Формат ответа

Асинхронные задачи (изображения, видео, музыка, речь)

Для моделей генерации контента API сразу возвращает ID задачи. Опрашивайте эндпоинт статуса, чтобы узнать о завершении задачи.

Initial response when task is created.

{
  "id": "task_abc123",
  "status": "pending",
  "model": "kling-3",
  "created_at": "2026-02-24T12:00:00Z"
}

Синхронные ответы (чат)

Чат-ответы возвращаются напрямую в одном запросе в формате, совместимом с OpenAI.

json
{
  "id": "chatcmpl_xyz",
  "model": "gemini",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "..."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 156,
    "total_tokens": 168
  },
  "credits_consumed": 2
}

Обработка ошибок

Все ошибки возвращаются в единообразном JSON-формате с кодом ошибки, сообщением и типом.

json
{
  "error": {
    "code": 401,
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}
Status CodeТипОбязательноОписание
400invalid_requestНеобязательноНекорректные параметры запроса. Проверьте документацию модели на предмет обязательных полей.
401authentication_errorНеобязательноAPI-ключ отсутствует, недействителен или отозван.
402insufficient_creditsНеобязательноНедостаточно кредитов на аккаунте. Приобретите дополнительные кредиты для продолжения.
404not_foundНеобязательноЗапрошенный ресурс (задача, модель) не найден.
429rate_limitНеобязательноПревышен лимит запросов. По умолчанию — 60 запросов в минуту.
500server_errorНеобязательноВнутренняя ошибка сервера. Повторите попытку через некоторое время.

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

1. Получите API-ключ

Зарегистрируйтесь и создайте API-ключ в панели управления. Бесплатные аккаунты включают бонусные кредиты.

2. Отправьте первый запрос

bash
curl -X POST https://apiin.one/api/v1/images/generations \
  -H "Authorization: Bearer aio_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2",
    "prompt": "A serene Japanese garden with cherry blossoms"
  }'

3. Проверьте статус задачи (асинхронные модели)

bash
curl https://apiin.one/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer aio_your_key"

4. Исследуйте другие модели

Просмотрите каталог моделей, чтобы найти идеальную AI-модель для вашего проекта.

Просмотреть все модели →

API Tester

Test the API directly from your browser:

Песочница APIPOST