Files API Overview

ShuYou exposes an OpenAI-compatible Files API at /v1/files. Upload once, reuse the returned file_id across inference requests.

Workflow

Upload

Upload File with multipart/form-data.

Reference in inference

Pass file_id in Chat Completions or Responses API messages. See Multimodal guide.

Manage

List Files and Delete File when no longer needed.

Approach	Best for
Files API upload	Large files, reuse across multiple requests, Responses API `input_file`
URL in message body	Publicly accessible assets without storing on ShuYou
Base64 in message body	Small files, one-off requests

Use openai.files.create() with base_url="https://api.shuyou.ai/v1".