Yandex Cloud
Поиск
Связаться с намиПопробовать бесплатно
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
  • Marketplace
    • Доступны в регионе
    • Инфраструктура и сеть
    • Платформа данных
    • Искусственный интеллект
    • Безопасность
    • Инструменты DevOps
    • Бессерверные вычисления
    • Управление ресурсами
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Партнёрская программа
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Калькулятор цен
    • Тарифы
    • Акции и free tier
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»
Yandex AI Studio
  • О сервисе Yandex AI Studio
  • Начало работы с Model Gallery
  • Yandex Workflows
  • Переход с AI Assistant API на Responses API
  • Совместимость с OpenAI
    • Обзор
    • Аутентификация в API
        • Overview
        • listFiles
        • createFile
        • deleteFile
        • retrieveFile
        • downloadFile
  • Квоты и лимиты
  • Правила тарификации
  • Управление доступом
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  • Термины и определения

В этой статье:

  • HTTP request
  • Path parameters
  • Response
  1. Справочники API
  2. OpenAI-совместимые API (англ.)
  3. Files
  4. retrieveFile

REST: Retrieve file

Статья создана
Yandex Cloud
Обновлена 24 декабря 2025 г.
  • HTTP request
  • Path parameters
  • Response

Returns information about a specific file.

HTTP requestHTTP request

GET https://ai.api.cloud.yandex.net/v1/files/{file_id}

Path parametersPath parameters

Field

Description

file_id

string

Required field. The ID of the file to use for this request.

ResponseResponse

HTTP Code: 200

OK

Response schema: application/json

{
  "id": "string",
  "bytes": "integer",
  "created_at": "integer",
  "expires_at": "integer",
  "filename": "string",
  "object": "string",
  "purpose": "string",
  "status": "string",
  "status_details": "string"
}

The File object represents a document that has been uploaded to Yandex Cloud AI Studio.

Field

Description

id

string

Required field. The file identifier, which can be referenced in the API endpoints.

bytes

integer

Required field. The size of the file, in bytes.

created_at

integer

Required field. The Unix timestamp (in seconds) for when the file was created.

expires_at

integer

The Unix timestamp (in seconds) for when the file will expire.

filename

string

Required field. The name of the file.

object

enum

Required field. The object type, which is always file.

  • file

purpose

enum

Required field. The intended purpose of the file. Supported values are assistants, assistants_output, batch, batch_output, fine-tune, fine-tune-results, vision, and user_data.

  • assistants
  • assistants_output
  • batch
  • batch_output
  • fine-tune
  • fine-tune-results
  • vision
  • user_data

status

enum

Required field. Deprecated. The current status of the file, which can be either uploaded, processed, or error.

  • uploaded
  • processed
  • error

status_details

string

Deprecated. For details on why a fine-tuning training file failed validation, see the error field on fine_tuning.job.

Была ли статья полезна?

Предыдущая
deleteFile
Следующая
downloadFile
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»