> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Поддерживает ли APIYI API файлов?

> APIYI не предоставляет API файлов, а также API пакетной обработки, ассистентов и аналогичные API, которые от него зависят. При вызове /v1/files возвращается сообщение «В текущей группе … нет доступных каналов для модели». Передавайте изображения, PDF-файлы и другие файлы непосредственно в запросе в формате base64 или в виде URL.

## Краткий ответ

**Нет.** APIYI не предоставляет API файлов, то есть сценарий, при котором вы сначала загружаете файл, получаете `file_id`, а затем указываете его в запросе. API, работающие с загрузкой файлов, также недоступны:

| API | Путь | Результат |
| - | - | - |
| API файлов OpenAI | `/v1/files` | 503, «нет доступных каналов» для текущей группы |
| API Assistants OpenAI | `/v1/assistants`, `/v1/threads` | 503, как и выше |
| API Batch OpenAI | `/v1/batches` | 404 `Invalid URL` |
| Vector Stores и Uploads OpenAI | `/v1/vector_stores`, `/v1/uploads` | 404 `Invalid URL` |
| Пакетная обработка сообщений Claude | `/v1/messages/batches` | 404 `Invalid URL` |
| API файлов Gemini | `client.files.upload()`, `/v1beta/files` | Недоступно |

**Что делать вместо этого**: добавляйте изображения, PDF-файлы и другие файлы **непосредственно в запрос чата** в виде base64 или URL. Модели всех провайдеров поддерживают такой встроенный формат; см. ниже.

## Что означает эта ошибка

Вызов `/v1/files` возвращает:

```json theme={null}
{
  "error": {
    "message": "Current group default has no available channels for model  under billing mode [pay-as-you-go, pay-per-request] (request id: …)",
    "type": "shell_api_error"
  }
}
```

Обратите внимание: после `for model` ничего нет. Платформа направляет каждый запрос в канал по имени модели. В запросе на загрузку файла имя модели не указывается, поэтому платформа не находит подходящий канал и возвращает эту ошибку. На самом деле это означает, что **платформа не предоставляет этот API**. Это никак не связано с вашей группой, балансом или разрешениями token, и переключение групп или повторная попытка не помогут.

Если в запросе чата указать `file_id`, ошибка зависит от эндпоинта, например:

| Использование | Ошибка |
| - | - |
| `file.file_id` в `/v1/chat/completions` | `Files [file-xxx] were not found` |
| `input_file.file_id` в `/v1/responses` | `Invalid 'input[0].content[0].file_id'` |

> [!NOTE]
>
> Если вы используете официальный SDK OpenAI, Anthropic или Google и указываете в `base_url` APIYI, такие методы, как `client.files.create()`, `client.files.upload()` и `client.batches.create()`, завершатся ошибкой. Переключитесь на приведённый ниже встроенный формат.

## Альтернатива: добавьте файл непосредственно в запрос

**формат OpenAI**

**Изображения**: передайте общедоступный URL или `data:image/png;base64,...` в `image_url`.

**PDF**: в `/v1/responses` используйте `file_data` для `input_file`; в `/v1/chat/completions` используйте `file_data` для типа `file`.

```json theme={null}
{
  "model": "gpt-5.4-mini",
  "input": [{
    "role": "user",
    "content": [
      {
        "type": "input_file",
        "filename": "report.pdf",
        "file_data": "data:application/pdf;base64,JVBERi0xLjQK..."
      },
      { "type": "input_text", "text": "Summarize this file" }
    ]
  }]
}
```

**формат Claude**

**Изображения**: блок `image`, в котором `source.type` задано значение `base64` или `url`.

**PDF**: блок `document`, в котором `source.type` задано значение `base64`. `source.type = "file"` зависит от Files API и недоступен.

```json theme={null}
{
  "model": "claude-haiku-4-5-20251001",
  "max_tokens": 1024,
  "messages": [{
    "role": "user",
    "content": [
      {
        "type": "document",
        "source": {
          "type": "base64",
          "media_type": "application/pdf",
          "data": "JVBERi0xLjQK..."
        }
      },
      { "type": "text", "text": "Summarize this file" }
    ]
  }]
}
```

**формат Gemini**

**Изображения, PDF, аудио и видео**: передайте base64 в `inline_data`; размер файла не должен превышать 20 МБ. Изображения также можно передать в виде общедоступного URL в `file_data.file_uri`.

```json theme={null}
{
  "contents": [{
    "role": "user",
    "parts": [
      {
        "inline_data": {
          "mime_type": "application/pdf",
          "data": "JVBERi0xLjQK..."
        }
      },
      { "text": "Summarize this file" }
    ]
  }]
}
```

Информацию о больших видео см. в разделе [API для понимания видео](/ru/api-capabilities/video-understanding).

Все три формата были протестированы 2026-10-22: один и тот же PDF отправили через `/v1/responses`, `/v1/chat/completions`, Claude `/v1/messages` и Gemini `generateContent`, и каждый раз модель правильно считывала содержимое файла.

> [!TIP]
>
> Недостаток встроенного формата заключается в том, что файл передаётся с каждым запросом, поэтому размер тела запроса увеличивается. Если вы задаёте много вопросов об одном и том же файле, преобразуйте его в текст и добавьте этот текст в prompt либо используйте кэширование у соответствующего провайдера, чтобы снизить расходы на повторную передачу данных; см. раздел [Поддерживает ли APIYI тарификацию кэша?](/ru/faq/cache-billing).

## Что насчёт пакетной обработки?

Batch API отсутствует. Для пакетных задач отправляйте обычные запросы параллельно из своего клиента; ограничения на параллельные запросы см. в разделе [Каковы ограничения на параллельные запросы API?](/ru/faq/api-concurrency). За обычные запросы взимается плата по стандартным ценам, без скидки за асинхронную обработку, доступной в официальном Batch API.

## Связанные документы

> **[API понимания видео](/ru/api-capabilities/video-understanding)**
>
> Как каждая модель принимает видеоданные и какие есть ограничения на размер

> **[Как настроить базовый URL? Различия между /v1, корневым доменом и /v1beta](/ru/faq/base-url-config)**
>
> Как указать его для форматов OpenAI / Claude / Gemini

> **[Каковы лимиты параллельных запросов API?](/ru/faq/api-concurrency)**
>
> Отправляйте пакетные задания параллельно из своего клиента

> **[Как устранить ошибки API моделей?](/ru/faq/model-error-troubleshooting)**
>
> Определите тип ошибки шаг за шагом


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.